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). It can be used as a destination when calculating a pedestrian route for the customer.

{
  "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 returns all possible pick-up or drop-off locations within a radius of a specific starting point. This point is likely to be determined by the customer. A maximum of one stoppable location is returned per road segment (not per street). If there are no results, the radius should be increased. The results are guaranteed to be sorted by distance to the starting point.

The heading is provided to determine the direction from which the vehicle is approaching 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.