高速.jp - kosoku API (高速.jp ウェブサービス)
高速.jpでは、ウェブサービスとして、ルート検索API（kosoku API）を公開しています。
kosoku APIでは、高速道路の経路や料金を検索することができます。
kosoku APIを利用するウェブページでは、「kosoku API」または「高速.jp」を含む
アンカーテキストから、高速.jpのトップページへのリンクを入れてください。
kosoku APIへのアクセスは1リクエスト/秒までを目安としてください。
サービスに影響の出る過剰なアクセスは制限させていただく場合がありますのでご了承ください。
なお、API提供データをストックした上でのご利用はお断りしています。
商用利用、企業での利用については、事前にご連絡いただけると幸いです。
ルート検索API仕様
リクエストURL
http://kosoku.jp/api/route.php?パラメータ名=パラメータ値&...
リクエストパラメータ
各パラメータは、文字コードをUTF-8にし、URLエンコードを行なってください。
| 文字列検索パラメータ |
| パラメータ名 |
説明 |
| f |
出発IC名を指定します。 |
| t |
到着IC名を指定します。 |
| c |
車種を指定します。(デフォルト：普通車)
軽自動車等/普通車/中型車/大型車/特大車の五種類の指定ができます。
|
| s |
都道府県名を指定します。(省略可) |
| sortBy |
複数の経路があるときの、並べかえの順序を指定します。(デフォルト：距離)
距離/料金の二種類の指定ができます。
|
リターンパラメータ
ルートが確定しなかった場合
| Result |
|---|
| パラメータ名 | 説明 |
|---|
| Status | ルートが確定したかどうか(例："NotEnd") |
| From | 出発IC名 |
| To | 到着IC名 |
| CarType | 車種 |
| FromICs | 出発ICの候補群(別表参照) |
| ToICs | 到着ICの候補群(別表参照) |
| StateICs | 指定した都道府県内のIC群(別表参照) |
| FromICs/ToICs/StateICs |
|---|
| パラメータ名 | 説明 |
|---|
| No | 結果の個数 |
| IC | 名前 |
ルートが確定した場合
| Result |
|---|
| パラメータ名 | 説明 |
|---|
| Status | ルートが確定したかどうか(例："End") |
| From | 出発IC名 |
| To | 到着IC名 |
| CarType | 車種 |
| SortBy | 並び換えの順序("距離"/"料金") |
| Routes | 検索結果の経路群(別表参照) |
| Routes |
|---|
| パラメータ名 | 説明 |
|---|
| Route | 経路情報(複数)(別表参照) |
| Route |
|---|
| パラメータ名 | 説明 |
|---|
| RouteNo | 経路番号 |
| Summary | 検索結果の概要(別表参照) |
| Details | 検索結果の詳細(別表参照) |
| Summary |
|---|
| パラメータ名 | 説明 |
|---|
| TotalToll | 料金の合計 |
| TotalTime | 所要時間の合計(分) |
| TotalLength | 距離の合計 |
| Details |
|---|
| パラメータ名 | 説明 |
|---|
| No | 区間の個数 |
| Section | 区間の詳細(別表参照) |
| Section |
|---|
| パラメータ名 | 説明 |
|---|
| Order | 区間の順番 |
| From | その区間の出発IC名 |
| To | その区間の到着IC名 |
| Length | その区間の距離(km) |
| SubSections | その区間の詳細(別表参照) |
| Tolls | 料金(別表参照) |
| Time | 所要時間(分) |
| SubSections |
|---|
| パラメータ名 | 説明 |
|---|
| SubSection | 区間情報(複数)(別表参照) |
| SubSection |
|---|
| パラメータ名 | 説明 |
|---|
| From | 出発IC名 |
| To | 到着IC名 |
| Road | 道路名 |
| Length | 距離(km) |
| Time | 時間(分) |
| Tolls |
|---|
| パラメータ名 | 説明 |
|---|
| No | 料金の個数 |
| Toll | 料金詳細(例："700円 通常料金") |
サンプルリクエスト