Routing API Developer's Guide

Requesting a Time Aware Route

To calculate directions that take into account time dependent restrictions , use the CalculateRouteRequest service specifying the start (waypoint0), the destination (waypoint1), and the departure time. Note that you also have to specify an app_id and app_code (see Acquiring Credentials ), type of route calculation and whether to take traffic into account.

In the following example the fastest route for a car in the presence of a restricted left turn from 3pm to 6pm is requested outside of the restricted time.

https://route.cit.api.here.com/routing/7.2/calculateroute.json
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&mode=fastest;car;
&waypoint0=geo!37.743385,-122.422835
&waypoint1=geo!37.743878,-122.423686
&departure=2014-03-12T10:00:00
&routeattributes=sh,bb,gr
Figure 1. Example of allowed time restricted maneuver.

If the departure time is set to 2014-03-12T16:00:00, which is inside the forbidden period, the route will instead avoid the maneuver.

Figure 2. Example of time restricted maneuver.