ForHosting KIT · 旅行・地理

ハバーサイン距離 - 2地点間の大圏距離をkm・mi・mで算出

2つのGPS地点の大圏距離を、キロメートル・マイル・メートルで一度に求めます。40.7128、-74.006から51.5074、-0.1278までは5570.22218 kmで、半径6371 kmの球面上で測ります。ブラウザで無料で使えます。

  • 無料
  • ブラウザで動作
  • 登録不要
  • データは端末の外に出ません
ご利用方法 ウェブAPIメールTelegramアプリ 近日
入力した場合
Lat1
40.7128
Lng1
-74.006
Lat2
51.5074
Lng2
-0.1278
結果
Km
5,570.22218
Mi
3,461.175597
M
5,570,222.18

2つのGPS座標の間で地表に沿った最短経路が必要な場面では、平面上の計算や単純なユークリッド距離は正しい答えを返しません。地球の曲率を無視するため、都市間や国家間といった長距離の移動では大きな誤差が生じてしまいます。ハバーサインの公式は地球を一定半径の球体とみなし、大圏の弧長を返します。地図タイルも、第三者によるジオコーディングも、隠れたネットワーク通信も一切ありません。

ハバーサインの公式が実際に計算している内容

ハバーサインの公式は、球面上の2点の緯度と経度から両者のなす中心角を数値的に安定した方法で求め、その角度に球の半径を掛けて弧長を得る手法です。平たく言えば、点Aと点Bが与えられたとき、平らな地図ではなく滑らかな地球儀の上を最短経路でたどった場合にどれだけの距離を移動するかを答えます。

WGS84上のVincentyやKarneyのような楕円体モデルは使用しないため、極方向の扁平をモデル化する測地線ライブラリと比べて結果はごくわずか、コンマ数パーセント程度異なる場合があります。これは店舗の半径判定、配達所要時間の区分、分析用のバケット分けには通常十分ですが、測量級の精密測量の代替にはなりません。

出力は常に3単位で、キロメートル(km)、国際法定マイル(mi、1マイル=1609.344メートル)、メートル(m)です。

入力の仕様、座標の範囲、そしてよくある間違い

4つの数値を送信してください。緯度は−90から90までの閉区間になければならず、経度は−180から180までを含めて収まる必要があります。よくあるクライアント側の不具合は、緯度と経度の取り違えです(例えばGeoJSON風の習慣で都市の中心をlng,latの順で貼り付けてしまう場合)。

両方の数値がそれぞれの範囲に収まっていれば呼び出し自体は成功してしまいますが、意図した都市に対する距離は無意味な値になります。latが南北、lngが東西であることを必ず二重に確認してください。もう1つの落とし穴は、WGS84式の十進度ではなく、投影座標や地域格子のメートル値を入力してしまうことです。

同一の点は正しく距離ゼロを返します。対蹠点のペアにも対応しており、内部でのクランプ処理により浮動小数点の境界的なケースがNaNを生じないようにしています。tier Aのparse系機能におけるブラウザ上のツール経路は、まず本格的なパイプラインを組まなくても試せるよう設計されています。

大圏距離がプロダクトのパイプラインのどこに収まるか

ハバーサインは、安価で監査可能な距離のプリミティブとして活用してください。決済時の半径判定、最寄り倉庫の選定、請求先の都市と端末のGPSを比較する不正検知シグナル、スポーツアプリの活動サマリー、そしてすべての出発地・目的地のペアの隣にkmやマイルの値が必要な大量CSVのエンリッチメント処理などに適しています。

住所から始める場合にのみジオコーダーと組み合わせ、すでに緯度経度がある場合は、距離を得るためだけに再ジオコーディングするのは避けてください。複数地点の経路探索、道路の移動時間、曲がり角ごとの案内が必要な場合は、専用の経路探索エンジンを用いてください。ハバーサインは直線距離であり、走行距離ではありません。

法的な地権境界や地籍業務には、楕円体の測地線と地域のCRSを使用してください。範囲を検証し、大圏を測定し、3単位を返す。以上です。

店舗検索と配達半径の判定

買い物客のGPSピンを各店舗やダークストアの座標と比較し、在庫や到着予定時刻で並べ替える前に、N キロメートルまたはマイル以内の拠点だけを残します。

物流と倉庫の事前フィルタ

