Routing API Developer's Guide

Requesting Multiple Routes With Labels

In order to be able to differentiate the routes when requesting for alternatives, the labelling option was introduced. By switching on the route attribute labels a set of labels for the requested routes are returned.

The following example shows a request with labels, where 2 alternatives are requested.
https://route.cit.api.here.com/routing/7.2/calculateroute.json
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&waypoint0=geo!52.513343,13.356054
&waypoint1=geo!50.088478,14.432714
&mode=fastest;car;traffic:disabled
&alternatives=2
&routeattributes=labels
Figure 1. The route response for the request with labels in the example above.
The labels can be displayed in an Overview panel. An example of such panel is shown below.
Figure 2. Example of response with alternatives, where label information is shown in the Overview panel.
In the JSON response, the label information is serialized for each route, as follows:
route:[
  {
    waypoint: [...],
    mode: {...},
    shape: [...],
    leg: [...],
    summary: {...},
    maneuverGroup: [...],
    label: [
      "A2",
      "A1"
    ]
  }
]