Zum Hauptinhalt springen
Mutation
Veraltet

Neue Route

Migrationsleitfaden

Route erstellen

Migrieren vor: Q1 2027

Migrieren Sie vom veralteten Route-Service auf die neueste Version. Der neue Service bietet ein neu organisiertes Schema, länderspezifische Betreiberpräferenzen, eine schnellere Routenberechnung und bessere Wartbarkeit.

Operationen

AltNeu
newRoutecreateRoute

Allgemeine Schemaänderungen

  • Explizite Typisierung: Zuvor flexible JSON-Felder sind jetzt im Schema explizit typisiert, um Struktur und Validierung zu verbessern.
  • Namenskonventionen: Felder verwenden jetzt snake_case statt camelCase.
  • Einheitenunterstützung: Numerische Eingaben unterstützen jetzt verschiedene Einheitentypen, ausgedrückt als Objekt mit value, type und einer optionalen source (manual, telemetry oder default).

Änderungen an der Mutation

Das Argument input von createRoute wurde neu organisiert und vereinfacht.

routeRequest

Auf Root-Ebene wurden die folgenden Felder entfernt. Betreiberbezogene Felder werden jetzt durch Betreiberpräferenzen abgedeckt, und ausstattungsbezogene Felder wurden in die eigene Ausstattungsabfrage verschoben.

FeldVerschoben nach
operatorIdsEntfernt
amenitiesEntfernt
amenity_preferencesEntfernt
operatorRequiredEntfernt
operatorPreferEntfernt

EV

Auf EV-Ebene wurden die meisten Felder der obersten Ebene in ein eigenes vehicle-Objekt verschoben.

FeldVerschoben nach
ev.idvehicle.id
batteryvehicle
climatevehicle
heat_pumpvehicle
plugsvehicle.charging.connectors
safeRiskMarginvehicle.charging.risk_margin
chargeModevehicle.charging.mode
bmsConsumptionEntfernt

Fahrzeugbeladung

Eigenschaften der Fahrzeugbeladung werden nicht mehr an einer einzigen Stelle festgelegt. Sie werden jetzt pro origin- und via-Punkt angegeben, was eine feinere Steuerung von Insassen- und Ladungsgewicht pro Etappe ermöglicht. Sie befinden sich bei jedem Standort unter properties.vehicle, und ihre Feldnamen ändern sich wie folgt:

FeldVerschoben nach
occupantsUnverändert
cargototal_cargo_weight

Telemetrie

Die folgenden Telemetriedaten wurden von der Root-Ebene in das vehicle-Objekt verschoben.

FeldVerschoben nach
headingvehicle
motor_rpmvehicle
odometervehicle
outside_temperaturevehicle
tire_pressurevehicle
vehicle_speedvehicle

Hervorgehobene Änderungen

Einige Felder des Arguments input haben jetzt neue, stärker strukturierte Formen. Sie werden unten ausführlicher behandelt.

Betreiberpräferenzen

Betreiberpräferenzen wurden auf drei Stufen vereinfacht: high, medium und low. Jeder Eintrag, ob eingestuft, ausgeschlossen oder gemieden, kann über das Feld countries auf bestimmte Länder beschränkt werden. Wenn es weggelassen wird, werden alle Länder berücksichtigt.

Betreiberpräferenzen
graphql
input: {  operators: {    ranking: {      type: preferred      levels: {        high: [          {            id: "op1"            countries: [NL]          }        ]        low: [          {            id: "op3"          }        ]      }    }  }}

Gesamtgewicht der Insassen

Mit einem neuen Feld total_occupant_weight können Sie das standardmäßige Insassengewicht überschreiben, ausgedrückt mit dem neuen Einheitenobjekt.

Gesamtgewicht der Insassen
graphql
input: {  origin: {    properties: {      vehicle: {        occupants: 3        total_occupant_weight: {          value: 160          type: kilogram          source: manual        }      }    }  }}

Erstellen Sie mit der veralteten Mutation newRoute eine neue Route. Sie bleibt verfügbar, während Sie auf die Mutation createRoute migrieren, die Ladestopps, Energieverbrauch und Fahrzeit mit einem neu organisierten Schema und länderspezifischen Betreiberpräferenzen berechnet.

