Arrêts avec services le long de l'itinéraire

Les conducteurs de véhicules électriques aiment souvent choisir eux-mêmes leurs lieux de recharge en fonction des services disponibles à proximité.

La requête getRouteStationsWithAmenities renvoie les bornes de recharge situées le long d’un itinéraire existant et à distance de marche de certaines catégories de services, tout en indiquant pour chaque borne le nom des services à proximité. Les conducteurs peuvent ainsi organiser leur arrêt de recharge autour d’un service précis, comme leur chaîne de restaurants préférée ou un café avec terrasse.

Fonctionnement

L’ajout d’un arrêt avec services à un itinéraire se fait en quatre étapes :

1. Créer un itinéraire.Demandez un itinéraire avec createRoute.
2. Sélectionner une option d’itinéraire.Choisissez l’une des options d’itinéraire renvoyées par l’abonnement route ou la requête getRoute.
3. Rechercher des bornes avec services.Transmettez à getRouteStationsWithAmenities l’option d’itinéraire choisie en tant que route_id et l’identifiant de demande d’itinéraire renvoyé par createRoute en tant que route_request_id, ainsi que le amenity_type recherché et un time_window qui définit jusqu’où chercher dans le trajet. Vous obtiendrez une liste de bornes compatibles le long de l’itinéraire, chacune accompagnée des services précis situés à proximité.
4. Recalculer l’itinéraire avec la borne sélectionnée.Une fois que le conducteur a choisi la borne, appelez à nouveau createRoute et ajoutez la borne à l’entrée via comme arrêt de recharge à l’aide de via.properties.station.station_id. Consultez Itinéraire avec arrêts pour en savoir plus sur ce fonctionnement.

Sélection des bornes

Une borne n’est incluse dans les résultats que si elle remplit tous les critères suivants :

Si aucune borne ne remplit tous les critères, essayez d’élargir la margin de votre fenêtre de temps ou d’assouplir vos filters.

Exemples

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          }        }      }    ]  })