Fahrzeugreichweite visualisieren

Eine Isoline zeigt das Gebiet, das ein EV von einem bestimmten Punkt aus mit der an Bord befindlichen Energie erreichen kann. Sie beantwortet eine einfache Frage, nämlich wie weit dieses Fahrzeug von hier aus kommt, und zeichnet die Antwort als Formen, die Sie auf einer Karte platzieren können.

Typische Anwendungen sind eine Reichweitenkarte rund um eine Stadt, eine Prüfung „Komme ich ohne Laden dorthin?“ oder ein Filter, der nur Stationen anzeigt, die ein Fahrzeug tatsächlich erreichen kann.

Eine Isoline nimmt das reale Straßennetz als Referenz. Die Berechnung ermittelt die am weitesten entfernten Punkte, die das Fahrzeug auf der Straße erreichen kann, und die Kontur verbindet diese Punkte miteinander. Das Ergebnis ist eine gefüllte Fläche und keine Linie, die Straßen folgt, sodass auch Bereiche zwischen Straßen, etwa Wälder oder Felder, darin liegen können. Flüsse, Berge, Einbahnstraßensysteme und Lücken im Netz prägen die Kontur dennoch, weil sie bestimmen, wie weit das Fahrzeug über die Straßen kommt.

So funktioniert es

Wie Routen werden auch Isolinen asynchron berechnet, nach demselben asynchronen Muster, das in der gesamten API verwendet wird. Das Erstellen und das Abrufen einer Isoline erfolgen in getrennten Schritten.

1. Isoline erstellenRufen Sie die Mutation createIsoline mindestens mit einer vehicle_id und einem origin auf. Die Mutation gibt sofort eine Isoline-id zurück, die Sie im nächsten Schritt verwenden. Optionale Eingaben wie Akkustand oder Wetter werden unter Isoline anpassen behandelt.
2. Subscription öffnenAbonnieren Sie die Subscription isoline mit der id aus dem vorherigen Schritt. Solange die Isoline berechnet wird, lautet der Status pending. Nutzen Sie ihn, um einen Ladezustand in Ihrer Oberfläche anzuzeigen.
3. Ergebnis darstellenSobald der status zu done oder error wechselt, stellen Sie die passende Oberfläche dar. Eine Isoline mit done enthält die polygons, die auf der Karte gezeichnet werden.
4. Bei Bedarf erneut abrufenEine fertige Isoline wird mit allen Details gespeichert. Um sie später erneut anzuzeigen, verwenden Sie die Query isoline mit derselben id, anstatt eine neue Subscription zu öffnen.

Polygone

Das Ergebnis ist eine Liste von Polygonen. Zusammen beschreiben sie das erreichbare Gebiet in Stufen, von nahe dem Startpunkt bis zum am weitesten entfernten Punkt, den das Fahrzeug erreichen kann.

Mit polygon_count legen Sie fest, wie viele Polygone Sie erhalten, maximal 20.

• Weniger Polygone liefern ein einfaches, grobes Bild der Reichweite des Fahrzeugs. Sie sind schneller zu zeichnen und auf einen Blick leichter lesbar.
• Mehr Polygone liefern feinere Stufen zwischen dem Startpunkt und der maximalen Reichweite, was für einen Farbverlauf oder eine detailliertere Reichweitenkarte nützlich ist.

Jedes Polygon hat in seinen properties einen index, um sie zu unterscheiden, und maximum_distance gibt die Entfernung vom Startpunkt zum am weitesten entfernten erreichbaren Punkt an.

Erste Isoline erstellen

Eine vehicle_id und ein origin genügen, um eine Isoline zu erstellen. Dieses Beispiel legt zusätzlich den Akkustand, die Anzahl der Polygone und das Wetter fest, damit Sie sehen, wie die wichtigsten Optionen zusammenspielen.

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

Die Mutation gibt die Isoline-id zurück. Übergeben Sie sie an die Subscription isoline, um die Berechnung zu verfolgen und das Ergebnis zu erhalten:

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

In dieser Anfrage:

• state_of_charge startet das Fahrzeug mit 80 % Akkustand. Ohne diese Angabe verwendet die Isoline die gesamte nutzbare Batteriekapazität des Fahrzeugs.
• polygon_count liefert fünf Polygone, von nahe dem Startpunkt bis zur maximalen Reichweite.
• weather verwendet die Voreinstellung winter, die kalte Bedingungen annimmt und in der Regel ein kleineres erreichbares Gebiet ergibt als die Standardeinstellung mit Echtzeit-Wetterdaten.

Isoline anpassen

createIsoline akzeptiert eine Reihe optionaler Eingaben zur Feinabstimmung der Berechnung. Weitere Details zu jedem Feld finden Sie in der API-Referenz.