Routing API Developer's Guide

Requesting a Time Aware Route for a High Occupancy Vehicle

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 we request the fastest route for a carHOV that goes through a part of the Interstate 66 which is HOV-2 only westbound from 4:00 to 6:30 p.m.

https://route.cit.api.here.com/routing/7.2/calculateroute.json
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&mode=fastest;carHOV;
&waypoint0=geo!38.892187,-77.048850
&waypoint1=geo!38.901885,-77.197964
&departure=2014-03-12T16:00:00
&routeattributes=sh,bb,gr

The query will result in a route using the High Occupancy Vehicle (HOV) lane restricted Interstate 66.

Figure 1. Example of HOV restricted road usage.

On the other hand if the user specifies car instead of carHOV as the transport mode the resulting route will avoid the HOV-2 road during the forbidden period.

Figure 2. Example of HOV restricted road avoidance.