ForHosting KIT · 数学

円周から直径へ

Q: サービスは測定値を保存しますか？

いいえ。 入力はメモリ内で処理され破棄され、計算された結果のみが返されます。

丸いものに巻尺を回して測った長さを、その幅に換算します。円周31.41592653589793なら直径は10です。端から端まで測れないパイプや車輪、木の幹に便利です。ブラウザで無料で使えます。

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

無料で実行 API仕様を見る

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

計算例

入力した場合

円周: 31.4159265359

結果

直径: 10
Pi: 3.1415926536
小数点以下の桁数: 6

正の数をひとつ送信すると、指定した小数点以下の桁数に四捨五入（half-up）された直径に加え、使用された PI の値と入力値がトレーサビリティのためにそのまま返されます。ルックアップテーブルも推測も状態もない単一の決定論的な計算であるため、同じ入力からは常に同じ出力が得られます。巻尺をパイプ、車輪、樹木の幹に巻き付けて測り、図面、部品仕様、材料発注のために直線の幅が必要な場合にご利用いただけます。

円周を PI で割ると直径になる理由

大きさに関係なく、すべての円は、縁のまわりの長さと中央を横切る長さの間に同じ比率を持っています。その比率が PI であり、小数展開が終わることも循環することもない無理数の定数です。円周は PI に直径を掛けた値に等しいため、測定した円周を PI で割れば直径が正確に復元されます。

推定のステップはなく、PI 自体の精度を超える近似もありません。これが実務上重要なのは、柔らかい巻尺を丸い物体に巻き付ける方が、ものさしを横に当てるよりもはるかに簡単な場合が多いからです。

特に大きな円筒、ケーブル、車輪、生きている樹木など、両端に同時に手が届かない対象ではそうです。円周から直径への変換は、その簡単な測定値を、図面や機械加工技術者、サプライヤーが実際に求める数値に変えてくれます。

入力ルール、丸め、エラー動作

ゼロは、周囲を持たない円には意味のある直径が存在しないため拒否されます。負の値は長さが負になり得ないため拒否され、数値以外または無限の値は PI で割って実数の結果を得られないため拒否されます。重要な点として、この呼び出しは課金されません。

丸めは half-up（四捨五入）であり、切り捨てる桁が 5 以上であれば残す最後の桁が繰り上がります。これは多くの方が紙の上で期待する丸めの動作と一致します。

この変換が実際のワークフローで価値を発揮する場面

この変換は、丸い物体の幅に直接アクセスせずにサイズを決定しなければならないあらゆる場面で登場します。配管工は断熱されたパイプに巻尺を巻いて適切なクランプを発注し、ホイールやタイヤの製造業者はビードの円周を測ってリム径を確認します。

林業家は胸高で幹の周囲を測り、成長記録や材積推定のために直径を導き出し、エンジニアはラベルのないシャフトやローラーをものさしに沿って転がし、1 回転あたりの円周を捉えて逆算します。ソフトウェアでは、この計算はジオメトリパイプライン、CAD インポートフィルター、円の半径・直径・円周・面積を行き来できる教育ツールの内部で頻繁に行われるステップです。

無効な入力は境界で捕捉され、NaN 値が下流に伝播することがなく、丸めルールは文書化され安定しています。

活用例

巻尺の測定値からパイプのサイズを決定

断熱されたパイプに巻尺を巻き、円周を送信して、クランプ、スリーブ、継手を発注するために必要な直径を取得できます。

樹木の幹周りを幹の直径に変換

林業家は胸高で円周を測定し、PI で割ることで、成長記録や材積計算式に用いられる直径を得られます。

よくある質問

どの計算式を使用していますか？

直径は円周を PI で割った値に等しく、ランタイムに組み込まれた倍精度定数 3.141592653589793 を使用しています。

結果はどのように丸められますか？

指定した小数点以下の桁数に half-up（四捨五入）で丸められます。デフォルトは 6 桁で、0 から 12 までの任意の整数を指定でき、どのマシンでも出力は同一です。

サービスは測定値を保存しますか？

