ForHosting KIT · 開発者向けツール

水路の径深（油圧半径）計算ツール

水路の径深（油圧半径）は、流れの断面積を潤辺で割った値です。この計算ツールはその関係を直接適用し、入力した測定値に対応する長さの単位で結果を返します。面積は平方単位、液体に接する水路境界は対応する長さの単位で入力してください。計算は常に同じ入力から同じ結果を返し、開水路と閉管のどちらにも使用できます。潤辺がゼロまたは負の場合は、有効な水理断面を表さないためエラーになります。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

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

実際に流れている断面積を求めます

径深の計算に使うのは液体が占める面積であり、水路全体の幾何学的面積とは限りません。たとえば円管が満水でない場合、flow_area には水で満たされた円弧部分だけを含めます。規則的な長方形の開水路では、水深と水路幅を掛けます。平方メートルにはメートル、平方フィートにはフィート、平方センチメートルにはセンチメートルというように単位をそろえてください。平方長さを長さで割ると長さになるため、このツールでは単位変換を行いません。流積がゼロなら径深もゼロになり、入力として受け付けます。物理的な面積は負にならないため、負の値は拒否します。測量やモデルから有効流積が得られている場合は、理想形状から再計算せず、その値を直接使用してください。これにより、水面より上の乾いた空間を誤って含めず、実際の水理断面に対応した結果になります。

水に触れる潤辺だけを測ります

潤辺とは、選んだ断面で液体に直接接している固体境界の長さです。長方形の開水路では、底幅に水深の2倍を加えます。自由水面は水路の壁面に接していないため含めません。満水の円管では内周全体が潤辺です。不規則な自然水路では測量断面を使い、水中にある短い線分の長さを合計して近似できます。水面より上の部分は除外し、面積単位に対応する長さの単位を使用してください。wetted_perimeter がゼロまたは負の場合、計算ツールは明示的にエラーを返します。ゼロでは除算できず、負の長さには物理的な意味がありません。この検証により、未入力値がゼロに変換された場合や、座標用の符号規則を長さに誤用した場合も早期に発見できます。

計算された径深を読み取ります

式は R = A/P です。R は径深、A は流れの断面積、P は潤辺を表します。平方メートルとメートルを入力すれば結果はメートル、平方フィートとフィートならフィートになります。径深は通常、水深や文字どおりの幾何学的半径とは同じではありません。境界との接触長さに対して利用できる流積の大きさを示し、マニング式などの開水路抵抗式で使われます。他の条件が同じなら、値が大きいほど潤辺の単位長さ当たりの流積が大きいことを示します。形状、粗度、単位が整合する場合に限って値を比較してください。満水の円管では径深が管径の4分の1になるため、独立した確認に利用できます。長方形の開水路では水深が流積と潤辺の両方を変えるので、その都度計算してください。返された入力値を保存すると、後の確認が明確になります。

活用例

開水路流量計算の準備

長方形、台形、または測量断面に抵抗式を適用する前に径深を求めます。

満水円管の形状確認

満水円管の面積と円周の比が管径の4分の1になることを確認します。

水路断面案の比較

単位をそろえ、断面形状の違いが流積と境界接触の比に与える影響を比較します。

よくある質問

どの式で計算しますか？

径深 = 流れの断面積 ÷ 潤辺、すなわち R = A/P を使用します。

自由水面は潤辺に含まれますか？

含まれません。液体に接する水路または管の固体境界だけを含めます。

結果の単位は何ですか？

長さの単位です。平方メートルをメートルで割ればメートル、平方フィートをフィートで割ればフィートになります。

潤辺がゼロだとエラーになるのはなぜですか？

ゼロ除算が必要となり、有効な濡れた境界を表さないためです。負の値も同じ物理的理由で拒否されます。

API での計算料金はいくらですか？

API は1リクエスト $0.002 です。同じ決定論的計算をブラウザーでは無料で実行できます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/earth/hydraulic-radius

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

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

curl -X POST https://api.kit.forhosting.com/earth/hydraulic-radius \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"flow_area":12.5,"wetted_perimeter":8.2}'

const res = await fetch("https://api.kit.forhosting.com/earth/hydraulic-radius", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "flow_area": 12.5,
    "wetted_perimeter": 8.2
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/earth/hydraulic-radius",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "flow_area": 12.5,
    "wetted_perimeter": 8.2
},
)
task_id = res.json()["task_id"]

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

body := bytes.NewBufferString(`{"flow_area":12.5,"wetted_perimeter":8.2}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/earth/hydraulic-radius", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "flow_area": 12.5,
  "wetted_perimeter": 8.2
}

レスポンス例

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

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