ForHosting KIT · 旅行・地理

2ルート比較

Q: ライブ交通や地図距離を取得しますか？

いいえ。 距離と平均速度はご自身で指定します。ライブ地図・通行料・給油単価の単位変換は別ツールで、本機能は算術入力から時間と燃料費だけを比較します。

ルートAは120キロを時速60キロで2時間、燃料費は14です。ルートBは100キロを時速45キロで、燃料は少なく済みますが時間はかかります。同じ車と燃料単価で比べられます。ブラウザで無料で使えます。

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

無料で実行 API仕様を見る

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

計算例

入力した場合

距離 A: 120
平均速度 A: 60
距離 B: 100
平均速度 B: 45
燃費: 30
燃料価格: 3.5

結果

所要時間 A (時間): 2
必要燃料 A: 4
燃料費 A: 14
所要時間 B (時間): 2.2222222222

2本の運転ルートを選ぶとき、地図上で短く見える線だけで決まることはほとんどありません。平均速度が高ければ長い高速道路が時計では勝ち、短い市街地の近道でも渋滞のストップ・アンド・ゴーで燃料と時間を多く使うことがあります。この2ルート比較計算機は、ルートAとルートBそれぞれの距離と平均速度から純粋な運転時間と燃料費を見積もり、公平な比較のため共通の燃費と燃料単価を使います。両方の時間と費用、差分（BマイナスA）、どちらが速くどちらが安いかのラベルが得られます。

各オプションの所要時間と燃料費の計算方法

速度が距離単位毎時（マイルならmph、キロメートルならkm/h）で表されるとき、運転時間（時間）は距離を平均速度で割った値です。燃費が燃料単位あたりの距離（mpgやkm/Lなど）で表されるとき、燃料量は距離を燃費で割った値です。燃料費はその量に燃料1単位の価格を掛けたものです。

両ルートに同じ燃費と価格を使うことで、車や給油所の変更ではなく形状と速度だけを切り分けます。6入力すべてで単位を揃えてください。変換せずマイルとkm/hを混ぜないでください。

大きさの上限によりWorker isolate上で結果が有限に保たれます。

ルート選びでの使い方と限界

休暇計画・授業デモ・表計算なしの回廊選択には、無料のブラウザ2ルート時間・費用計算機を使います。1経路だけでよいときは単一路線の燃料費推定と、休憩が第二形状より重要なときはロードトリップ時間計算機と組み合わせてください。複数区間の行程ではセグメント対をクライアント側で比較し、分岐ごとに監査可能に保ちます。

入力源は他のKIT parse項目と同じ保持規則に従い、アルゴリズムが完全に決定的なため結果はCIフィクスチャに固定して安全です。GPSが2案を出すとき運転者が測るのと同じトレードオフです。

活用例

高速道路と景勝・市街地ルートの対比

運転者は平均速度の高い長い高速道路と、短く遅い市街地ルートを入力し、どちらが時計時間を節約し、どちらが燃料代を抑えるかを確認します。

フリート・物流の回廊選択

配車ツールは同一車両燃費と軽油価格で2本の合法経路を比較し、トラック割当前にETAと燃料支出で順位付けします。

通勤のA/B計画

通勤者は有料の多い急行回廊と無料の一般道を典型速度で比較し、時間短縮が余分な距離と燃料に見合うかを判断します。

よくある質問

短いルートは常に燃料費が安いですか？

平均速度が十分高ければ時間では長いルートが勝つこともあります。渋滞や停車はご指定の速度にのみ反映されます。

ライブ交通や地図距離を取得しますか？

いいえ。距離と平均速度はご自身で指定します。ライブ地図・通行料・給油単価の単位変換は別ツールで、本機能は算術入力から時間と燃料費だけを比較します。

2つのルートで燃費と燃料単価が共通なのはなぜですか？

公平に比べるためです。同じ車、同じ給油価格で計算するので、違いは距離と速度だけから生まれ、ルートそのものの影響が分かります。

ルート間の差はどう読めばよいですか？

差はすべてルートBからルートAを引いた値です。時間の差がプラスならBのほうが長く、燃料費の差がプラスならBのほうが高くなります。マイナスならBが速いか安いという意味です。

各ルートの平均速度には何を入れればよいですか？

制限速度ではなく、実測または普段の平均速度を入れます。信号、坂、工事で実際の進み方は遅くなるため、制限速度では速すぎる見積もりになります。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/travel/route-comparison

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

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

curl -X POST https://api.kit.forhosting.com/travel/route-comparison \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"distance_a":120,"average_speed_a":60,"distance_b":100,"average_speed_b":45,"fuel_economy":30,"fuel_price":3.5}'

