クロストラック距離計算機

範囲外の緯度・経度は invalid_input で失敗し、課金されません。プリペイド API は、サーバーや SDK が同じ契約を必要とする場合、成功した要素ごとに $0.002 を請求します。

クロストラック距離の意味と3点の指定方法

球体地球モデル上で、経路の始点 A と終点 B を通る大圏を想像してください。任意の第3のクエリ点 P から、球面の意味で航跡と直角に交わる別の大圏に沿って垂線を下ろすことができます。その垂線の長さを球の半径でスケーリングしたものがクロストラック距離です。符号付きの形は、向きのある経路のどちら側にいるかを示します。緯度はマイナス90度から90度までの両端を含む範囲、経度はマイナス180度から180度までの両端を含む範囲になければなりません。別の球体を意図的にモデル化するときだけ増減してください。正の値は A から B へ進むとき左側、負の値は右側を意味し、ゼロに近い大きさは数値安定性のため on_track として報告されます。クエリ点には必須フィールド lat と lon、A には start_lat と start_lon、B には end_lat と end_lon を、すべて十進度で送信してください。クライアントがすでに latitude、longitude、lat1、lon1、lat2、lon2 という名前を使っている場合、これらのエイリアスも受け付けます。これらの範囲外の座標は、フィールド名と境界を明示したメッセージとともに invalid_input を発生させ、呼び出し側が不良な GPS ノイズを黙って切り詰めて偽の偏位にすることはありません。オプションの radius_m の既定値は637万1000メートルで、多くの航空の例で使われる平均地球半径です。A と B が一致する場合、経路は未定義となり、エンジンはリクエストを拒否します。壁時計も外部地図サービスもない純粋な算術なので、同一の入力は常に同一の JSON を生成します。

符号付きメートル、側面ラベル、沿道距離、方位角の読み方

ドローンのコリドーや滑走路規模の監視にはメートルを、大洋や長距離航空路にはキロメートルを選んでください。検証失敗が距離を捏造することはありません。成功時、レスポンスはすべての座標と使用した半径をそのまま返し、続いて cross_track_m と cross_track_km を符号付き垂直偏位として報告します。absolute_m と absolute_km は符号なしの大きさで、どれだけ逸脱したかだけを気にするしきい値チェックに便利です。side フィールドは、ペイロードに記載された符号規約 positive_left_of_path_A_to_B に従い、left、right、on_track のいずれかになります。along_track_m は A から無限の大圏に沿って B 方向への進行度を測り、P が有限の弧 A–B の外に射影される場合は負になったりセグメント長を超えたりします。側方と縦方向の文脈の両方が必要なときは path_length_m と併用してください。path_bearing_deg は A から B への初期針路で、北から時計回りに0から360の区間の度数です。angular_cross_track_deg は、教科書の表と比較する単体テストのために偏位を角度で表し直したものです。method は常に spherical_cross_track なので、下流のコードは形状を推測せずにアルゴリズムを検証できます。フィールド欠落、非有限数、範囲外座標、一致した端点はすべて invalid_input で閉じた形で失敗し、プリペイド API では課金されません。

API の使い方、料金、ナビゲーションのワークフロー、実用上の限界

ブラウザで動く無料のクロストラック距離計算機は、地理空間ライブラリをインストールせずに、授業のデモ、海図作業、手軽な確認に使えます。モデルは楕円体ではなく球体なので、サブメートルの測量作業にはローカル ENU や完全な測地ライブラリを適用してください。ナビゲーションコリドー、宿題、フリート警報では、平均地球の球体が標準的なパイロット・船員の参考書に掲載された公式と一致します。6つの必須座標とオプションの radius_m を含む JSON ボディを送信してください。プリペイド API は、飛行運航ダッシュボード、船舶交通システム、ラストマイル配送ルーター、シミュレーション harness が KIT 残高で成功要素ごとに $0.002 の安定した契約を必要とする場合に利用します。検証失敗は、エンジンがリクエストを拒否した後、残高を消費しません。地名やライブ航跡が必要な場合は、このエンドポイントを独自のジオコーダーや AIS フィードと組み合わせてください。この製品は球体上の幾何学のみを測定します。SDK を公開する開発者は、cross_track_m と side を警報ルールに直接マッピングできます。absolute_m がコリドー半幅を超えたら発火させ、学生が球面三角形を手で解くときに目にするのと同じフィールドで地図を緑・黄・赤に色付けします。