Zum Hauptinhalt springen
Guide

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.operators in der Mutation createRoute.

1. Präferenztypen und Routenverhalten

Betreiberpräferenzen gibt es in vier Typen, und jede kann auf bestimmte Länder begrenzt werden:

PräferenzRouting-Verhalten
AusgeschlossenStationen dieser Betreiber werden unter allen Umständen strikt ausgeschlossen.
GemiedenStationen dieser Betreiber werden gemieden, sofern keine bessere Alternative existiert.
BevorzugtStationen 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.
ErforderlichEs 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.type in Ihrer createRoute-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 beispielsweise input.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.

Example request
graphql
createRoute(  input: {    vehicle: { id: "607823b2c246f9001b97b1a2" }    origin: {      type: Feature      geometry: { type: Point, coordinates: [4.895168, 52.370216] }    }    destination: {      type: Feature      geometry: { type: Point, coordinates: [2.352222, 48.856614] }    }  })

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.

Example request
graphql
createRoute(  input: {    vehicle: { id: "607823b2c246f9001b97b1a2" }    origin: {      type: Feature      geometry: { type: Point, coordinates: [4.895168, 52.370216] }    }    destination: {      type: Feature      geometry: { type: Point, coordinates: [2.352222, 48.856614] }    }    operators: {      ranking: {        type: preferred      }    }  })

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.

Example request
graphql
createRoute(  input: {    vehicle: { id: "607823b2c246f9001b97b1a2" }    origin: {      type: Feature      geometry: { type: Point, coordinates: [4.895168, 52.370216] }    }    destination: {      type: Feature      geometry: { type: Point, coordinates: [2.352222, 48.856614] }    }    operators: {      ranking: {        type: required      }    }  })

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.

Example request
graphql
createRoute(  input: {    vehicle: { id: "607823b2c246f9001b97b1a2" }    origin: {      type: Feature      geometry: { type: Point, coordinates: [4.895168, 52.370216] }    }    destination: {      type: Feature      geometry: { type: Point, coordinates: [2.352222, 48.856614] }    }    operators: {      ranking: {        type: preferred        level: {          high: [{ id: "5e8c22366f9c5f23ab0eff01" }]          medium: [{ id: "5e8c22366f9c5f23ab0eff02" }]        }      }      avoid: [{ id: "5e8c22366f9c5f23ab0eff03" }]      exclude: [{ id: "5e8c22366f9c5f23ab0eff04" }]    }  })

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.

Example request
graphql
createRoute(  input: {    vehicle: { id: "607823b2c246f9001b97b1a2" }    origin: {      type: Feature      geometry: { type: Point, coordinates: [4.895168, 52.370216] }    }    destination: {      type: Feature      geometry: { type: Point, coordinates: [2.352222, 48.856614] }    }    operators: {      ranking: {        type: preferred        level: {          high: [{ id: "5e8c22366f9c5f23ab0eff01", countries: ["NL", "DE"] }]          medium: [{ id: "5e8c22366f9c5f23ab0eff01", countries: ["FR"] }]        }      }      avoid: [{ id: "5e8c22366f9c5f23ab0eff03", countries: ["AT"] }]      exclude: [{ id: "5e8c22366f9c5f23ab0eff04" }]    }  })

War dieser Inhalt hilfreich?

Entwickler

Chargetrip ©

Cookies verwalten

Gültig ab: 20. März 2024 · Aktualisiert: 1. September 2026

Wir verwenden Cookies, um Ihre Erfahrung auf developers.chargetrip.com zu verbessern. Diese Cookie-Richtlinie ist Teil der Datenschutzerklärung und regelt die Verwendung von Cookies zwischen Ihrem Gerät und unserer Website. Außerdem geben wir grundlegende Informationen zu Diensten von Drittanbietern, die wir möglicherweise einsetzen und die im Rahmen ihres Dienstes ebenfalls Cookies verwenden können, obwohl sie nicht von unserer Richtlinie abgedeckt sind.

Wenn Sie keine Cookies von uns akzeptieren möchten, sollten Sie Ihren Browser anweisen, Cookies von developers.chargetrip.com abzulehnen. Bitte beachten Sie, dass wir Ihnen dann möglicherweise einige der gewünschten Inhalte und Dienste nicht bereitstellen können.

Ein Cookie ist eine kleine Datei, die eine Website beim Besuch auf Ihrem Gerät speichert. Sie enthält in der Regel Informationen über die Website selbst, eine eindeutige Kennung, anhand derer die Website Ihren Webbrowser bei Ihrer Rückkehr wiedererkennt, zusätzliche Daten, die dem Zweck des Cookies dienen, sowie die Lebensdauer des Cookies.

Cookies werden verwendet, um bestimmte Funktionen zu ermöglichen (z. B. die Anmeldung), die Nutzung der Website zu verfolgen (z. B. Analysen), Ihre Benutzereinstellungen zu speichern (z. B. Zeitzone, Benachrichtigungseinstellungen) und Ihre Inhalte zu personalisieren (z. B. Werbung, Sprache).