const res = await fetch("https://api.kit.forhosting.com/travel/route-comparison", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "distance_a": 120,
    "average_speed_a": 60,
    "distance_b": 100,
    "average_speed_b": 45,
    "fuel_economy": 30,
    "fuel_price": 3.5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/travel/route-comparison",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "distance_a": 120,
    "average_speed_a": 60,
    "distance_b": 100,
    "average_speed_b": 45,
    "fuel_economy": 30,
    "fuel_price": 3.5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel/route-comparison", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"distance_a":120,"average_speed_a":60,"distance_b":100,"average_speed_b":45,"fuel_economy":30,"fuel_price":3.5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"distance_a":120,"average_speed_a":60,"distance_b":100,"average_speed_b":45,"fuel_economy":30,"fuel_price":3.5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel/route-comparison", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "distance_a": 120,
  "average_speed_a": 60,
  "distance_b": 100,
  "average_speed_b": 45,
  "fuel_economy": 30,
  "fuel_price": 3.5
}

レスポンス例

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

技術的な注記

各オプションの所要時間と燃料費の計算方法

必須フィールド distance_a、average_speed_a、distance_b、average_speed_b、fuel_economy、fuel_price をJSONの数値または数値文字列として送ってください。エイリアス dist_a、route_a_distance、da は distance_a に、speed_a、avg_speed_a、va は average_speed_a に対応し、ルートBも同様です。economy、mpg、km_per_l、efficiency は fuel_economy に、price、gas_price、fuel_unit_price は fuel_price に対応します。正でない距離・平均速度・燃費は invalid_input として拒否され、エンジンはゼロ除算や負の行程を作りません。負の fuel_price も無効です。同一入力は常に同一JSONを返し、純算術のみで、ネットワーク・乱数シード・壁時計は使いません。

比較フィールドの読み方と現実的な入力の選び方

各回廊の実測または典型的な平均速度を優先してください。信号・坂・工事で進みが落ちるとき、標識制限速度は実態を過大評価します。成功時の応答は、安定した丸め後の6入力に加え、ルートAの time_hours_a・fuel_needed_a・fuel_cost_a とルートBの対応する3項目を返します。time_diff_hours と fuel_cost_diff はルートBマイナスAです。正の time_diff_hours はBがより長い時間、正の fuel_cost_diff はBの燃料費が高いことを意味します。faster_route と cheaper_route は、丸め後に時間や費用が一致する場合を含め a・b・tie のいずれかです。予約枠・通学・配送SLAを重視するなら時間フィールドを、休暇ドライブの予算・燃料のみの精算・有料なしの遠回りと渋滞の近道の比較には費用フィールドを使います。本エンドポイントは標高・天候・ライブ渋滞・休憩をモデル化せず、ルーティングエンジンではなく透明な算術比較です。通貨は fuel_price に使う単位そのものです。必須欠落・非有限値・正でない距離・速度・燃費は invalid_input で失敗し、エンジン拒否後は課金されません。

APIの使い方・料金・旅行ワークフローと実用上の制限

distance_a、average_speed_a、distance_b、average_speed_b、fuel_economy、fuel_price（または文書化されたエイリアス）を含むJSON本体を送ってください。旅行ポータル・フリートダッシュボード・物流ツール・通勤アプリが安定契約を必要とする場合は、成功1件あたり$0.002のKIT残高でプリペイドAPIを使い、検証失敗は残高を消費しません。SDK作者は faster_route と cheaper_route をUIバッジに写し、時間と費用を並べて示せます。

技術的な質問

所要時間と燃料費で2本の運転ルートをどう比較しますか？

ルートAとBの距離と平均速度、共有の fuel_economy（燃料単位あたり距離）と fuel_price を送ってください。応答には両ルートの時間と費用、差分（BマイナスA）、faster_route、cheaper_route が含まれます。

距離・速度・燃費がゼロまたは負の場合はどうなりますか？

リクエストは invalid_input で失敗します。正でない distance・average_speed・fuel_economy は拒否され、エンジンはゼロ除算や無意味な比較を返しません。

2ルート比較計算機は無料ですか？

ブラウザツールは端末上で無料です。API呼び出しは成功1件あたり$0.002のプリペイドKIT残高を使い、検証失敗は課金されません。

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

2ルート比較

無料で実行

計算例

各オプションの所要時間と燃料費の計算方法

ルート選びでの使い方と限界

活用例

高速道路と景勝・市街地ルートの対比

フリート・物流の回廊選択

通勤のA/B計画

よくある質問

関連ツール

開発者向け — APIアクセス

エンドポイント

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

リクエスト例

レスポンス例

料金

エラー

技術的な注記

各オプションの所要時間と燃料費の計算方法

比較フィールドの読み方と現実的な入力の選び方

APIの使い方・料金・旅行ワークフローと実用上の制限

技術的な質問

ありがとう