Routing API Developer's Guide


A Route describes a distinct path through the navigable road network between two or more waypoints. It consists of route legs, each of which is a path between two waypoints.

Figure 1. RouteType

RouteType defines the following attributes:

Element Description
RouteId xs:string

Permanent unique identifier of the route, generated based on route links. Can be used to reproduce any previously calculated route.

If a RouteId is requested, but fails to be calculated for any reason (e.g. public transport enabled), then the RouteId element is not available in the response. The rest of the route is intact.

Waypoint WaypointType

List of waypoints that have been defined when requesting for a route calculation. The first waypoint is defined as the start of the route; the last waypoint marks the destination. Any points in between the two are considered via points.

Mode RoutingModeType

Settings for route calculation. One mode can be specified for each route.

Shape GeoPolylineType

Shape of the route as a polyline. The accuracy might depend on the resolution specified in mpp (meters per pixel) when requesting the route. In some use cases (like web portals), only the route's shape is required without the nested structure of a route and detailed knowledge of the links and LinkIds. In this case, the shape does not need to be acquired by traversing the route's links, but can be represented using this attribute at route level.

BoundingBox GeoBoundingBoxType

Bounding Box of the route.

Leg RouteLegType

Partition of the route into legs between the different waypoints.

PublicTransportLine PublicTransportLineType

List of all public transport lines which are used by public transport links and maneuvers of the route.

PublicTransportTickets PublicTransportTicketsType

For public transport routes, a list of ticketing options for the provided route. Each option is a list of tickets covering those parts of the route for which ticketing information is supported.

Note RouteNoteType

Notes that are either related to the calculation (violated routing options) or that refer the route as a whole. In addition to these notes additional notes can be attached to maneuvers. The maneuver notes are usually related to the route segment following the maneuver and would be of interest when passing this segment.

Summary RouteSummaryType

Overall route distance and time summary.

SummaryByCountry RouteSummaryByCountryType

Route distance and time summary per traversed country.

Generalizations Enumeration Types

A simplified base polyline with a given tolerance parameter used to reduce the number of points. The points in the base polyline are implicitly referenced by index.

ManueverGroup ManeuverGroupType

Maneuvers organized into sections based on TransportModeType. It provides the user grouped itinerary summary and brief route instructions.

Incident IncidentType

An incident describes a temporary event on a route. It typically refers to a real world incident (accident, road construction, etc.) spanning on one or several subsequent links.

Label xs:string

Unique names within a route used to distinguish between alternative routes. They can be city names, road names or something else that makes the distinction possible.

Zone RoutingZoneType

A list of routing zones crossed by the route.