Routing API Developer's Guide

Waypoints

You can use waypoints to define the locations on the map that the route must go through. A waypoint can be either a StopOver (for example, start or destination) or a PassThrough. A valid CalculateRoute request must include at least two StopOver Waypoints.

You specify waypoints with the waypoint parameter. The Routing API offers the following options to specify waypoints along a requested route:
  • The GeoWaypointParameterType type specifies a position with geocoordinates. You can specify an optional radius value to request a roughly located position.
  • The NavigationWaypointParameter type in combination with StreetPosition specifies a reference to a a particular street and its name.
  • The NavigationWaypointParameter type in combination with LinkPosition specifies an exact reference to a link. This option allows for even more precision by means of the Spot value which specifies the fractional distance between the link's reference-node and the non-reference node.

For more information on waypoints and examples, see WaypointParameterType.