Begin route at different times

If your route request specifies neither the departureTime nor the arrivalTime parameter, the default departure time for a route is the time of the route request.

In your route request, you can use the departureTime parameter to specify a different departure time at which the route begins.

A different departureTime will have various effects ranging from different traffic impact to road closures.

If you specify departureTime as any, the route calculation will not take traffic flow and other time-dependent effects into account. Long-term closures (that is, current closures that last for more than a day) will still be considered. This can be useful when it is not certain that you're taking this route at a fixed time. departureTime=any is often referred to as "planning mode". Note that sending the same request with the parameter departureTime=any at different times may result in different responses.

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

{
  "routes": [
    {
      "id": "c133d37d-8a43-45ad-a3e2-851d0d4cf792",
      "sections": [
        {
          "arrival": {
            "place": {
              "location": {
                "lat": 52.53232637420297,
                "lng": 13.378873988986016
              },
              "type": "place"
            },
            "time": "2019-10-02T16:01:29+01:00"
          },
          "departure": {
            "place": {
              "location": {
                "lat": 52.53098367713392,
                "lng": 13.384566977620125
              },
              "type": "place"
            },
            "time": "2019-10-02T16:00:00+01:00"
          },
          "id": "0eb54d20-6c9b-4a40-be6a-de36de9330c7",
          "summary": {
            "duration": 89,
            "length": 538
          },
          "transport": {
            "mode": "car"
          },
          "type": "vehicle"
        }
      ]
    }
  ]
}