ForHosting KIT · 数学

円の計測

半径1つで3つの答えが出ます。半径5の円は直径10、円周31.415927、面積78.539816です。丸いテーブルの天板や芝生、円形パネルの見積もりに、公式を3つ使い分ける必要はありません。ブラウザで無料で使えます。

  • 無料
  • ブラウザで動作
  • 登録不要
  • データは端末の外に出ません
ご利用方法 ウェブAPIメールTelegramアプリ 近日
入力した場合
半径
5
結果
面積
78.539816
円周
31.415927
直径
10

1 回の呼び出しで 3 回分の公式の調べ直しを不要にし、各結果は指定した小数点以下の桁数に丸められます。

1 つの半径から 3 つの計測値へ

すべての円はその半径という 1 つの数値で完全に記述され、円の他の計測値はすべてその固定倍です。直径は単に半径を 2 倍にしたものです。円周、つまり円を一周する距離は、2 × π × 半径です。

面積、つまり円が囲む表面は、π × 半径の 2 乗です。3 つの値は同じ入力から同じ処理で得られるため、常に相互に整合します。直径は半径のちょうど 2 倍であり、円周と面積は公式の間で中間の丸めを挟まずに厳密にそこから導かれます。

また、オプションの decimals パラメータで、各結果を丸める小数点以下の桁数を 0 から 12 まで制御できます。

検証、丸め、そして決定性

半径は数値であり、有限であり、0 より大きくなければなりません。オプションの decimals パラメータにも同じ厳格さが適用され、0 から 12 の整数でなければなりません。丸めは、プラットフォーム既定の浮動小数点の表示形式ではなく、要求された桁数での四捨五入(0.5 切り上げ)を使います。

これは見た目以上に重要です。0.1 + 0.2 のような生の浮動小数点の結果は表示方法によって末尾の桁が変わり、安定化されていない出力は自動比較を不安定にします。決定的な切り上げ丸めにより、同じ半径はどのマシンでもいつでもバイト単位で同一の出力を生成するため、結果を安全に保存・比較・キャッシュできます。

実務でどこに適合するか

円は幾何学の宿題以外の多くの場面に現れます。円形のテーブル天板を切断する工房は、材料を見積もるために面積を、エッジテープを発注するために円周を必要とします。円形の芝生の見積もりを出す造園業者は、芝のために面積を、柵のために外周を必要とします。

配管や軸の寸法を決めるエンジニアは、半径・直径・断面積の間を絶えず換算します。丸い部品に価格を付ける見積もりツール、注文を受け付ける前に寸法を検証するコンフィギュレータ、半径が変わると 3 つの公式がどう連動して動くかを学生に示す教育アプリケーションなどです。

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

円形の天板・パネル・円盤の半径から面積を取得して材料を見積もり、同じ呼び出しで円周を使って縁取りやトリムの価格を算出します。

コンフィギュレータで寸法を検証する

注文を受け付ける前にユーザーが入力した半径を確認し、0・負・非数値を明確なエラーで拒否して、下流での壊れた計算を防ぎます。

円の 3 つの公式を教える

半径が変わるときに直径・円周・面積がどう連動して変化するかを学生に示します。結果はどのマシンでも同じように丸められます。

どのような入力が必要ですか?

円の半径を正の有限の数値として指定するだけです。オプションで decimals パラメータ(0〜12)で結果の丸め桁数を制御できます。

π にはどの値が使われますか?

実行環境が提供する倍精度の π の値(Math.PI)が使われるため、結果は標準的な科学・工学計算と一致します。

呼び出し後に何か保存されますか?

いいえ。 計算はメモリ上で行われ、3 つの計測値のみが返されます。

小数点以下の桁数は選べますか?

はい、0から12桁まで選べます。どの結果もその桁数で四捨五入されるので、同じ半径ならどの端末でもまったく同じ数値になります。

3つの結果が必ず一致するのはなぜですか?

3つとも同じ半径から一度に計算し、途中で丸めないからです。直径は半径のちょうど2倍で、円周と面積もそこから正確に導かれます。

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

POSThttps://api.kit.forhosting.com/math/circle-measurements

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

curl -X POST https://api.kit.forhosting.com/math/circle-measurements \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"radius":5}'
{
  "radius": 5
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "math.circle_measurements",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

1リクエストあたり$0.002

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

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

円の計測 API は、円の半径というたった 1 つの数値を受け取り、幾何学のあらゆる作業で最終的に必要になる 3 つの計測値、すなわち円が囲む面積、その周りの円周、そして円を横切る直径を返します。計算は倍精度数値の厳密な算術演算であるため、ブラウザで得られる答えは、自動化されたパイプラインが API から受け取る答えと同一です。

1 つの半径から 3 つの計測値へ

このエンドポイントは、送信された半径にこれら 3 つの公式を適用し、3 つの結果を 1 つのオブジェクトにまとめて返します。そのため、呼び出し側はどの公式が半径を 2 乗し、どの公式が 2 倍にするのかを覚えておく必要がありません。

検証、丸め、そして決定性

このエンドポイントは入力に対して意図的に厳格です。0 または負の半径は円を表さず、数値でない値は何も表さないため、どちらも invalid_input という明確なエラーで拒否され、どのルールに違反したかが正確に示されます。拒否されたリクエストに課金されることはありません。

実務でどこに適合するか

ソフトウェアでは、このエンドポイントはより大きなパイプラインの中の小さな決定的なステップとして非常に有効です。呼び出し後に何も保存せずエッジで実行され、同じコードはこのページのブラウザで無料で動作し、API は 1 リクエスト $0.002 です。そのため、手作業でプロトタイプを作成し、呼び出しを自動化したときにだけ料金が発生します。

料金はいくらですか?

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

正確には何が返されますか?

area、circumference、diameter の 3 つのフィールドを持つオブジェクトで、それぞれ要求された小数点以下の桁数に 0.5 切り上げで丸められます。

半径が 0、負、または数値でない場合はどうなりますか?

違反したルールを説明する invalid_input エラーでリクエストが拒否されます。拒否されたリクエストには課金されません。

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