Amenity stops along the route

EV drivers frequently like to hand pick charging locations based on specific nearby amenities.

The getRouteStationsWithAmenities query returns charging stations along an existing route that are within walking distance of specific amenity categories, while also listing for each station the nearby amenities by name. This lets drivers plan their charging stop around a specific amenity, like their favorite restaurant chain or a coffee place with outdoor area.

How it works

Adding an amenity stop to a route takes four steps:

1. Create a route.Request a route with createRoute.
2. Select a route option.Select one of the route options returned by the route subscription or getRoute query.
3. Search for stations with amenities.Pass the choosen route option as route_id and the route request id returned by createRoute as route_request_id to getRouteStationsWithAmenities, . You’ll get a list of compatible stations along the route, each with the specific amenity places nearby .
4. Recalculate the route with the selected station.Once the driver picks the station, call createRoute again and add the station to the via input as a charging stop using via.properties.station.station_id. See Route with stops for details on how this works.

How stations are selected

A station is included in the results only if it meets all of the following criteria:

If no stations meet all criteria, try widening your time window margin or relaxing your filters.

Examples

getRouteStationsWithAmenities(  input: {    route_id: "6527e1f1a8b4c2d3e4f5a6b7"    route_request_id: "6527e1f1a8b4c2d3e4f5a6b8"    amenity_type: coffee    time_window: { center: 3600, margin: 900 }  }) {  id  name  amenities {    type    name    distance  }}

{  "data": {    "getRouteStationsWithAmenities": [      {        "id": "5e5f3e8f8e0c1a0012345678",        "name": "Highway Charging Hub",        "amenities": [          {            "type": "coffee",            "name": "Roadside Coffee Bar",            "distance": 120          },           {            "type": "coffee",            "name": "Starbucks",            "distance": 500          }        ]      }    ]  }}

createRoute(  input: {    vehicle: { id: "607823b2c246f9001b97b1a2" }    origin: {      type: Feature      geometry: { type: Point, coordinates: [4.895168, 52.370216] }    }    destination: {      type: Feature      geometry: { type: Point, coordinates: [6.773456, 51.227741] }    }    via: [      {        type: Feature        properties: {          station: {            station_id: "5e5f3e8f8e0c1a0012345678"            stop_duration: 2700          }        }      }    ]  })