コンテンツへスキップ
POST AI agent ready /v1/geo/distance

距離計算 API - 座標間のハーバーサイン

2 つの緯度/経度のペアを指定し、Haversine の公式を使用して計算されたそれらの間の距離を受け取ります。 キロメートル、マイル、海里をサポートします。 地球上の任意の 2 点を正確に測定します。 外部サービス呼び出しはありません。 計算はすべてサーバー上で実行されます。

Parameters

objectrequired

The origin point with lat (-90 to 90) and lng (-180 to 180).

objectrequired

The destination point with lat (-90 to 90) and lng (-180 to 180).

string

The distance unit for the result.

Code examples

curl -X POST https://api.botoi.com/v1/geo/distance \
  -H "Content-Type: application/json" \
  -d '{"from":{"lat":40.7128,"lng":-74.006},"to":{"lat":51.5074,"lng":-0.1278},"unit":"km"}'

When to use this API

ユーザーからの距離に応じて近くの店舗やレストランを並べ替えます

ユーザーの座標からデータベース内の各場所までの距離を計算します。 結果で並べ替えて、最も近いオプションを最初に表示します。 サーバー側で実行されるため、Google Maps API キーは必要ありません。

eコマースチェックアウトの配送範囲を検証する

注文を確定する前に、倉庫と配送先住所の間の距離を計算してください。 距離が配送エリアを超える場合は、拒否するか追加料金を適用します。

フィットネス アプリや物流アプリ用の移動距離トラッカーを構築する

連続した GPS ウェイポイントを送信し、距離を合計して合計旅行長を計算します。 ランニングルート、車両追跡、サイクリングアプリに使用できます。

Frequently asked questions

Haversine の公式はどの程度正確ですか?
Haversine の公式は完全な球体を想定しており、地球上のほとんどの距離で約 0.3% 以内の精度です。 メートル未満の精度を得るには、地球の楕円体形状を考慮した Vincenty の公式を使用します。
このエンドポイントはどのような座標系を想定していますか?
WGS84 10 進度。 緯度の範囲は -90 ～ 90 (南から北) です。 経度の範囲は -180 ～ 180 (西から東) です。 これは、GPS デバイスや Google マップで使用されているのと同じシステムです。
3 点以上の距離を計算できますか?
このエンドポイントは、リクエストごとに 1 ペアのポイントを処理します。 マルチポイント ルートの場合は、連続する各ペアのエンドポイントを呼び出し、距離を合計します。
km、mi、nmの違いは何ですか?
km = キロメートル (1 km = 1000 メートル)。 mi = 法定マイル (1 mi = 1.609 km)。 nm = 海里 (1 nm = 1.852 km)。 海里は航空および海上ナビゲーションの標準です。
このエンドポイントは外部マッピング サービスを呼び出しますか?
いいえ。Haversine 計算は、外部 API 呼び出しを行わずに完全にサーバー上で実行されます。 これは、追加の遅延がゼロであり、サードパーティのレート制限がないことを意味します。

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs