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

ルートのリクエストで 、departureTime または arrivalTime パラメータを使用して、ルートが開始または終了する時間を指定できます。

ルートリクエストで、 パラメータdepartureTime もarrivalTimeも指定されていない場合 、ルートのデフォルトの出発時間（departureTime）はルートリクエストの時間になります。 departureTime=any 「計画モード」と呼ばれることがあり、ルートの出発時間または到着時間が事前に不明な場合に役立ちます。 パラメータを使用して同じリクエストを departureTime=any 異なる時間に送信すると、応答が異なる場合があります。

ルートリクエストでは、departureTimeまたはarrivalTimeのいずれかを使用できますが、両方を使用することはできません。

次のサンプルでは、 2021-09-03T08:30:25+02:00のdepartureTimeを指定しています。

curl -X GET \
  'https://router.hereapi.com/v8/routes?transportMode=car&origin=52.5308,13.3847&destination=52.5323,13.3789&return=summary&departureTime=2021-09-03T08:30:25+02:00&apikey={YOUR_API_KEY}'

{
  "routes" : [
    {
      "id":"f7d8121b-0577-47ca-b234-937b4bfd5d8d",
      "sections":[
        {
          "id":"feba5001-3e85-40a0-9045-e4c4637f36ab",
          "type":"vehicle",
          "departure":{
            "time":"2021-09-03T08:30:25+02:00",
            "place":{
              "type":"place",
              "location":{
                "lat":52.5309838,
                "lng":13.3845671
              },
              "originalLocation":{
                "lat":52.5307999,
                "lng":13.3847
              }
            }
          },
          "arrival":{
            "time":"2021-09-03T08:32:33+02:00",
            "place":{
              "type":"place",
              "location":{
                "lat":52.5323264,
                "lng":13.378874
              },
              "originalLocation":{
                "lat":52.5323,
                "lng":13.3789
              }
            }
          },
          "summary":{
            "duration":128,
            "length":539,
            "baseDuration":73
          },
          "transport":{
            "mode":"car"
          }
        }
      ]
    }
  ]
}