ForHosting KIT · 開発者向けツール

点から無限大円線までの距離計算

この計算機は、指定した緯度経度の点から、別の2座標で定まる完全な大円までの最短球面距離を求めます。線分の計算とは異なり、線は定義点で終わらず、両方向へ地球を一周するまで続くものとして扱います。結果にはメートル、キロメートル、角度が含まれ、既定では地球の平均半径を使用します。別の天体や幾何学的な球には任意の半径も指定できます。

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

無料で実行 API仕様を見る

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

対象点と無限大円線を指定します

調べる座標を point_lat と point_lon に入力し、目的の線上にある2つの座標を指定してください。定義点には line_start_lat と line_start_lon、および line_end_lat と line_end_lon を使います。この2点は、球の中心を通る平面と球面との交線である大円を定めます。本機能では、その円を両方の定義点より先まで延び、最終的に地球を一周する無限の線として扱います。垂線の足が定義点間の短い弧の外側にある場合、この違いが重要です。線分の計算なら端点までの距離になりますが、本機能は延長された大円まで測ります。緯度は -90 から 90 度、経度は -180 から 180 度の範囲で指定してください。2点が同一または対蹠点である場合、一意の平面が定まらないため使用できません。十進度は数値または厳密な数値文字列として送信できますので、フォームと構造化 API のどちらにも対応できます。

球面計算と出力の意味を確認します

各座標は、球の中心から伸びる3次元単位ベクトルへ変換されます。線を定義する2ベクトルの外積から、大円平面に垂直な法線を得ます。その法線を正規化し、対象点のベクトルとの内積の絶対値を取ると、垂直方向の角距離の正弦になります。逆正弦によって、点と大円の間の最小かつ符号なしの角度を求めます。この角度に radius_m を掛けた値が distance_m で、distance_km は同じ値を千で割ったものです。球面角を直接使う場合に備えて angular_distance_deg も返します。既定の半径は IUGG の平均地球半径である 6,371,008.8 メートルですが、正の任意半径を指定できます。これは楕円体測地線ではなく球面モデルによる計算です。ベクトル表現には経度の継ぎ目がないため、平面投影の経度ひずみを避け、日付変更線を横切る大円も自然に処理できます。

最短距離を正しく解釈します

返される距離は常に0以上であり、完全な大円上のどこかにある最寄り位置まで、対象点がどれだけ離れているかを示します。進行方向を持つ経路の左右、垂線の足までの経路上の進行距離、その足が2つの定義座標の間にあるかどうかは示しません。これらを調べるには、符号付きクロストラック距離または線分の計算が必要です。結果が0なら、浮動小数点精度の範囲で対象点が同じ大円平面上にあります。指定された弧から遠く離れていても同様です。地域的な測量値と比較する際は、地球を球としてモデル化している点にご注意ください。実際の地球は扁平な楕円体であり、地形には高度があり、現実の移動経路は道路や許可空域に従う場合があります。再現可能な自動処理には入力半径も保存してください。定義点の順序を逆にすると法線の符号だけが変わり、この絶対距離は変わりません。

活用例

延長された飛行経路を確認します

2座標で定義した完全な測地線からウェイポイントまでの距離を、最寄り点が指定弧の外側にあっても測定できます。

全球地図の幾何を検証します

平面地図へ投影せず、同じ大円上にあるべき座標が球面上の許容差を満たすか確認できます。

別の球状天体をモデル化します

任意半径を指定し、惑星、衛星、地球儀、抽象的な球で同等の垂直距離を計算できます。

よくある質問

API リクエストの料金はいくらですか？

API リクエスト1回につき $0.002 です。ブラウザーの計算機はローカルで無料実行できます。

線は2点間の弧だけに限定されますか？

いいえ。2点を通り、両方向へ延びる完全な大円を計算対象にします。

同一点や対蹠点が拒否されるのはなぜですか？

どちらの組み合わせも一意の大円平面を定められず、目的の線が曖昧になるためです。

WGS 84 楕円体を使いますか？

いいえ。既定では IUGG の平均地球半径を持つ球を使い、指定された任意半径にも対応します。

2つの定義点を逆にすると答えは変わりますか？

いいえ。平面法線の符号は反転しますが、垂直距離の絶対値は変わりません。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/geo/point-to-line-distance

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

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

curl -X POST https://api.kit.forhosting.com/geo/point-to-line-distance \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"point_lat":10,"point_lon":20,"line_start_lat":0,"line_start_lon":0,"line_end_lat":0,"line_end_lon":90}'

const res = await fetch("https://api.kit.forhosting.com/geo/point-to-line-distance", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "point_lat": 10,
    "point_lon": 20,
    "line_start_lat": 0,
    "line_start_lon": 0,
    "line_end_lat": 0,
    "line_end_lon": 90
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/point-to-line-distance",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "point_lat": 10,
    "point_lon": 20,
    "line_start_lat": 0,
    "line_start_lon": 0,
    "line_end_lat": 0,
    "line_end_lon": 90
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/point-to-line-distance", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"point_lat":10,"point_lon":20,"line_start_lat":0,"line_start_lon":0,"line_end_lat":0,"line_end_lon":90}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"point_lat":10,"point_lon":20,"line_start_lat":0,"line_start_lon":0,"line_end_lat":0,"line_end_lon":90}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/point-to-line-distance", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "point_lat": 10,
  "point_lon": 20,
  "line_start_lat": 0,
  "line_start_lon": 0,
  "line_end_lat": 0,
  "line_end_lon": 90
}

レスポンス例

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