ForHosting KIT · 開発者向けツール

経由地を通る迂回ルートの距離と超過分を計算

迂回ルートとは、出発地点から目的地点へ直接向かわず、1つの中間経由地を通る経路です。この計算機は2区間それぞれの大圏距離を求め、合計距離を算出して、両端を結ぶ直行大圏距離と比較します。迂回による負担を絶対距離と割合の両方で確認できます。道路地図やリアルタイム交通情報を使わず、再現可能な幾何学的基準が必要なルート計画、航空・海上距離の概算、物流分析などにご利用いただけます。

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

無料で実行 API仕様を見る

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

迂回ルート計算で分かること

経路は、出発地点から経由地までと、経由地から目的地点までの2区間で構成されます。各区間を球面上の最短弧として計算し、合計して迂回ルートの総距離を求めます。同時に、出発地点と目的地点を直接結ぶ大圏距離も計算します。総距離から直行距離を引いた値が超過距離であり、それを直行距離で割った値が超過率です。総距離は計画した幾何学的ルートの長さ、超過距離は経由地が追加する負担、超過率は規模の異なる経路を比較する指標になります。2区間を個別に表示するため、経由地による区間配分の偏りも確認できます。この方式は座標だけを使用し、交通網は参照しません。道路、飛行制限空域、海流、地形、時刻表、渋滞は含まれませんので、比較や候補選定の一貫した基準としてお使いください。詳細なナビゲーション距離を示すものではありません。

座標の入力方法と結果の読み方

出発地点、1つの経由地、目的地点について、緯度と経度を十進度で入力してください。緯度は-90から90、経度は-180から180の範囲です。緯度は南北位置、経度は東西位置を表すため、順序を取り違えないようご注意ください。入れ替えても有効な別地点になり、誤った結果が返る場合があります。距離単位はメートル、キロメートル、法定マイル、海里から選べ、全距離項目に同じ単位が適用されます。表示する小数桁数は内部計算を変えずに指定できます。既定ではIUGG平均地球半径6,371,008.8メートルを使いますが、別の正の半径も指定できます。直行弧は球面上の最短経路なので、超過距離が負にならないよう数値誤差を補正します。出発地点と目的地点が同一で、経由地により移動が生じる場合、割合の分母が0になるため`detour_percent`を省略します。ただし各区間、合計、絶対超過距離は返します。

計画や分析での活用方法

物流拠点、検問所、給油地点、積み替え港、検査場所などを必ず経由する移動の評価にご利用ください。物流では、高価な道路経路サービスを呼び出す前に、候補拠点を超過距離で比較できます。航空や海運では海里を選び、運航上の経由地が生む幾何学的影響を確認できますが、認可航路や天候によって距離がさらに増える点にご注意ください。複数案の超過率を算出し、たとえば十パーセントを超える案を規定違反として抽出することもできます。決定論的な応答なので、同じ入力から常に同じ項目が得られ、回帰テスト、表計算、監査記録にも適しています。APIリクエストの料金は$0.002で、ブラウザー版では対話的に確認できます。距離だけから所要時間や燃料を判断しないでください。速度、機体や車両、風、混雑、勾配、停止も影響します。返された区間距離を運用モデルへ渡すか、実際の交通網を使う経路計算前の透明な絞り込み指標としてお使いください。

活用例

配送拠点の比較

候補となる倉庫や積み替え拠点が、出発地と目的地の間に追加する距離を測定します。

必須チェックポイントの評価

検査、国境通過、整備停止が生む迂回を絶対距離と割合で定量化します。

航空・海上経由地の絞り込み

天候、空域、海流、航法制約を適用する前に、2区間を海里で算出します。

よくある質問

迂回ルートとは何ですか？

出発地点から1つの中間経由地を通り、目的地点へ至る2区間の経路です。

迂回の超過距離はどのように計算しますか？

2区間の合計から、出発地点と目的地点を結ぶ直行大圏距離を差し引きます。

道路距離や飛行計画距離を計算できますか？

いいえ。座標間の球面弧を計算し、道路、認可航路、地形、交通は含みません。

どの距離単位に対応していますか？

メートル（m）、キロメートル（km）、法定マイル（mi）、海里（nmi）を選択できます。

出発地点と目的地点が同じ場合はどうなりますか？

直行距離は0です。区間、合計、超過距離は返しますが、割合は有効な分母がある場合だけ返します。

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

成功したAPIリクエスト1件の料金は$0.002です。無効な入力は計算前に拒否されます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/geo/dogleg-distance

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

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

curl -X POST https://api.kit.forhosting.com/geo/dogleg-distance \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start_lat":40.7128,"start_lon":-74.006,"waypoint_lat":41.8781,"waypoint_lon":-87.6298,"end_lat":34.0522,"end_lon":-118.2437}'

const res = await fetch("https://api.kit.forhosting.com/geo/dogleg-distance", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "start_lat": 40.7128,
    "start_lon": -74.006,
    "waypoint_lat": 41.8781,
    "waypoint_lon": -87.6298,
    "end_lat": 34.0522,
    "end_lon": -118.2437
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/geo/dogleg-distance",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "start_lat": 40.7128,
    "start_lon": -74.006,
    "waypoint_lat": 41.8781,
    "waypoint_lon": -87.6298,
    "end_lat": 34.0522,
    "end_lon": -118.2437
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/geo/dogleg-distance", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"start_lat":40.7128,"start_lon":-74.006,"waypoint_lat":41.8781,"waypoint_lon":-87.6298,"end_lat":34.0522,"end_lon":-118.2437}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"start_lat":40.7128,"start_lon":-74.006,"waypoint_lat":41.8781,"waypoint_lon":-87.6298,"end_lat":34.0522,"end_lon":-118.2437}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/geo/dogleg-distance", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "start_lat": 40.7128,
  "start_lon": -74.006,
  "waypoint_lat": 41.8781,
  "waypoint_lon": -87.6298,
  "end_lat": 34.0522,
  "end_lon": -118.2437
}

レスポンス例

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