ForHosting KIT · 数学

円柱の立方ヤード

Q: 入力はどこかに保存されますか？

いいえ。 計算は純粋関数です。半径と高さはメモリ上で処理されて破棄され、返るのは体積だけです。

フィートで測った丸い穴や柱、タンクの体積を、コンクリートや砂利、マルチの注文に使う立方ヤードで求めます。半径2フィート、高さ5フィートなら2.327106立方ヤードです。ブラウザで無料で使えます。

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

無料で実行 API仕様を見る

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

計算例

入力した場合

半径: 2
高さ: 5

結果

体積 (yd³): 2.327106

杭穴、柱、タンク、サイロをフィートで測ったのに、そこに流し込む材料——コンクリート、砂利、砂、マルチ、表土——が立方ヤード売りの場合、誰かが2つの単位の橋渡しをしなければなりません。その橋渡しこそがこの機能です。底面の半径と高さをフィートで送信すると、1回の決定的な呼び出しで立方ヤードの体積が返ります。πr²h立方フィートを27で割るだけで、手計算も単位の勘違いもありません。巻尺の読み違いが、気づかないうちに間違った発注数量になることはありません。

フィート入力から立方ヤード出力へ

直円柱は円を直線軸に沿って押し出した形なので、体積は底面積に高さを掛けたものです。V = πr²h。半径rと高さhをフィートで測れば、この式は立方フィートを返します。しかしアメリカのバルク材料は立方ヤードで見積もられ、1立方ヤード——一辺3フィートの立方体——はちょうど27立方フィートです。

近似されるのは定数π自体だけで倍精度で保持され、27は丸めた係数ではなく厳密な定義なので、唯一の丸めはお客様が制御する表示上の丸めだけです。測ったのが半径ではなく直径なら、呼び出す前に2で割ってください。直径を半径として送ると、半径が二乗で効くため体積が4倍になり、4倍のコンクリートは高い失敗です。

この二乗のせいで、広い穴の半径の半インチの誤差は、深さの同じ誤差よりはるかに大きく響きます。

円柱のヤードが登場する現場

立方ヤードの円柱体積は、アメリカの建設・造園現場の働き者の数量です。巻尺はフィートを示すのに、レディミクスト工場も砂利採取場も園芸店もヤードで請求するからです。請負業者は杭穴、フーチング、杭、型枠管の柱のヤード数を計算します。

直径2フィート、深さ5フィートの穴1つで約0.58立方ヤード、12本もあればミキサー車1台分の判断に丸まります。井戸管、水槽、穀物サイロ、砂や骨材の山、排水桝、円形の池も、測定値が2つあればπr²h÷27に帰着します。この機能はグローバルエッジ上の純粋関数として動作します。

活用例

杭穴のコンクリートを発注する

円筒形の穴、フーチング、型枠管の柱の立方ヤード数を、半径と深さのフィート値から直接取得できます。レディミクスト工場が請求するのと同じ単位です。

タンクやサイロをヤードで見積もる

水槽、井戸管、穀物サイロの容量を、巻尺の2つの読み値から立方ヤードで計算し、充填と材料の計画に使えます。

円形掘削の埋め戻しを見積もる

円形の掘削、桝、池の半径と深さを、発注が必要な砂利・砂・埋め戻し土の立方ヤード数に変換します。

よくある質問

単位はどうなっていますか？

半径と高さはフィート、結果は立方ヤードです。1立方ヤード = 27立方フィートという厳密な定義を使います。

半径ではなく直径を測りました。何を送ればよいですか？

先に直径を2で割ってください。式はπr²h÷27なので、直径を半径として送ると実際の体積の4倍になります。

入力はどこかに保存されますか？

いいえ。計算は純粋関数です。半径と高さはメモリ上で処理されて破棄され、返るのは体積だけです。

なぜ体積を27で割るのですか？

1立方ヤードは一辺3フィートの立方体で、ちょうど27立方フィートだからです。27は丸めた係数ではなく正確な定義なので、丸めは最後に選ぶ桁数だけです。

幅2フィートの柱穴にはどれくらいのコンクリートが必要ですか？

直径2フィート、深さ5フィートの穴は半径1フィートで、約0.58立方ヤード必要です。穴の数を掛ければ、注文全体の量が分かります。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/math/cubic-yards-cylinder

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

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

curl -X POST https://api.kit.forhosting.com/math/cubic-yards-cylinder \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"radius":2,"height":5}'

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

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/math/cubic-yards-cylinder",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "radius": 2,
    "height": 5
},
)
task_id = res.json()["task_id"]

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

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

リクエスト例

{
  "radius": 2,
  "height": 5
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "math.cubic_yards_cylinder",
  "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`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

両方の入力は計算の前に正の有限数として検証され、それ以外はフィールド名を特定した型付きinvalid_inputエラーで拒否されます。

フィート入力から立方ヤード出力へ

そこでこのエンドポイントはV_yd³ = πr²h ÷ 27を1ステップで適用します。これはすべてのコンクリート発注書が暗黙に前提としている計算です。

検証、精度、丸め

2つの入力は算術の前に検証されます。半径も高さも正の有限数でなければなりません。失敗したのはサービスではなく呼び出し側のデータだからです。"2.5"のような数値文字列は受け入れて変換するので、現場のタブレットからのフォームやクエリパラメータにも親切です。ゼロ、負の値、欠落フィールド、解釈できない文字列、NaN、無限大はすべて、原因となったフィールドを名指しする型付き<em>invalid_input</em>エラーで拒否されます。このエラーは課金されません。入力が通れば、体積は倍精度で計算され、27で割られ、要求された小数桁数——既定は6、オプションの<em>decimals</em>フィールドで0から12まで——に、絶対値に対する四捨五入規則で丸められます。この決定的な丸めは見た目以上に重要です。応答には実際に使われた半径と高さがそのまま返るので、1つのペイロードが計算内容の完全で監査可能な記録になります。

円柱のヤードが登場する現場

何も保存されず、第三者にも送られず、有料API呼び出しに応答するのと同じコードがこのページのブラウザ上で無料で動くので、見積もり表に組み込む前に対話的に寸法を確認できます。1リクエスト$0.002で従量課金もないため、候補寸法を数千通り試すような作業——たとえば厳しい材料予算に対してタンクや穴の深さを決める場合——もカタログ記載どおりの費用で、驚きはありません。

技術的な質問

料金はいくらですか。

1リクエスト$0.002で、従量課金はありません。このページのブラウザ上では無料で実行できます。

どんな入力が拒否されますか。

正の有限数でないものはすべて拒否されます。ゼロ、負の値、非数値文字列、NaN、無限大、欠落フィールドは型付きinvalid_inputエラーを返します。

精度は制御できますか。

はい。オプションのdecimalsフィールドで体積の小数桁数を0から12まで指定でき、既定は6です。丸めは四捨五入です。

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

円柱の立方ヤード

無料で実行

計算例

フィート入力から立方ヤード出力へ

円柱のヤードが登場する現場

活用例

杭穴のコンクリートを発注する

タンクやサイロをヤードで見積もる

円形掘削の埋め戻しを見積もる

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

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

リクエスト例

レスポンス例

料金

エラー

技術的な注記

フィート入力から立方ヤード出力へ

検証、精度、丸め

円柱のヤードが登場する現場

技術的な質問

ありがとう