Argumente

input· RequestInput

Felder

ID· ID· In favor of createRoute.

Operationen können fehlschlagen. Berücksichtigen Sie die folgenden Fehlerszenarien, um sie korrekt zu behandeln. Mehr zu Fehlern here.

consumption_exceeded
Provided consumption value for $LOCATION is not valid. The value must be between 0 and $MAXVALUE kwh, or the equivalent in another unit, for this vehicle.
empty_array_not_allowed
Array $NAME should have at least one value.
error_forbidden_message
You are forbidden to execute this operation.
invalid_coordinates
Coordinates provided for $LOCATION are not valid.
invalid_unit
Provided unit type $TYPE for $LOCATION is not valid.
invalid_value
Provided value $VALUE for $LOCATION is not valid. Expected value of type $EXPECTEDTYPE.
negative_value_not_allowed
Negative value for $LOCATION is not allowed.
occupants_above_allowed
Provided number of occupants for $LOCATION is not valid. The value must be less than or equal to $OCCUPANTSCOUNT for this vehicle.
occupants_below_allowed
Provided number of occupants for $LOCATION is not valid. The value must be at least 1.
operation_not_allowed
You are not allowed to execute this operation. Enable it for the current application in the dashboard or reach out to customer support.
operator_both_excluded_and_ranking
Operator $OPERATORID is both in the ranking and excluded lists.
operator_duplicated_in_exclude
Operator $OPERATORID is multiple times in the exclude lists.
operator_duplicated_in_ranking
Operator $OPERATORID is multiple times in the ranking lists.
operator_invalid_ranking
Operator ranking must be between 1 and 10.
operator_not_found
No operator was found with the $OPERATORID ID.
operator_ranking_none_given
The route operator type was set to $ROUTEOPTYPE, but no ranking was provided. Please add an operator to your client or route request.
rate_limit_exceeded
Rate limit exceeded.
route_battery_capacity_above_allowed
The provided battery capacity is too high. The value must be less than or equal to $MAX kwh or the equivalent in another unit.
route_battery_capacity_below_allowed
The provided battery capacity is too small. The value must be greater than or equal to $MIN kwh or the equivalent in another unit.
route_cargo_below_allowed
Provided amount of cargo weight is not valid. The value cannot be negative.
route_consumption_invalid_worst
Provided consumption value for $NAME is not valid. The worst value must be greater than or equal to best value.
route_consumption_total_exceeded
Provided consumption values are not valid. The total must be between 0 and $MAXVALUE for this vehicle.
route_destination_station_and_external_station_not_matching
The destination station for the route requested was not matched with the external station.
route_destination_station_invalid_speed
The provided destination station $STATIONID cannot be used as charging stop. The station does not support DC charging (> 43kW).
route_destination_station_not_found
The destination station for the route requested was not found with the provided ID.
route_destination_station_out_of_service
The provided destination station $STATIONID cannot be used as charging stop. All compatible connectors at this station are out of service.
route_duplicate_amenities
Amenities $DUPLICATEDAMENITIES are duplicated.
route_final_soc_exceeding_battery_capacity
The provided final state of charge is too high. The value must be less than or equal to 80% of the vehicle battery capacity.
route_invalid_amenities
Amenities $INVALIDAMENITIES are not valid. Allowed: $ALLOWEDAMENITIES.
route_invalid_destination_coordinates
The destination coordinates provided are not valid.
route_invalid_origin_coordinates
The origin coordinates provided are not valid.
route_invalid_scheduled_charge_stop_duration
The scheduled charge stop duration is invalid. The value must be between 900 and 86400 seconds.
route_invalid_scheduled_charge_stop_max_distance_from_station
The scheduled charge stop max_distance_from_station is invalid. The value must be between 0 and 1000 meters.
route_invalid_via_coordinates
The via coordinates provided are not valid.
route_max_number_of_passengers_exceeded
Provided number of passengers is not valid. The value must be between 1 and $PASSENGERCOUNT for this vehicle.
route_min_power_below_allowed
The provided minimum power is too small. The value must be greater than 0.
route_origin_station_and_external_station_not_matching
The origin station for the route requested was not matched with the external station.
route_origin_station_not_found
The origin station for the route requested was not found with the provided ID.
route_radius_above_allowed
The radius value is above allowed, the maximum value is 5000 meters.
route_radius_below_allowed
The radius value is below allowed, the minimum value is 500 meters.
route_station_invalid_charger
The provided via station $STATIONID cannot be used as charging stop. The charger standard of the vehicle is not supported.
route_station_invalid_min_power
The minimum power requested is higher than the station could support.
route_station_invalid_speed
The provided via station $STATIONID cannot be used as charging stop. The station does not support DC charging (> 43kW).
route_station_out_of_service
The provided via station $STATIONID cannot be used as charging stop. All compatible connectors at this station are out of service.
route_via_cargo_below_allowed
Provided amount of cargo is not valid. The value must be greater than 0.
route_via_station_and_external_station_not_matching
The via station for the route requested was not matched with the external station.
route_via_station_not_found
The station ID used as a via for the requested route was not found.
soc_exceeding_battery_capacity
The provided state of charge for $LOCATION is too high. The value must be less than or equal to the vehicle battery capacity.
station_destination_coordinates_not_matching
Coordinates [$DESTINATIONCOORDINATES] of destination don't match with station coordinates [$STATIONCOORDINATES].
station_origin_coordinates_not_matching
Coordinates [$ORIGINCOORDINATES] of origin don't match with station coordinates [$STATIONCOORDINATES].
station_via_coordinates_not_matching
Coordinates [$VIACOORDINATES] of via don't match with station coordinates [$STATIONCOORDINATES].
tire_pressure_below_allowed
Provided tire pressure is not valid. The value must be at least 1.
vehicle_freemium_not_allowed
You do not have access to this vehicle. Please upgrade to access this vehicle.
vehicle_type_not_allowed
Vehicle of type $TYPE is not allowed for this operation.
zero_or_negative_value_not_allowed
Zero or negative value for $LOCATION is not allowed.

