ForHosting KIT · 開発者向けツール

複数経由地ルートの総距離計算

複数の経由地を巡る移動では、隣り合う地点間の距離がすべてそろって初めて正確な総距離を求められます。この計算機は、指定された訪問順と地点ペアごとの既知の距離を受け取り、実際に通る区間だけを合計します。確認しやすい区間別の内訳と総距離を返し、必要な接続がなければ明確なエラーを表示します。ペアに方向はなく、1つの距離を往路と復路のどちらにも利用できます。

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

無料で実行 API仕様を見る

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

訪問順と利用可能な距離を入力します

まず、立ち寄る地点を正確な訪問順で配列に入力します。名称の前後の空白は除去されますが、大文字と小文字、名称内の空白は区別されるため、表記を統一してください。拠点へ戻る場合や同じ場所を再訪する場合は、同じ地点を複数回指定できます。次に、出発地点、到着地点、距離を含むレコードを用意します。各レコードは方向のないペアとして扱われるため、車庫から博物館までの値は博物館から車庫へ戻る場合にも使えます。距離は有限の0以上の数値で、すべて選択した単位にそろえる必要があります。km と mi が混在したもっともらしい誤合計を防ぐため、単位の個別変換は行いません。経路で使わないペアを追加しても問題なく、無視されます。そのため、距離表を再利用しながら訪問順だけを変更できます。同じペアに異なる値がある場合は、曖昧な値を自動選択せずリクエストを拒否します。

総距離の計算方法を確認します

計算は地点を左から右へたどり、隣り合う各ペアを1回ずつ処理します。車庫、博物館、ホテル、車庫という順番なら、必要な区間は車庫–博物館、博物館–ホテル、ホテル–車庫です。アルゴリズムは方向を問わず各ペアを検索し、その距離を累計へ加え、区間を結果へ記録します。地点の並べ替え、未指定地点の挿入、別地点を経由する代替経路の推定は行いません。これは指定順の合計機能であり、最短経路を探す最適化機能ではないため、入力された順番が常に優先されます。同じ名称が連続する場合は移動がないものとして距離0の区間になります。結果には総距離、単位、地点数、区間数、合計に使用した区間の順序付き一覧が含まれます。安定した精度処理で不要な浮動小数点誤差を抑えつつ、有用な小数桁は保持します。採用した値をすべて表示するため、元の距離表と直接照合できます。

不足データを運用前に解消します

総距離を返す前に、訪問順で連続するすべてのペアに距離があるか確認します。博物館–ホテルがなければ、その2地点を示してリクエストを拒否し、距離を0とみなしたり部分的な合計を返したりしません。この安全な動作は、配車、旅程、走行費の精算、配送計画など、過少な距離が予定や予算に影響する場面で役立ちます。示されたペアを追加して再送すれば、同じ決定的な入力から常に同じ結果が得られます。確認対象は実際に使う区間だけなので、経路と無関係な地点間の値がなくても問題ありません。距離は道路距離行列、計画表、実測区間など信頼できる情報源から用意できます。本機能は地図サービスへ接続せず、道路の現況、通行止め、有料道路、車両制限を判定できません。実際の運用判断に使う場合は、情報源の正確性と最新性を別途確認してください。

活用例

配送ルートを確認する

車庫と顧客間の既知の区間を配車順に合計し、出発前に不足する接続を検出します。

旅程の距離を集計する

準備済みの距離表から、観光地、ホテル、交通拠点を巡る予定順の総距離を求めます。

走行距離の計算を監査する

合計に含まれた区間を明示し、精算額や計画値を元の距離データと照合します。

よくある質問

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

API リクエスト1回につき $0.002 です。ブラウザー版はネットワーク接続なしでローカル実行できます。

最短ルートを検索できますか？

いいえ。指定された訪問順を維持し、その順番で連続する区間の距離を合計します。

地点ペアの距離に方向はありますか？

いいえ。A から B の値は B から A にも使います。同じペアの矛盾する重複値は拒否します。

必要な区間がない場合はどうなりますか？

距離が不足している連続2地点を示す入力エラーとなり、計算結果は返しません。

km と mi を混在させられますか？

いいえ。すべての距離を選択した単位に事前にそろえてください。単位は表示しますが個別変換はしません。

開発者向け — APIアクセス

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

エンドポイント

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

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

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

curl -X POST https://api.kit.forhosting.com/travel/route-stop-sequence-distance \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"stops":["Depot","Museum","Hotel","Depot"],"distances":[{"from":"Depot","to":"Museum","distance":4.8},{"from":"Museum","to":"Hotel","distance":3.25},{"from":"Hotel","to":"Depot","distance":6.1}]}'

const res = await fetch("https://api.kit.forhosting.com/travel/route-stop-sequence-distance", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "stops": [
      "Depot",
      "Museum",
      "Hotel",
      "Depot"
    ],
    "distances": [
      {
        "from": "Depot",
        "to": "Museum",
        "distance": 4.8
      },
      {
        "from": "Museum",
        "to": "Hotel",
        "distance": 3.25
      },
      {
        "from": "Hotel",
        "to": "Depot",
        "distance": 6.1
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/travel/route-stop-sequence-distance",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "stops": [
        "Depot",
        "Museum",
        "Hotel",
        "Depot"
    ],
    "distances": [
        {
            "from": "Depot",
            "to": "Museum",
            "distance": 4.8
        },
        {
            "from": "Museum",
            "to": "Hotel",
            "distance": 3.25
        },
        {
            "from": "Hotel",
            "to": "Depot",
            "distance": 6.1
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel/route-stop-sequence-distance", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"stops":["Depot","Museum","Hotel","Depot"],"distances":[{"from":"Depot","to":"Museum","distance":4.8},{"from":"Museum","to":"Hotel","distance":3.25},{"from":"Hotel","to":"Depot","distance":6.1}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"stops":["Depot","Museum","Hotel","Depot"],"distances":[{"from":"Depot","to":"Museum","distance":4.8},{"from":"Museum","to":"Hotel","distance":3.25},{"from":"Hotel","to":"Depot","distance":6.1}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel/route-stop-sequence-distance", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "stops": [
    "Depot",
    "Museum",
    "Hotel",
    "Depot"
  ],
  "distances": [
    {
      "from": "Depot",
      "to": "Museum",
      "distance": 4.8
    },
    {
      "from": "Museum",
      "to": "Hotel",
      "distance": 3.25
    },
    {
      "from": "Hotel",
      "to": "Depot",
      "distance": 6.1
    }
  ]
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "travel.route_stop_sequence_distance",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

料金

1リクエストあたり$0.002

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

制限

`max_stops`	500
`max_distances`	10000

エラー

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

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