ForHosting KIT · 旅行・地理

複数経由ルート総距離

Q: GPS座標や住所は必要ですか？

不要です。 すでに持っている区間距離（地図、マニフェスト、見積もり）を渡してください。本ツールはジオコーディングせず、lat/lon から大圏経路も測りません。

ニューヨークからフィラデルフィアまで120 km、ワシントンまで140 km、リッチモンドまで110 kmなら総距離は370 kmで、累積は120、260、370 kmです。区間の距離を入れるだけで総距離と各地点の累積が分かります。ブラウザで無料で使えます。

無料
ブラウザで動作
登録不要
データは端末の外に出ません

無料で実行 API仕様を見る

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

計算例

入力した場合

出発地: New York

結果

合計: 370 km
合計 (km): 370
合計 (mi): 229.907341
区間数: 3

複数都市のロードトリップ、配送ツアー、複数ホテルの行程を計画するとき、まず手元にあるのは地図アプリや印刷ガイド、配車票など、すでに信頼している区間距離の一覧であることが多いです。それでもなお必要なのは、きれいな合計と、各経由点での累積走行距離の読み取りです。これがあれば給油・休憩・費用按分がぶれません。この複数経由ルート総距離計算機は、任意で目的地名を付けた区間距離の順序付きリストを受け取り、ルート合計に足し上げ、起点から最終経由点までのオドメーター式の累積表を組み立てます。キロメートルまたは法定マイルを選べます。

複数経由行程の距離と累積走行距離の仕組み

ここでの複数経由ルートは、1本以上の区間からなる順序付きの開いた行程です。各区間は、連続する経由点のあいだで既に測定または推定した非負の距離です（都市間、デポから顧客、ホテル間など）。この能力は座標を照会せず、道路経路を捏造しません。

距離を真実の情報源として扱い、計画者が実際に再利用する帳簿処理に集中します。n 本の区間があれば経由点は n に 1 を加えた数です。経由点ゼロは累積走行距離ゼロの起点で、各区間が完了するたびにランニング合計がその距離だけ進みます。

ルート総距離は全区間の単純な和です。この恒等式は、運転手が旅日誌にマイルポストを記すときのオドメーター論理と同じです。ゼロから始め、各セグメントを足し、最終経由点の読み取りが旅の合計と一致します。

各区間の任意ラベルはそのセグメントの目的地を名付け、任意の origin 文字列は最初の経由点を名付け、累積表をUIで二次結合なしに読めるようにします。単位がマイルのときは二重換算が逆方向に走ります。長さゼロの区間は許可されます（同一地点の停車やプレースホルダ）が、負の距離は拒否されます。

このモデルでは走行距離を後退させられないためです。

入力の仕方、単位、受け付けない値

各要素は必須の distance と任意の label を持つオブジェクトでも、ラベルなし距離として扱う単純な有限数でも構いません。距離は有限かつ非負である必要があります。任意の unit は入力と主合計の単位を選びます（既定 km、または mi）。

空の legs、500件超、未知の単位は合計前に検証失敗し課金されません。数値を換算せず unit だけ入れ替えるのはよくあるクライアント誤りです。表がマイルなら既定のままにせず unit mi を送ってください。

ブラウザの tier-A 経路は対話確認向けに無料です。

複数経由ルート合計が製品とパイプラインで果たす役割

地図エクスポートから都市間距離を貼るロードトリップ計画、燃料・費用モジュール前の複数配送スケッチ、走行距離付き行程表を出す旅行ブログ、オドメーター式進捗で停留リストを豊かにするフリートダッシュボード、実データでプレフィックス和を教える物流の授業などです。Worker、バックエンドジョブ、スクリプトから呼び出します。

費用見積もりには燃料量や旅行費用ツール、時間には平均速度や ETA ツールと組み合わせてください。緯度経度からの大圏距離には使わないでください。それは haversine 区間を測る地理ポリライン系の別検索意図です。

ここでは利用者が距離を既に持ち、行程合計と累積走行距離だけを求めます。検証失敗は残高を消費しません。対話UXではリストを控え、テストでは丸め済み合計を固定し、KIT が既に提供する各チャネル向けの小さく監査可能な部品を得られます。

活用例

ロードトリップ行程表

都市間の区間距離を貼り付け、各経由点にラベルを付け、ホテル宿泊ごとの合計距離と累積走行距離を公開します。

複数配送の進捗

デポから停留、停留間の長さを合算し、各区間完了後に残りマイルを運転手に示します。

旅行費用・燃料の前処理

既知の区間から単一の総距離を求め、燃料量・燃料費・旅行予算の計算機を呼ぶ前に使います。

よくある質問

複数経由ルート総距離はどう計算されますか？

各区間距離は有限の非負数として検証されたあと合算されます。経由点 k の累積走行距離は最初の k 区間の和で、起点はゼロからです。

GPS座標や住所は必要ですか？