車両群や複数倉庫のシステムにおいて、大圏距離のしきい値を超える候補拠点を除外し、費用のかかる道路経路探索の呼び出しを絞り込んだ候補だけに対して実行します。

ハバーサイン距離の公式とは何ですか?

2つの緯度と経度を両者のなす中心角に変換し、それに地球の半径(ここでは6371km)を掛けて大圏の弧長を求める、球面三角法の公式です。

受け付けられる座標の範囲は何ですか?

緯度は−90から90までを含む範囲、経度は−180から180までを含む範囲でなければなりません。

これは走行距離と同じものですか?

いいえ。 ハバーサインは球体上の直線距離です。道路の距離、交通状況、標高には経路探索エンジンが必要です。本機能は半径フィルタや直線距離の見積もりにお使いください。

座標が受け付けられたのに距離がおかしいのはなぜですか?

よくある原因は緯度と経度の取り違えです。どちらの数値も有効な範囲に収まることがあるため拒否されませんが、地点の位置が変わってしまいます。十進の度ではなく投影座標のメートル値を入れた場合も同じです。

ハバーサインは楕円体での距離とどれくらい違いますか?

通常はごくわずかな割合です。地球を球として扱い、極の扁平さを無視するため、店舗の半径や配達範囲、分析には十分ですが、精密な測量や土地の境界には向きません。

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

POSThttps://api.kit.forhosting.com/geo/haversine

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

curl -X POST https://api.kit.forhosting.com/geo/haversine \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat1":40.7128,"lng1":-74.006,"lat2":51.5074,"lng2":-0.1278}'
{
  "lat1": 40.7128,
  "lng1": -74.006,
  "lat2": 51.5074,
  "lng2": -0.1278
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "geo.haversine",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

HTTPコード意味
401unauthorizedAPIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
402insufficient_balance残高が不足しています。チャージ後に再度お試しください。
404unknown_type指定されたタスクタイプは存在しません。タイプ名を確認してください。
429rate_limitedリクエストが多すぎます。しばらく待ってから再度お試しください。

これは物流、店舗検索API、車両配車の事前フィルタ、地理空間分析などで使われる標準的な第一次近似の距離です。このエンドポイントは2組の緯度経度を受け取り、値の範囲を検証したうえで、キロメートル・法定マイル・メートルの距離を1回の決定的な呼び出しで返します。

ハバーサインの公式が実際に計算している内容

この機能では、多くのオープンソースGISの断片コードやPostGIS系のチュートリアル、モバイルSDKがハバーサイン用として記載している、慣例的な平均地球半径6371キロメートルを用います。実装は固定した丸めを伴う純粋な算術演算であり、時刻の取得も乱数の種もなく、経路上に遠隔のタイルやジオコーディングサービスも存在しないため、同じ入力からは常に同じJSONが得られます。

入力の仕様、座標の範囲、そしてよくある間違い

出発地のlat1とlng1、目的地のlat2とlng2で、いずれも十進度で表します。この範囲を外れた値はinvalid_inputとして拒否され、課金されることはありません。フィールドの欠落、有限でない値、数値として解釈できない文字列も、距離の計算前に検証で弾かれます。このAPIは地理的な度数のみを受け付けます。料金はAPI上で成功した項目ごとに一律$0.002です。

大圏距離がプロダクトのパイプラインのどこに収まるか

Worker、バックエンドのジョブ、あるいはスクリプトから呼び出し、4つの座標を渡して、JSON結果からkm/mi/mを読み取り、保存または表示するだけです。モデルは公表された半径を持つ球体であるため、オフラインで再計算して、丸められたフィールドの最後の1マイクロメートルまでAPIと一致させることができます。それ以外のあらゆる用途、すなわちダッシュボード、SLA、APIのフィルタなどには、このエンドポイントが小さく決定的な構成要素となります。

出発地・目的地ペアの大量CSVエンリッチメント

GISスタックを立ち上げたり地図の課金APIを呼び出したりすることなく、出荷、テレメトリ、イベントのエクスポートにkm・mi・mの列を追加します。

geo.haversineはどの単位を返しますか。

成功した応答には必ずkm(キロメートル)、mi(国際法定マイル)、m(メートル)が含まれ、あわせて計算に用いた定数radius_kmも返されます。

APIの料金はいくらですか。

成功したリクエストごとに、ForHosting KITのプリペイド残高から$0.002が課金されます。検証に失敗した場合は課金されません。サブスクリプションは不要です。

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