ForHosting KIT · 数学

円周と面積の計算

Q: 代わりに直径や円周を渡せますか?

いいえ。 契約は意図的に半径のみです。呼び出す前に、直径は2で、円周は 2π で割ってください。

半径から円周と面積を一度に求めます。半径5なら円周は31.415927、面積は78.539816です。円形の牧草地の柵や種の量、車輪の設計など、丸いものを扱うときに役立ちます。ブラウザで無料で使えます。

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

無料で実行 API仕様を見る

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

計算例

入力した場合

半径: 5

結果

円周: 31.415927
面積: 78.539816
Pi: 3.1415926536

円の周りの距離である円周 2·π·r と、その円が囲む面積 π·r² です。両方の値は、設定可能な小数桁数に half-up で丸められ、使用した定数 π とともに返されるため、応答は決定的でバイト単位で比較できます。これは幾何学の古典的なペアを、2回の個別の参照ではなく1回の決定的な呼び出しで計算するもので、単位の曖昧さもありません。半径の単位で円周が得られ、面積はその単位の2乗で得られます。

2つの公式、1つの半径

円は1つの測定値だけで完全に記述されます。半径が分かれば、あとはすべて導かれます。円周――境界の長さ――は 2·π·r、面積――その境界に囲まれた表面――は π·r² です。

直径の入力も、単位変換も、隠れた状態もありません。同じ半径は常に同じ円周と同じ面積を生みます。これは、他のシステムがその上に構築するプリミティブに期待されるものそのものです。

直径しかない場合は先に2で割ってください。円周しかない場合は 2π で割ってください。

数値がどのように生成されるか

ここでの決定性は偶然ではなく、機能です。計算は倍精度の π の完全な値(3.141592653589793)を使い、2·π·r と π·r² を評価し、それから各結果を要求された小数桁数に half-up で丸めます。固定精度への half-up 丸めこそが、マシンやランタイム間で出力を安定させるものです。

丸めていない浮動小数点の積は CPU 間で最後のビットが異なることがありますが、小数6桁に丸められた値はどこでも同一です。バリデーションは意図的に厳格です。エラーコードが呼び出しに費用がかかるかどうかを決め、入力エラーは常に呼び出し側の責任です。

半径が大きすぎて面積が倍精度をオーバーフローする場合も、Infinity を黙って返すのではなく入力エラーとして報告されます。したがって、受け取る応答は常に実際に使える本物の数値です。

実務でこのペアが現れる場面

円周と面積のペアは、丸いものが設計・見積もり・製造されるあらゆる場面に現れます。柵の見積もりでは、円形の囲いの円周から針金のメートル数を合計し、面積から種子を推定します。ピザ箱の印刷業者は、底面の面積と、それを包む段ボールの帯を決める円周を必要とします。

車輪のエンジニアは、車両が1回転でどれだけ進むかを知るために半径を円周に換算し、荷重や圧力の計算のために面積に換算します。このケイパビリティは純粋関数なので、教育やテストのプリミティブとしても優れています。学生は宿題の答え合わせに使え、エンジニアはより大きなパイプラインの中で既知の答えを持つステップとして使えます。

呼び出し後に何も保持せず、当社のグローバルエッジで実行され、同じコードがこのページでブラウザから無料で実行できます。半径以外で定義される円や、他の図形については、カタログに補完的なケイパビリティがあります。これは意図的に単一目的のままです。

活用例

円形の囲いの柵を見積もる

円周から針金のメートル数を合計し、面積から芝の種子を推定します。どちらも測定した1つの半径から求められます。

丸い製品の包装を寸法決めする

円形の缶やピザの底面積と、それを包む帯の長さを、1回の決定的な呼び出しで取得します。

宿題やパイプラインのステップを検算する

既知の解を持ちバイト単位で安定した応答を使って、学生の課題や大きな計算の中の幾何学ステップを検証します。

よくある質問

どのような入力を受け付けますか?

ゼロ、負数、NaN、Infinity は無効な入力として拒否されます。

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

円周 = 2·π·r、面積 = π·r² です。π は 3.141592653589793 として使われます。両方の結果は要求された小数桁数に half-up で丸められます。

代わりに直径や円周を渡せますか?

いいえ。契約は意図的に半径のみです。呼び出す前に、直径は2で、円周は 2π で割ってください。

面積はどの単位で出ますか？

面積は半径の単位を2乗した単位で、円周は半径と同じ単位で出ます。半径をメートルで入れれば、円周はメートル、面積は平方メートルになります。

小数点以下は何桁まで表示できますか？

0桁から12桁まで選べ、初期設定は6桁です。円周と面積の両方が、選んだ桁数で四捨五入されます。

開発者向け — APIアクセス

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

エンドポイント

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

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

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

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

const res = await fetch("https://api.kit.forhosting.com/math/circumference-area-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/circumference-area-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/circumference-area-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/circumference-area-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.circumference_area_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 は、半径というたった1つの数値を受け取り、ほとんどの方が実際に必要とする2つの量を返します。このページではブラウザで無料で実行でき、API 経由で呼び出す場合は1リクエスト $0.002 です。

2つの公式、1つの半径

このエンドポイントは同じ半径に両方の公式を適用し、そのペアを1つの応答で返します。そのため、呼び出し側が一方の値を計算した後で、もう一方が異なる π の丸めや別の精度で求められたのではないかと疑うことはありません。リクエストは意図的に小さく設計されています。正の有限の数値でなければならない <code>radius</code> フィールドと、丸めを制御する 0〜12 のオプションの <code>decimals</code> フィールド(デフォルトは 6)だけです。これが契約のすべてです。必須フィールドを1つに絞った契約により、スプレッドシートのスクリプト、マイクロコントローラー、Web フォームなど、どんなクライアントでも特別な場合分けなしにこれを満たせます。

数値がどのように生成されるか

ゼロ、負数、NaN、Infinity は <code>invalid_input</code> エラーで拒否され、数値でない半径や範囲外の decimals も同様です。拒否されたリクエストが課金されることは決してありません。

実務でこのペアが現れる場面

手で値を確認し、呼び出しを自動化するときだけ――1リクエスト $0.002――お支払いいただけます。

技術的な質問

料金はいくらですか?

1リクエスト $0.002 です。このページではブラウザで無料で実行することもできます。同じコードが両方の結果を生成します。

リクエストは保存されますか?

いいえ。半径は処理後に破棄され、計算された値だけが返されます。

入力が拒否された場合も課金されますか?

決して課金されません。入力バリデーションのエラーには invalid_input コードが付き、呼び出しは課金対象になりません。

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

円周と面積の計算

無料で実行

計算例

2つの公式、1つの半径

数値がどのように生成されるか

実務でこのペアが現れる場面

活用例

円形の囲いの柵を見積もる

丸い製品の包装を寸法決めする

宿題やパイプラインのステップを検算する

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

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

リクエスト例

レスポンス例

料金

エラー

技術的な注記

2つの公式、1つの半径

数値がどのように生成されるか

実務でこのペアが現れる場面

技術的な質問

ありがとう