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.
RouteType defines the following attributes:
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.
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.
Settings for route calculation. One mode can be specified for each route.
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.
Bounding Box of the route.
Partition of the route into legs between the different waypoints.
List of all public transport lines which are used by public transport links and maneuvers of the route.
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.
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.
Overall route distance and time summary.
Route distance and time summary per traversed country.
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.
Maneuvers organized into sections based on TransportModeType. It provides the user grouped itinerary summary and brief route instructions.
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.
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.