いいえ。入力はメモリ内で処理され破棄され、計算された結果のみが返されます。

木の幹の直径を巻尺で測るには？

胸の高さで幹に巻尺を回し、その周囲の長さを入力します。円周率で割った値が直径になるので、幹の向こう側に手が届かなくても成長記録や材積の見積もりに使えます。

0や負の数を入力するとどうなりますか？

計算されずに受け付けられません。周の長さがない円には意味のある直径がなく、長さが負になることもないためです。数値でない値や無限大も同じく弾かれます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/math/circumference-to-diameter

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

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

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

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/math/circumference-to-diameter",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "circumference": 31.41592653589793
},
)
task_id = res.json()["task_id"]

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

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

リクエスト例

{
  "circumference": 31.41592653589793
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "math.circumference_to_diameter",
  "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 は、円のまわりの長さを受け取り、円を横切る長さを返します。この関係は数学で最も古い定数のひとつであり、直径は常に円周を PI（およそ 3.14159）で割った値になります。このページ上ではまったく同じコードが無料で動作しているため、エンドポイントを自動化ワークフローに組み込む前に、手動で値を検証することが可能です。

円周を PI で割ると直径になる理由

このエンドポイントはランタイムに組み込まれた倍精度の PI 値を使用しており、有効桁数は約 15 桁と、入力されるあらゆる物理測定をはるかに上回る精度です。その後、結果は指定した小数点以下の桁数に四捨五入されるため、どのマシンでもどのリクエストでも出力は安定して同一になります。

入力ルール、丸め、エラー動作

この API は必須フィールド circumference をひとつ受け付け、それは正の有限数でなければなりません。入力がこれらのチェックのいずれかに失敗した場合、エンドポイントは問題のフィールド名を示す invalid_input エラーを返します。計算を実行しなかったリクエストは何も消費していないからです。任意フィールドの decimals は出力精度を制御し、デフォルトは小数点以下 6 桁で、0 から 12 までの任意の整数を受け付けます。レスポンスオブジェクトには、計算された直径、送信した円周、使用された正確な PI 定数、適用された小数桁数が含まれるため、すべての結果は独自の来歴を持ち、サービスを再呼び出しすることなく後から再現・監査できます。

この変換が実際のワークフローで価値を発揮する場面

このエンドポイントをそれらのパイプラインに組み込むことで、手作りの除算が、バージョン管理され検証されテストされた契約に置き換わります。リクエストあたり $0.002 で単位あたりの追加料金もないため、バッチジョブの全レコードで呼び出せるほど安価です。さらにこのページの無料ブラウザ版は同一のモジュールを実行しているため、対話的にテストした内容がそのまま本番環境で API が返す内容になります。

連携の活用例

自動化パイプラインでのジオメトリ検証

バッチジョブでレコードごとにエンドポイントを呼び出し、厳密な入力検証により、ゼロ、負、非数値の円周が下流の計算を壊す前に拒否できます。

技術的な質問

料金はいくらですか？

リクエストあたり $0.002 で、単位あたりの追加料金はありません。このページ上では同一のコードでブラウザから無料で実行することも可能です。

どの入力が拒否されますか？

ゼロ、負、非数値、非有限の円周はすべて、フィールド名を示す invalid_input エラーを返し、それらの呼び出しは課金されません。

直径を円周に戻すことはできますか？

直径に PI を掛ければ円周を復元できます。このエンドポイントは円周から直径への方向専用です。

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

円周から直径へ

無料で実行

計算例

円周を PI で割ると直径になる理由

入力ルール、丸め、エラー動作

この変換が実際のワークフローで価値を発揮する場面

活用例

巻尺の測定値からパイプのサイズを決定

樹木の幹周りを幹の直径に変換

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

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

リクエスト例

レスポンス例

料金

エラー

技術的な注記

円周を PI で割ると直径になる理由

入力ルール、丸め、エラー動作

この変換が実際のワークフローで価値を発揮する場面

連携の活用例

自動化パイプラインでのジオメトリ検証

技術的な質問

ありがとう