不要です。すでに持っている区間距離（地図、マニフェスト、見積もり）を渡してください。本ツールはジオコーディングせず、lat/lon から大圏経路も測りません。

経由地に名前を付けられますか？

付けられます。各区間に到着地の名前を付けられ、出発地にも名前を付けられます。名前は累積表の見出しになるだけで、距離や合計は変わりません。

距離0の区間は入力できますか？

できます。同じ場所での停車や仮の行として、長さ0の区間も受け付けます。ただし、走行距離が逆戻りすることはないため、マイナスの距離は受け付けません。

区間はいくつまで入力できますか？

1区間から最大500区間まで入力できます。区間がn個なら経由地は出発地を含めてn+1か所になり、それぞれの累積距離が表に並びます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/travel/multi-stop-route-distance

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

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

curl -X POST https://api.kit.forhosting.com/travel/multi-stop-route-distance \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"legs":[{"distance":120,"label":"Philadelphia"},{"distance":140,"label":"Washington DC"},{"distance":110,"label":"Richmond"}]}'

const res = await fetch("https://api.kit.forhosting.com/travel/multi-stop-route-distance", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "legs": [
      {
        "distance": 120,
        "label": "Philadelphia"
      },
      {
        "distance": 140,
        "label": "Washington DC"
      },
      {
        "distance": 110,
        "label": "Richmond"
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/travel/multi-stop-route-distance",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "legs": [
        {
            "distance": 120,
            "label": "Philadelphia"
        },
        {
            "distance": 140,
            "label": "Washington DC"
        },
        {
            "distance": 110,
            "label": "Richmond"
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel/multi-stop-route-distance", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"legs":[{"distance":120,"label":"Philadelphia"},{"distance":140,"label":"Washington DC"},{"distance":110,"label":"Richmond"}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"legs":[{"distance":120,"label":"Philadelphia"},{"distance":140,"label":"Washington DC"},{"distance":110,"label":"Richmond"}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel/multi-stop-route-distance", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "legs": [
    {
      "distance": 120,
      "label": "Philadelphia"
    },
    {
      "distance": 140,
      "label": "Washington DC"
    },
    {
      "distance": 110,
      "label": "Richmond"
    }
  ]
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "travel.multi_stop_route_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`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

成功レスポンスには常に total_km と total_mi も含まれます。

複数経由行程の距離と累積走行距離の仕組み

単位がキロメートルのとき total と total_km は一致し、total_mi は法定マイルあたり 1.609344 キロメートルの国際係数で導出されます。

入力契約、単位、エイリアス、検証エラー

必須の legs 配列を少なくとも1件含む JSON 本体を POST してください。空文字、NaN、Infinity、欠損した distance は、行を明示した invalid_input で失敗します。配列は segments、stages、distances という転送エイリアスを受け付け、モバイルや表計算クライアントが列を再整形なしで写像できます。エイリアスに distance_unit があります。任意の origin（エイリアス start、start_label、origin_label）は経由点ゼロにラベルするだけで計算は変えません。成功ペイロードは total と unit、常に total_km と total_mi、leg_count と stop_count、区間インデックス・距離・その区間後の累積走行距離・任意 label の順序付き legs、起点から最終点までの stop インデックス・累積・任意 label の cumulative_at_stops、監査と文書用の formula と method 文字列を返します。料金は API の成功1件あたり定額 $0.002 です。

複数経由ルート合計が製品とパイプラインで果たす役割

区間距離がすでにあり、透明な合計と経由点ごとの累積走行距離が必要なときは、このエンドポイントを使ってください。legs を渡し、total と cumulative_at_stops を読み、必要なら legs の内訳を各UI行の横に保存します。モデルは固定丸めと公開されたキロ–マイル係数の純粋算術なので、オフラインで再計算して API とバイト一致できます。

技術的な質問

区間の最小数はいくつですか？

少なくとも1区間が必要です（起点と終点の2停留）。空リストは invalid_input を返し、課金されません。

1回のリクエストでキロメートルとマイルを混ぜられますか？

できません。すべての区間距離は unit の km または mi で同じ単位を共有する必要があります。応答には表示用に常に total_km と total_mi が含まれます。

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

成功した各リクエストは前払い ForHosting KIT 残高から $0.002 で課金されます。検証失敗は課金されません。ブラウザツールは無料です。

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

複数経由ルート総距離

無料で実行

計算例

複数経由行程の距離と累積走行距離の仕組み

入力の仕方、単位、受け付けない値

複数経由ルート合計が製品とパイプラインで果たす役割

活用例

ロードトリップ行程表

複数配送の進捗

旅行費用・燃料の前処理

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

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

リクエスト例

レスポンス例

料金

エラー

技術的な注記

複数経由行程の距離と累積走行距離の仕組み

入力契約、単位、エイリアス、検証エラー

複数経由ルート合計が製品とパイプラインで果たす役割

技術的な質問

ありがとう