道順 API
道順 API バージョン
このドキュメントは道順 API の v5
バージョンに対応しています。以前のバージョンについては、v4
ドキュメント もしくはチェンジログを参照してください。
Mapbox 道順 API は目的地までの行き方を示します。道順 API を使用すると以下のことができます:
- 交通とインシデントを考慮したルーティングで、運転、歩行、自転車の最適なルートを計算
- ターンバイターンの指示を生成
driving
、driving-traffic
、walking
、cycling
プロファイルで最大25座標のルートを生成- 電気自動車が最適な充電停止とバッテリー予測を伴って目的地に到達するためのルートを計算
PLAYGROUND
道順 API プレイグラウンド
ウェイポイント間の道順を取得し、地図上で結果を表示します。
TUTORIAL
道順 API チュートリアル
道順 API に関連するすべてのチュートリアルを見るには、チュートリアルページの 製品 フィルタを使用してください。
ルーティング プロファイル
道順 API は異なる 4 種類のルーティングプロファイルをサポートします:
プロファイル | 説明 |
---|---|
mapbox/driving-traffic | 自動車のルーティング用。このプロファイルは現在および過去の交通状況を考慮して遅延を避けます。サポートされている地理情報については、交通データページ を参照してください。このプロファイルを使用するリクエストは最大 25 座標を受け入れます。 |
mapbox/driving | 自動車のルーティング用。このプロファイルは高速道路などの高速道路を優先して最速のルートを表示します。このプロファイルを使用するリクエストは最大 25 座標を受け入れます。 |
mapbox/walking | 歩行者およびハイキングのルーティング用。このプロファイルは歩道やトレイルを使用して最短パスを表示します。このプロファイルを使用するリクエストは最大 25 座標を受け入れます。 |
mapbox/cycling | 自転車のルーティング用。このプロファイルは短くて安全なルートを示し、高速道路を避け、自転車レーンのある道路を優先します。このプロファイルを使用するリクエストは最大 25 座標を受け入れます。 |
道順を取得する
get
https://api.mapbox.com/directions/v5/{profile}/{coordinates}
必須パラメータ
ウェイポイント間の道順を取得します。道順リクエストには、少なくとも 2 つのウェイポイントを開始点および終了点として指定する必要があります。
必須パラメータ | 種類 | 説明 |
---|---|---|
profile | string | 使用する ルーティングプロファイル。可能な値は mapbox/driving-traffic 、mapbox/driving 、mapbox/walking 、または mapbox/cycling です。 |
coordinates | number | 訪れる順序で 2 から 25 の {経度},{緯度} 座標ペアのセミコロン区切りのリスト。 |