Cookies, die von der besuchten Website gesetzt werden, bezeichnet man üblicherweise als „Erstanbieter-Cookies“, und sie verfolgen in der Regel nur Ihre Aktivität auf dieser bestimmten Website. Cookies, die von anderen Websites und Unternehmen (d. h. Drittanbietern) gesetzt werden, können verwendet werden, um Sie auf anderen Websites zu verfolgen, die denselben Drittanbieterdienst nutzen.

Essenzielle Cookies

Cookies, die von der besuchten Website gesetzt werden, bezeichnet man üblicherweise als „Erstanbieter-Cookies“, und sie verfolgen in der Regel nur Ihre Aktivität auf dieser bestimmten Website. Cookies, die von anderen Websites und Unternehmen (d. h. Drittanbietern) gesetzt werden, können verwendet werden, um Sie auf anderen Websites zu verfolgen, die denselben Drittanbieterdienst nutzen.

Leistungs-Cookies

Targeting-/Werbe-Cookies werden verwendet, um zu bestimmen, welche Werbeinhalte für Sie und Ihre Interessen relevanter und passender sind. Websites können sie einsetzen, um gezielte Werbung auszuliefern oder die Häufigkeit zu begrenzen, mit der Sie eine Anzeige sehen. Das hilft Unternehmen, die Wirksamkeit ihrer Kampagnen und die Qualität der Ihnen angezeigten Inhalte zu verbessern. Diese Cookies können von der besuchten Website (Erstanbieter) oder von Drittanbieterdiensten gesetzt werden. Von Dritten gesetzte Targeting-/Werbe-Cookies können verwendet werden, um Sie auf anderen Websites zu verfolgen, die denselben Drittanbieterdienst nutzen. Wir verwenden Targeting-/Werbe-Cookies auf unserer Website.

Marketing-/Werbe-Cookies

Targeting-/Werbe-Cookies werden verwendet, um zu bestimmen, welche Werbeinhalte für Sie und Ihre Interessen relevanter und passender sind. Websites können sie einsetzen, um gezielte Werbung auszuliefern oder die Häufigkeit zu begrenzen, mit der Sie eine Anzeige sehen. Das hilft Unternehmen, die Wirksamkeit ihrer Kampagnen und die Qualität der Ihnen angezeigten Inhalte zu verbessern. Diese Cookies können von der besuchten Website (Erstanbieter) oder von Drittanbieterdiensten gesetzt werden. Von Dritten gesetzte Targeting-/Werbe-Cookies können verwendet werden, um Sie auf anderen Websites zu verfolgen, die denselben Drittanbieterdienst nutzen. Wir verwenden Targeting-/Werbe-Cookies auf unserer Website.

Versprechen zu Drittanbietern

Wir prüfen die Datenschutzrichtlinien aller unserer Drittanbieter, bevor wir deren Dienste in Anspruch nehmen, um sicherzustellen, dass deren Praktiken mit unseren übereinstimmen. Wir werden niemals wissentlich Drittanbieterdienste einbinden, die die Privatsphäre unserer Nutzer gefährden oder verletzen.

Cookie
google-cookie-consent
Beschreibung
Speichert Ihre Cookie-Einstellungen, also welche Kategorien Sie akzeptiert oder abgelehnt haben, damit wir Ihre Wahl bei jedem Besuch respektieren und nur die Analyse- oder Marketing-Tools laden, die Sie zugelassen haben.
Lebensdauer
2 Jahre

So können Sie Cookies kontrollieren oder ablehnen

Wenn Sie keine Cookies von uns akzeptieren möchten, können Sie Ihren Browser anweisen, Cookies von unserer Website abzulehnen. Die meisten Browser sind standardmäßig so konfiguriert, dass sie Cookies akzeptieren, aber Sie können diese Einstellungen ändern, um Cookies entweder komplett abzulehnen oder sich benachrichtigen zu lassen, wenn eine Website versucht, ein Cookie zu setzen.

Wenn Sie Websites von mehreren Geräten aus aufrufen, müssen Sie Ihre Einstellungen möglicherweise auf jedem Gerät einzeln anpassen.

Obwohl sich einige Cookies mit geringen Auswirkungen auf die Nutzung einer Website blockieren lassen, kann das Blockieren aller Cookies dazu führen, dass Sie auf bestimmte Funktionen und Inhalte der von Ihnen besuchten Websites nicht zugreifen können.

Wir können diese Cookie-Richtlinie von Zeit zu Zeit aktualisieren, um beispielsweise Änderungen an den von uns verwendeten Cookies oder andere betriebliche, rechtliche oder regulatorische Gründe widerzuspiegeln. Bitte rufen Sie diese Cookie-Richtlinie erneut auf, um sich über unsere Verwendung von Cookies und verwandten Technologien auf dem Laufenden zu halten. Das Datum am Anfang dieser Cookie-Richtlinie gibt an, wann sie zuletzt aktualisiert wurde.