ForHosting KIT · 数学

円の面積計算

半径5の円の面積は78.539816です。円周率には丸めた3.14ではなく、3.141592653589793という完全な値を使います。床の塗装なら2桁、科学の計算なら12桁と、必要な桁数を選べます。ブラウザで無料で使えます。

無料
ブラウザで動作
登録不要
データは端末の外に出ません

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

計算例

入力した場合

半径: 5

結果

面積: 78.539816
Pi: 3.1415926536

π は倍精度の完全な値で計算され、ご指定の小数点以下桁数へ切り上げ丸めされます。正の有限な半径を送信すれば、面積、送信した半径、使用した π の値、適用した公式が返ってきます。まったく同じ決定的なコードがこのページ上のブラウザで無料で動作しますので、お支払いが必要になるのは自動化するときだけです。

1つの正確な公式が役立つ場面

価値が現れるのは、呼び出しがループやパイプラインの中に置かれたときです。何千もの円形部品の材料見積もり、データインポート時の半径列から面積列への変換、供給業者が主張する面積と報告された半径との整合性チェック、模範解答を信頼できる出所から供給しなければならない学習ツールなどです。

こうした場面で重要なのは地味な性質——決定的な出力、厳格なバリデーション契約、固定された π、予測可能な価格——です。同じコードがこのページの無料計算機を動かしているので、ブラウザに表示される数値はスクリプトが受け取る数値と同一です。まず手でお試しいただき、その後安心して自動化してください。

活用例

円形部品の材料を見積もる

CAD エクスポートの半径リストを表面積に変換し、板金・布・コーティングをロット単位で価格算出します。

供給業者の仕様を検証する

供給業者が報告する面積が提示された半径と整合するかを確認し、注文前に単位の取り違えを検出します。

宿題ヘルパーのエンジンにする

A = π·r² の権威ある模範解答を、使用した正確な π と丸め方法とともに学生へ提示します。

よくある質問

どの公式が使われますか？

A = π·r² です。π は倍精度の完全な値（3.141592653589793）で、ご指定の桁数へ切り上げ丸めされます。

結果の桁数は指定できますか？

はい、面積の小数点以下の桁数を選べます。四捨五入で丸めるので、たとえば2.5は3になり、学校で習う丸め方と同じ結果になります。

半径の代わりに直径を入力できますか？

入力できるのは半径だけです。直径が分かっている場合は2で割って半径にしてから入力すると、同じ円の面積が求められます。

教科書の答えと少し違うのはなぜですか？

多くの教科書は円周率を3.14に丸めていますが、この計算機は3.141592653589793という完全な値を使うためです。結果は科学計算用のライブラリと同じになります。

半径に0や負の数を入れるとどうなりますか？

受け付けずにお知らせします。半径0の円には意味のある面積がなく、半径は長さなので負の数にはならないためです。正の数を入力してください。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/math/area-of-a-circle

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/math/area-of-a-circle \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"radius":5}'

const res = await fetch("https://api.kit.forhosting.com/math/area-of-a-circle", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "radius": 5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/math/area-of-a-circle",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "radius": 5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/math/area-of-a-circle", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"radius":5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"radius":5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/math/area-of-a-circle", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "radius": 5
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "math.area_of_a_circle",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

円の面積 API は、ひとつの数値——半径——を受け取り、古典的な公式 A = π·r² に基づいて面積を返します。スクリプト、スプレッドシートのエクスポート、ビルドパイプラインの中でこの結果だけが必要なとき、電卓を開かず、π を手で丸めず、同じバリデーションを十回も実装し直さずに済ませるための API です。正の有限数でないもの——ゼロ、負数、テキスト、欠落したフィールド——は、明確な invalid_input エラーで拒否され、課金されることはありません。

半径を入れれば、正確な面積が返ります

契約は意図的に小さく設計されています。使用する π は倍精度の完全な定数 3.141592653589793 であり、3.14 のように切り詰めた値ではないため、結果は科学計算ライブラリが返すものと同一です。半径は正の有限数でなければなりません。ゼロは「半径ゼロの円には報告に値する面積がない」ため、負数は「半径は長さである」ため、NaN や Infinity は「測定値ではない」ため、それぞれ拒否されます。半径を JSON の数値として渡すと、その半径が定義する円の面積が、π に半径の二乗を掛けた値として返されます。半径は面積、π の定数、公式の文字列とともにレスポンスに含めて返されるため、保存したり別システムへ転送したりする際に出力が自己説明的になります。どの拒否も、問題のあるフィールド名を示す invalid_input エラーとして返るため、呼び出し側のスクリプトは自由文を解析せずにエンドユーザーへ問題を伝えられます。このエラーはクライアントエラーなので課金されません。実際に面積を生成したリクエストにのみお支払いいただきます。

丸めが設定可能で決定的である理由

切り上げ丸めとは 2.5 が 3 になる方式で、一部のライブラリが黙って適用する銀行型丸めではなく、学校の算数で多くの人が期待する挙動と一致します。科学ワークフローでさらなる精度が必要なら 12 桁を指定してください。円形の床を塗る塗料の量を計算しているなら 2 桁を指定すれば、見積もりに使える数字が得られます。丸めがオーバーフローを隠すことはありません。浮動小数点演算は末尾のビットでホスト依存になることで知られており、マシン間で出力が変わる API はテストに使えない API です。このケイパビリティは、生の積を設定可能な小数点以下桁数——デフォルト 6 桁、リクエストにより 0 から 12 桁——へ切り上げ丸めすることで、その落とし穴を回避します。結果はプレーンな JSON 数値であり、CPU、ランタイム、エッジロケーション間でバイト単位で安定します。テストフィクスチャにレスポンスを保存したり、バッチジョブの二回の実行を比較したりするときに必要な性質そのものです。半径が大きすぎて面積が有限でなくなる場合、Infinity を返すのではなく invalid_input で失敗します。

単一公式 API が価値を発揮する場面

ひとつの数値を一度だけ自乗するのに API は要りません。このケイパビリティはグローバルエッジ上で動作し、レスポンス後に何も永続化しないため、送信された半径は計算にかかる数ミリ秒の間だけ存在します。API の利用は $0.002/リクエストで課金され、単位あたりの追加料金はなく、無効な入力は課金前に拒否されます。

技術的な質問

料金はいくらですか？

$0.002/リクエストです。このページのブラウザ上では無料でも実行できます。

どのような半径値が受け付けられますか？

正の有限数であれば何でも受け付けます。ゼロ、負数、テキスト、NaN、Infinity は invalid_input エラーで拒否され、課金されません。

結果の精度を制御できますか？

はい。オプションの decimals フィールドで小数点以下の桁数を 0 から 12 まで指定できます。デフォルトは 6 です。

半径の代わりに直径を渡せますか？

いいえ。呼び出す前に直径を 2 で割ってください。入力契約は半径のみで、これによりレスポンスの曖昧さを排除しています。

KITの完全なドキュメントを見る →