Routing API Developer's Guide


A matrix entry provides summary information for the route between waypoints indicated by indices of the start point and the destination. In cases of calculation failure the summary is replaced with a status field.

RouteMatrixEntryType defines the following attributes:

Element Description
StartIndex xs:int

Index to identify the start point of the route in the list of starting positions.

DestinationIndex xs:int

Index to identify the destination point of the route in the list of destinations.

Summary RouteSummaryType

Route summary for this matrix entry. In the CalculateMatrix response, depending on summaryAttributes parameter, it may include fields CostFactor, Distance and TravelTime. The CalculateMatrix response does not provide other RouteSummaryType attributes.

The summary is included in the response only if route calculation succeeds.

Status RouteStatusType

Status rangeExceeded indicates that a route calculation was aborted due to the exceeded search range specified in the request.

Status failed indicates that a route calculation failed due to invalid or non-reachable destination waypoint.

Status field is not present if route calculation succeeds.

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