War dieser Inhalt hilfreich?

Entwickler

Chargetrip ©

Status unbekannt

Cookies verwalten

Gültig ab: 20. März 2024 · Aktualisiert: 25. Januar 2023

Wir verwenden Cookies, um Ihr Erlebnis 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 Dritter, die wir möglicherweise einsetzen und die im Rahmen ihres Dienstes ebenfalls Cookies verwenden können, auch wenn diese 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, in dem Bewusstsein, dass wir Ihnen dann möglicherweise einige der gewünschten Inhalte und Dienste nicht bereitstellen können.

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

Cookies werden verwendet, um bestimmte Funktionen zu ermöglichen (z. B. die Anmeldung), die Website-Nutzung zu erfassen (z. B. Analysen), Ihre Benutzereinstellungen zu speichern (z. B. Zeitzone, Benachrichtigungspräferenzen) und Ihre Inhalte zu personalisieren (z. B. Werbung, Sprache).

Cookies, die von der besuchten Website gesetzt werden, werden üblicherweise als „Erstanbieter-Cookies“ bezeichnet und erfassen in der Regel nur Ihre Aktivität auf dieser 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, werden üblicherweise als „Erstanbieter-Cookies“ bezeichnet und erfassen in der Regel nur Ihre Aktivität auf dieser 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 Anzahl der Einblendungen einer Anzeige zu begrenzen. 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 Diensten Dritter 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 Anzahl der Einblendungen einer Anzeige zu begrenzen. 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 Diensten Dritter 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 ihre Dienste in Anspruch nehmen, um sicherzustellen, dass ihre 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-Präferenzen, also welche Kategorien Sie akzeptiert oder abgelehnt haben, damit wir Ihre Entscheidung bei jedem Besuch respektieren und nur die von Ihnen erlaubten Analyse- oder Marketing-Tools laden können.
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 vollständig abzulehnen oder benachrichtigt zu werden, wenn eine Website versucht, ein Cookie zu setzen.

Wenn Sie Websites von mehreren Geräten aus besuchen, müssen Sie Ihre Einstellungen möglicherweise auf jedem einzelnen Gerät 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.