Maps

The MOIA Fleet API contains a MapService to query the road network used for routing. The primary use case is to find potential pick-up or drop-off locations for a customer.

Maps Objects

Stoppable Location

A location on the road where an AD vehicle can stop to pick up or drop off passengers, the direction from which the vehicle would approach this location (in degrees from true north), and the distance from the request origin (as the crow flies).

{
  "vehicle_location": { 
    "latitude": 53.574107, 
    "longitude": 10.026559,
    "heading": 56.0
  },
  "distance_meters": 9.21
}

Maps Functionality

Find potential pick-up and/or drop-off locations

A call to ListStoppableLocations with the customer’s current location and a reasonable radius (e.g. 100 meters) returns all possible pickup or drop-off locations where the vehicle and customer can be sent to meet. All results are checked against internal pick-up/drop-off zones to ensure no problematic locations are returned (e.g. in the middle of an intersection).

The heading is provided to determine the direction from which the vehicle will approach the location. This is particularly useful when using different map providers, as the same location may be slightly offset on both maps. One location may appear to be right on the road, but off the road on another map.

If there are no results, The radius should be increased. A maximum of one stoppable location is returned per road segment (not per street). The results are guaranteed to be sorted by distance to the starting point.