多地点巡回ルート検索(車)

/round_route_car [POST] [GET]

基本情報

概要

自動車を移動手段として、2地点間のルートを検索します。 /route_carよりも多くの経由地指定が可能です。

なお本APIはルート検索に時間を要する場合があるため、1回のルート検索につき2回のリクエストが必要になります。 1回目はPOST形式で検索リクエストを受け付け、2回目はGET形式で検索結果を返却します。

URL

https://{HOST}/{CID}/v1/round_route_car

※Rakuten RapidAPIでは提供しておりません

出力形式

  • JSON

対応言語

  • ja

パラメータ [POST]

パラメータは/route_carと同様です。

Content-Typeヘッダーにapplication/x-www-form-urlencodedを指定し、 リクエストボディにパラメータを指定して送信してください。

地点の JSON 表現

経由地の指定方法について

経由地指定の上限数は150地点です。
出発地点、到着地点は含みません。
150地点以上の経由地を指定するとエラーとなります。

レスポンス [POST]

名称 レスポンス名 型名 配列 説明
ルート検索ID processing_id 文字列 リクエストを受け付けたルート検索ごとに発行されるID

レスポンス例

{"processing_id": "8405511d33ebba6e122436b74cb6a215460609b6725b41a9d0ee0bf0b3f85ee9"}

パラメータ [GET]

パラメータ名 必須 概要 型名 デフォルト値 上下限/選択値 備考
processing_id ルート検索ID 文字列 POSTリクエストで取得したIDを指定してください

パラメータ構成例

/round_route_car?processing_id=8405511d33ebba6e122436b74cb6a215460609b6725b41a9d0ee0bf0b3f85ee9

レスポンス [GET]

ルート検索が正常に完了している場合、レスポンスは/route_carと同様です。

ルート検索が完了していない場合、POSTリクエストと同様のレスポンス「processing_id」を返却します。
5分程度時間をおいてから再度リクエストを実行してください。

 

検索結果はリクエスト実行後、24時間で削除されます。