Traffic in routing

Time aware route calculation can take various time-dependent information into account, such as live traffic conditions, historical traffic patterns, and time-dependent restrictions.

Time aware route calculation is activated when either departureTime or arrivalTime is set to a specific time instance (not any), or neither of them is specified. When neither departureTime nor arrivalTime is specified the default departure time for a route is the time of the route request. Traffic is enabled by default in time aware route calculations.

A different departureTime or arrivalTime will have various effects ranging from different traffic impact (both live and historical), to road closures. For details about these parameters and their usage refer to Time-dependent routing or the API reference.

To disable time aware route calculation, specify departureTime=any. This is referred to as "planning mode", because it's used to plan routes when you don't have a specific departure or arrival time. In this case the route calculation will not take any time-dependent information into account, with the exception of long-term closures. Long-term closures (that is, current closures that last for more than a day) will still be considered. To disable long-term closures use traffic[mode]=disabled. Using traffic[mode]=disabled disables all traffic related information even when departureTime or arrivalTime is specified.

Examples:

• To get traffic incidents along the route, see Get traffic incidents in route spans.
• For traffic's effect on travel duration and fuel consumption, see Calculate fuel consumption and carbon dioxide emission.
• To get notifications of time dependent restrictions, see Time-dependent restrictions.
• To get travel duration typical for a time of day, see Duration, baseDuration, typicalDuration, mlDuration.

📘

Note

The following features don't support the arrivalTime parameter:

• EV routing in HERE Routing API v8
• What is a route handle
• How to import a route from traces
• Driver schedule