Routing API Developer's Guide

Alternate Routes

If requested, the service can provide any available alternate routes. As timetable routing can provide accurate time information and estimated routing cannot, alternate routes are defined differently for each type of public transport routing:

In estimated routing, possible alternate routes are:

  • Geometrically different from the original route
  • Via different transport types
  • Not significantly different from the original route in estimated time of arrival.

In timetable routing, possible alternate routes can be:

  • Scheduled at different times
  • Via different transport types
  • Geometrically different, if not significantly different from the original route in estimated time of arrival.
Note: As timetable information is highly dynamic, we cannot give any particular guarantees on the number of and contents of alternate routes.

Requesting Alternate Routes

To request multiple alternate routes in the response, set the alternatives request parameter to the number of additional routes that the service should return. For example, if you specify alternatives=3 in the request, the service can return up to 4 routes in the response: the original route and three alternates. Note that the alternatives parameter specifies maximum number of additional routes returned. For any route, the service may or may not find admissible alternates, so it is possible that even with several alternates requested, the response will contain only one route.

Alternate Route Ordering

Public transport alternatives are ordered by estimated preference. Simply, if no alternatives are requested, the best possible route is returned. Public transport routing algorithms take into account several criteria for estimating preference of resulting alternatives. Among these:
  • Route departure and arrival time
  • Duration of the trip
  • Number of transfers (changes) involved
  • Amount of walking distance involved
  • User preferences (if specified in the request)

In addition to public transport alternatives a walking only route might be returned. This happens when walking is preferred to public transportation or walking makes a viable alternative.

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on