ForHosting KIT · 開発者向けツール

旋回予測距離計算

旋回予測距離計算機は、航空機が次のレグに沿ってロールアウトするために、ウェイポイントのどれだけ手前で一定半径の旋回を開始すべきかを求めます。計画した旋回半径と小さい方のコース変更角を入力すると、フライバイ・ウェイポイントの標準的な接線幾何を適用します。結果の距離単位は半径と同じです。そのため、メートル、海里、フィートなど、整合した任意の単位をご利用いただけます。

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

無料で実行 API仕様を見る

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

フライバイ・ウェイポイントの幾何を理解する

航空機はレグの交点で瞬時に針路を変えられないため、フライバイ旋回はウェイポイントの手前から始まります。2本の直線レグを円弧で結ぶと、各接点はウェイポイントから両レグ上で同じ距離に位置します。旋回中心、ウェイポイント、接点で構成される直角三角形から、距離 = 旋回半径 × tan(コース変更角 ÷ 2) という関係が得られます。本計算機はこの式を直接評価します。コース変更角には、インバウンドコースとアウトバウンドコースの小さい方の角度を使用し、0度以上180度未満で指定します。0度なら両レグが同方向に続くため、予測距離も0です。角度が大きくなるほど、接点はウェイポイントから遠ざかります。180度の正確な反転は受け付けません。半角の正接が無限大となり、この単一円弧のフライバイモデルでは有限の予測点が存在しないためです。出力には半角のラジアン値と使用式も含まれるので、飛行計画表やソフトウェア試験で数値を確認できます。

半径とコース変更角を整合させる

対象となる飛行段階の航空機速度と予定バンク角に対応する旋回半径をご使用ください。本機能は、速度、バンク角、風、性能限界から半径を導出しません。入力された半径を、計画地上経路円弧の水平な幾何学的半径として扱います。予測距離の単位は半径の単位を引き継ぎます。半径が1.5海里なら結果も海里、2,400メートルなら結果もメートルです。コース変更角は0度以上180度未満で入力してください。北をまたぐ場合も含め、インバウンドとアウトバウンドの小さい方の角度差を求めます。たとえば350度から020度への変更は330度ではなく30度です。計算では角度の大きさだけを用いるため、半径と角度が同じなら左旋回と右旋回の距離は等しくなります。旋回方向はナビゲーションロジックで別途扱えます。数値文字列も使用できますが、欠落値、無限値、範囲外の値、負の半径には明確な入力エラーを返します。

結果と運用上の制限を正しく解釈する

返される予測距離は、理論上のウェイポイントからインバウンドレグをさかのぼり、一定半径の円弧がそのレグに接する地点までのレグ沿いの距離です。理想的な平面幾何では、その地点で旋回を開始して指定半径を維持すると、出口側の接線はウェイポイント通過後の対応する距離で次のレグに一致します。実際の航法システムでは、ロールイン、ロールアウト、風、対地速度の変化、コンテインメント、障害物、誘導則などの補正が加わる場合があります。これらは本解析計算の対象外です。結果は幾何学的な計画値、またはより包括的な飛行管理モデルの一要素として扱い、単独の運航承認には使用しないでください。半径が航空機、速度、バンク制限、高度、環境条件に適合することを確認し、必要に応じて承認済み手順と認証済みアビオニクスに従ってください。決定論的な出力は、計画表の検証、再現可能な試験値の作成、システムの公称接線幾何の比較に適しています。ネットワーク、現在の気象、機体データベース、乱数を使用しないため、同じ入力からは常に同じ値が得られます。API の各計算料金は $0.002 です。

活用例

フライバイ経路を設計する

複数の経路レグを結ぶ際に、一定半径の旋回を開始する位置を見積もります。

飛行計画ソフトウェアを検証する

アプリケーションの公称予測距離を、決定論的な接線幾何の基準値と比較します。

試験用データを作成する

航法、シミュレーション、アビオニクス試験向けに再現可能な期待値を生成します。

よくある質問

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

距離 = 旋回半径 × tan(コース変更角 ÷ 2) を使用し、正接計算のために度数を変換します。

結果はどの単位で表示されますか？

turn_radius と同じ距離単位です。半径を海里で入力すれば海里、メートルで入力すればメートルになります。

北をまたぐコースはどう扱いますか？

小さい方の角度差を入力してください。350度から020度への変更なら30度を指定します。

180度の変更が無効なのはなぜですか？

半角の正接が無限大となるため、単一円弧のフライバイモデルでは正確な反転に対する有限距離が存在しません。

風やロール運動も結果に含まれますか？

含まれません。理想的な平面接線幾何です。運用および性能上の補正は、適切な認証済み手順で適用してください。

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

API の各リクエスト料金は $0.002 です。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/geo/turn-anticipation-distance

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

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

curl -X POST https://api.kit.forhosting.com/geo/turn-anticipation-distance \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"turn_radius":1500,"course_change_deg":60}'

const res = await fetch("https://api.kit.forhosting.com/geo/turn-anticipation-distance", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "turn_radius": 1500,
    "course_change_deg": 60
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/turn-anticipation-distance",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "turn_radius": 1500,
    "course_change_deg": 60
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/turn-anticipation-distance", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"turn_radius":1500,"course_change_deg":60}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"turn_radius":1500,"course_change_deg":60}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/turn-anticipation-distance", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "turn_radius": 1500,
  "course_change_deg": 60
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.turn_anticipation_distance",
  "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の完全なドキュメントを見る →