Visualiser l'autonomie d'un véhicule

Une isoline montre la zone qu’un EV peut atteindre depuis un point donné avec l’énergie dont il dispose à bord. Elle répond à une question simple, jusqu’où ce véhicule peut-il aller depuis ici, et dessine la réponse sous forme de formes que vous pouvez placer sur une carte.

Les usages typiques sont une carte d’autonomie autour d’une ville, une vérification du type « puis-je y arriver sans recharger ? », ou un filtre qui n’affiche que les stations qu’un véhicule peut réellement atteindre.

Une isoline s’appuie sur le réseau routier réel comme référence. Le calcul détermine les points les plus éloignés que le véhicule peut atteindre par la route, et le contour relie ces points entre eux. Le résultat est une zone remplie, et non une ligne qui suit les routes ; les espaces entre les routes, comme les forêts ou les champs, peuvent donc s’y trouver. Les rivières, les montagnes, les systèmes à sens unique et les lacunes du réseau façonnent tout de même le contour, car ils déterminent jusqu’où les routes permettent au véhicule d’aller.

Fonctionnement

Comme les itinéraires, les isolines sont calculées de manière asynchrone, selon le même modèle asynchrone que celui utilisé dans toute l’API. La création et la récupération d’une isoline se font en deux étapes distinctes.

1. Créer une isolineAppelez la mutation createIsoline avec au minimum un vehicle_id et une origin. La mutation renvoie immédiatement un id d’isoline, que vous utiliserez à l’étape suivante. Les paramètres facultatifs, comme le niveau de batterie ou la météo, sont présentés dans personnaliser votre isoline.
2. Ouvrir un abonnementAbonnez-vous à la subscription isoline en utilisant l’id de l’étape précédente. Pendant le calcul de l’isoline, le statut est pending. Utilisez-le pour piloter un état de chargement dans votre interface.
3. Afficher le résultatLorsque le status passe à done ou error, affichez l’interface correspondante. Une isoline done contient les polygons à dessiner sur la carte.
4. Récupérer à la demandeUne isoline terminée est stockée avec tous ses détails. Pour l’afficher à nouveau plus tard, utilisez la requête isoline avec le même id plutôt que d’ouvrir un nouvel abonnement.

Polygones

Le résultat est une liste de polygones. Ensemble, ils décrivent la zone atteignable par paliers, depuis la proximité de l’origine jusqu’au point le plus éloigné que le véhicule peut atteindre.

Utilisez polygon_count pour choisir le nombre de polygones obtenus, jusqu’à un maximum de 20.

• Moins de polygones vous donnent une image simple et approximative de l’autonomie du véhicule. Ils sont plus rapides à dessiner et plus faciles à lire d’un coup d’œil.
• Plus de polygones vous donnent des paliers plus fins entre l’origine et l’autonomie maximale, ce qui est utile pour un dégradé ou une carte d’autonomie plus détaillée.

Chaque polygone possède un index dans ses properties pour les distinguer, et maximum_distance indique la distance entre l’origine et le point atteignable le plus éloigné.

Créer votre première isoline

Un vehicle_id et une origin suffisent pour créer une isoline. Cet exemple définit également le niveau de batterie, le nombre de polygones et la météo, afin que vous voyiez comment les principales options s’articulent.

mutation CreateIsoline {  createIsoline(    input: {      vehicle_id: "607823b2c246f9001b97b1a2"      origin: {        type: Feature        geometry: { type: Point, coordinates: [4.895168, 52.370216] }      }      state_of_charge: { value: 80, type: percentage }      polygon_count: 5      weather: { type: winter }    }  )}

La mutation renvoie l’id de l’isoline. Transmettez-le à la subscription isoline pour suivre le calcul et recevoir le résultat :

subscription Isoline {  isoline(id: "65f1a2b3c4d5e6f7a8b9c0d1") {    id    status    maximum_distance    polygons {      properties {        index      }      geometry {        type        coordinates      }    }  }}

Dans cette requête :

• state_of_charge démarre le véhicule avec 80 % de batterie. Sans ce paramètre, l’isoline utilise la capacité de batterie utilisable complète du véhicule.
• polygon_count renvoie cinq polygones, depuis la proximité de l’origine jusqu’à l’autonomie maximale.
• weather utilise le préréglage winter, qui suppose des conditions froides et donne généralement une zone atteignable plus petite que la valeur par défaut, la météo en temps réel.

Personnaliser votre isoline

createIsoline accepte une série de paramètres facultatifs pour affiner le calcul. Vous trouverez plus de détails sur chaque champ dans la référence de l’API.