Route
Die Routenplanung für EVs bringt besondere Herausforderungen mit sich. Batteriekapazität, realer Energieverbrauch, Topografie, Wetter und die Verfügbarkeit von Ladenetzen bestimmen gemeinsam, ob ein Fahrzeug sein Ziel erreicht.
Die Route API berücksichtigt all diese Variablen, um optimale EV-Routen zu finden. Mit einem erstklassigen Energieverbrauchsmodell platziert sie Ladestopps automatisch genau dann und dort, wo sie benötigt werden. Routen sind vollständig anpassbar, sodass Sie sie auf Ihre eigenen Geschäftsregeln abstimmen können.
So funktioniert es
Um eine hohe Performance sicherzustellen, arbeitet die Route API asynchron, nach demselben asynchronen Muster, das in der gesamten API verwendet wird. Das Erstellen und das Abrufen einer Route erfolgen in getrennten Schritten.
- Route erstellenRufen Sie die Mutation
createRoutemindestens mitvehicle,originunddestinationauf. Die Mutation gibt sofort eine Routen-idzurück, die Sie im nächsten Schritt verwenden, um die Route zu verfolgen und abzurufen. Es stehen viele weitere Anpassungsoptionen zur Verfügung; siehe Route anpassen weiter unten. - Subscription öffnenAbonnieren Sie die Subscription
routemit deridaus dem vorherigen Schritt. Während die Route berechnet wird, sendet die Subscription Status-Updates, mit denen Sie einen asynchronen Ladezustand in Ihrer Oberfläche steuern können. - Ergebnis darstellenSobald der
statusder Route zudone,errorodernot_foundwechselt, stellen Sie die passende Oberfläche für dieses Ergebnis dar. - Bei Bedarf erneut abrufenEine Route, die einen erfolgreichen Endstatus erreicht hat, wird mit allen Details gespeichert. Wenn Sie sie später erneut anzeigen müssen, zum Beispiel nach dem Zurücknavigieren, verwenden Sie die Query
getRoute, anstatt eine neue Subscription zu öffnen.
Route anpassen
createRoute akzeptiert eine Reihe optionaler Eingaben, um die Berechnung einer Route fein abzustimmen. Weitere Details zu jedem Feld finden Sie in der API-Referenz.
| Funktion | Beschreibung |
|---|---|
| Wegpunkte | Fügen Sie Zwischenstopps hinzu. Geben Sie via.properties.station.station_id an, um einen Ladestopp an einer bestimmten Station zu erzwingen, oder nur via.geometry für einen reinen Durchfahrtspunkt ohne Laden. |
| Stoppdauer | Legen Sie mit properties.station.stop_duration oder properties.location.stop_duration fest, wie lange in Sekunden das Fahrzeug an einem Wegpunkt oder am Ziel bleibt. |
| Laden an der Autobahn | Priorisieren Sie Ladestationen direkt an der Autobahn mit station_preferences.prefer_highway_charging und vermeiden Sie Stopps, für die die Autobahn verlassen werden muss. |
| Wetter | Wenden Sie eine Wettervoreinstellung oder benutzerdefinierte Wetterbedingungen auf das Verbrauchsmodell an. Standardmäßig Echtzeit-Wetterdaten. |
| Jahreszeit | Nehmen Sie summer, winter oder current als Wetterbedingungen an, als einfachere Alternative zu weather. |
| Zu vermeidende Routenmerkmale | Vermeiden Sie toll_road oder ferry nach bestem Bemühen. |
| Betreiber-Ranking | Bevorzugen Sie bestimmte Ladenetze mit type: preferred oder beschränken Sie das Routing mit type: required ausschließlich auf diese Netze. Stufen Sie Betreiber als high, medium oder low ein und beschränken Sie ein Ranking pro Betreiber auf bestimmte Länder. |
| Betreiberausschlüsse | Schließen Sie einen Betreiber mit operators.exclude vollständig von der Route aus. Greift auf die Dashboard-Konfiguration Ihres Projekts zurück, wenn es nicht auf Anfrageebene gesetzt ist. |
| Betreibervermeidung | Vermeiden Sie mit operators.avoid einen Betreiber, ohne ihn völlig auszuschließen. |
| Alternative Ladestationen | Suchen Sie entlang der Route nach alternativen Ladestationen in einem Radius zwischen 500 und 5000 Metern. |
| Alternative Routen | Fordern Sie zusätzliche Routenoptionen nach bestem Bemühen an. Setzen Sie den Wert auf 0, um nur die empfohlene Route zu berechnen. |
| Fahrpräferenzen | Passen Sie den Fahrstil mit speed_factor oder maximum_speed an oder wählen Sie einen style von eco oder sport. |
| Verkehrsberücksichtigung | Berücksichtigen Sie Staus in Echtzeit. Wenden Sie sich an den Support, um dies für Ihr Projekt zu aktivieren. |
| Abfahrtszeit | Berechnen Sie erwartete Ankunftszeiten anhand von Echtzeit-Verkehr und historischem, aktuellem oder prognostiziertem Wetter. |
| Ziel als Station | Legen Sie eine bestimmte Station als Ziel der Route fest. Dies wird als Stopp ohne Laden behandelt. |
| Fahrzeugbeladung pro Wegpunkt | Legen Sie occupants, total_occupant_weight und total_cargo_weight bei origin oder via fest. Diese gelten für den Rest der Fahrt und können an jedem späteren Via-Punkt überschrieben werden. |
| Minimale Ladeleistung | Standardmäßig schließt das Routing Stecker unter 43 kW aus. Legen Sie ein anderes Minimum fest, das zur Ladegeschwindigkeit Ihres Fahrzeugs passt. Leistungsstärkere Ladesäulen werden weiterhin ausgewählt, auch wenn Ihr Fahrzeug langsamer lädt als deren Höchstleistung. |
War dieser Inhalt hilfreich?