ルートの計算

基本的なルートリクエストは origin、departure、および transportMode で構成されます。 結果の応答には、ルートのリストが含まれます。 ルートが存在しない場合、リストは空になっている可能性があります。

origin および destination は、緯度と経度のペアで、要求されたルートの始点と終点を表します。

transportMode ルートに使用するトランスポートモードを制御します。 pedestrian、 car、truck、bicycle および scooter は現在利用できます。

リクエストにalternativesが指定されている場合、レスポンスによって追加のルートが提供されることがあります。

リクエストで summary またはtravelSummary とともに returnが指定されている場合、セクションには長さや所要時間などの追加の概要情報が表示されます。

ルートには 1 つ以上のセクションが含まれます。

ルートが存在しない場合は、空のルートリストと通知が返されます。

curl -X GET \
  'https://router.hereapi.com/v8/routes?transportMode=car&origin=52.5308,13.3847&destination=52.5323,13.3789&return=summary&apikey={YOUR_API_KEY}'

{
  "routes": [
    {
      "id": "bfaed7d0-19c7-4e72-81b7-24eeb148b62b",
      "sections": [
        {
          "arrival": {
            "place": {
              "location": {
                "lat": 52.53232637420297,
                "lng": 13.378873988986016
              },
              "type": "place"
            },
            "time": "2019-12-09T16:05:05+01:00"
          },
          "departure": {
            "place": {
              "location": {
                "lat": 52.53098367713392,
                "lng": 13.384566977620125
              },
              "type": "place"
            },
            "time": "2019-12-09T16:03:02+01:00"
          },
          "id": "85357f8f-00ad-447e-a510-d8c02e0b264f",
          "summary": {
            "duration": 123,
            "length": 538
          },
          "transport": {
            "mode": "car"
          },
          "type": "vehicle"
        }
      ]
    }
  ]
}

中間のウェイポイントを使用したルート計算の詳細および例については、「中間のウェイポイントを経由したルート」を参照してください。 ルート計算の情報を指定する方法の詳細および例については、次を参照してください。

• 道路の正しい側のルート
• 道路名を希望の言語で取得します

指定したタイミングでのルート計算の詳細および例については、次の項を参照してください。

• 様々な時間帯でのルート案内の開始または終了
• 様々な時間帯でのルート案内の開始
• 様々な時間でのルート案内の終了