Routing nach Betreiberpräferenz
Mit Betreiberpräferenzen steuern Sie, welche Ladenetzwerke der Routing-Dienst bei der Berechnung einer E-Fahrzeug-Route bevorzugt.
Sie können Präferenzen an zwei Stellen konfigurieren:
- Chargetrip-Dashboard: Legen Sie globale Betreiberpräferenzen für Ihr Projekt unter Projekt / Erweitert / Stationsbetreiber-Präferenzen fest.
- Create-Route-Anfrage: Definieren Sie Präferenzen dynamisch oder überschreiben Sie die Betreiberpräferenzen aus dem Dashboard pro Anfrage über das Feld
input.operatorsin der MutationcreateRoute.
1. Präferenztypen und Routenverhalten
Betreiberpräferenzen gibt es in vier Typen, und jede kann auf bestimmte Länder begrenzt werden:
| Präferenz | Routing-Verhalten |
|---|---|
| Ausgeschlossen | Stationen dieser Betreiber werden unter allen Umständen strikt ausgeschlossen. |
| Gemieden | Stationen dieser Betreiber werden gemieden, sofern keine bessere Alternative existiert. |
| Bevorzugt | Stationen dieser Betreiber werden nach ihrem Ranking (high, medium, low) priorisiert. Je höher die Stufe, desto wahrscheinlicher wird die Station ausgewählt. Die Route nutzt weiterhin nicht eingestufte oder gemiedene Stationen, wenn keine bessere Alternative existiert. |
| Erforderlich | Es werden nur Stationen dieser Betreiber verwendet. Innerhalb dieses zulässigen Pools gelten die Ranking-Stufen weiterhin, das heißt, hoch eingestufte Betreiber werden gegenüber mittel und niedrig eingestuften bevorzugt. Wenn das Fahrzeug das Ziel nicht allein mit eingestuften Stationen erreichen kann, schlägt die Routenberechnung fehl. |
2. Anwendung der Präferenzen auf Dashboard-Ebene
Wenn Sie verstehen, wie Eingaben auf Anfrageebene mit den Dashboard-Einstellungen zusammenwirken, bleibt das Routing-Verhalten vorhersehbar:
- Im Dashboard ausgeschlossene und gemiedene Betreiber gelten automatisch:
Betreiber, die im Dashboard als ausgeschlossen oder gemieden konfiguriert sind, gelten für jede Routenberechnung, ohne dass Parameter in Ihrer
createRoute-Anfrage erforderlich sind. - Ranking-Stufen im Dashboard bleiben ohne Ranking-Typ inaktiv:
Betreiber, die in Ranking-Stufen konfiguriert sind, müssen durch Setzen von
input.operators.ranking.typein IhrercreateRoute-Anfrage aktiviert werden, andernfalls beeinflussen sie die Stationsauswahl nicht. - Betreiber auf Anfrageebene ersetzen die jeweiligen Dashboard-Präferenzen:
Die Angabe von Betreiber-IDs in der
createRoute-Anfrage ersetzt nur die entsprechende Konfiguration aus dem Dashboard. Wenn Sie beispielsweiseinput.operators.exclude[]angeben, ersetzt das die gesamte Konfiguration der ausgeschlossenen Betreiber im Dashboard, während die Dashboard-Betreiber zum Meiden weiterhin gelten.
3. Implementierungsbeispiele
Nur Dashboard-Ausschlüsse und -Vermeidungen verwenden
Wendet die im Dashboard festgelegten Konfigurationen für ausgeschlossene und gemiedene Betreiber an. Die Ranking-Einstellungen des Dashboards sind inaktiv, da kein input.operators.ranking.type angegeben ist.
Ranking-Betreiber aus dem Dashboard als „Bevorzugt“ verwenden
Wendet die Dashboard-Konfigurationen für ausgeschlossene und gemiedene Betreiber an und bevorzugt Stationen, die zu den Ranking-Stufen des Dashboards gehören.
Ranking-Betreiber aus dem Dashboard als „Erforderlich“ verwenden
Beschränkt die Route darauf, ausschließlich an Stationen von Betreibern zu laden, die in den Ranking-Stufen des Dashboards konfiguriert sind.
Eigene Präferenzen definieren und Dashboard-Einstellungen überschreiben
Geben Sie die vollständigen Betreiberkonfigurationen direkt im API-Aufruf an. Jedes angegebene Feld (ranking, avoid oder exclude) überschreibt für diese Anfrage die entsprechende Dashboard-Konfiguration.
Eigene Präferenzen für bestimmte Länder definieren
Geben Sie die vollständigen Betreiberkonfigurationen direkt im API-Aufruf an. Jedes angegebene Feld (ranking, avoid oder exclude) überschreibt für diese Anfrage die entsprechende Dashboard-Konfiguration.
War dieser Inhalt hilfreich?