Query

Veraltet

Routenpfad

routePath

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

Alt	Neu
`routePath`	`getRoute`

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 Abfrage

Der Pfad der Route ist jetzt bereits in der Antwort von getRoute als recommended.path_plot enthalten, sodass keine separate Abfrage mehr nötig ist, um ihn abzurufen.

Rufen Sie den Pfad einer zuvor berechneten Route mit der Query routePath ab. Dies ist nützlich, wenn Sie die Polyline einer Route auf einer Karte darstellen möchten.

Argumente

id· ID· required

ID of a route that you require for a route path segment

location· PointInput· required

The GeoJSON Point of a route path segment

alternativeId· ID

Optional alternative ID. By default we will retrieve the fastest route

Felder

location· Point

GeoJSON location of a route path segment.

elevation· Int

Elevation (altitude) in meters.

averageSpeed· Float

Average speed, in km/h, for this route path segment.

recommendedSpeed· Float

Recommended speed, in km/h for this route path segment to optimise the consumption.

consumption· Float

Consumption, in kWh, of a route path segment.

consumptionPerKm· Float

Consumption, in kWh per km, of a route path segment.

distance· Float

Distance, in meters, of a route path segment.

duration· Float

Duration, in seconds, of a route path segment.

stateOfCharge· Float

State of charge, in kWh, of a route path segment.

Fehler

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

error_forbidden_message: You are forbidden to execute this operation.
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.
rate_limit_exceeded: Rate limit exceeded.
route_invalid_safe_risk_margin: Safe risk margin needs to be a value between 0 and 60.
route_not_found: No route was found with the provided ID.
route_path_invalid_point_coordinates: The coordinates provided are not valid.
route_path_location_not_found: No location was found with the provided input.
route_path_not_found: No route path was found with the provided ID or alternative ID.

War dieser Inhalt hilfreich?

Routenpfad

routePath

Operationen

Allgemeine Schemaänderungen

Änderungen an der Abfrage

Argumente

Felder

Fehler

Cookies verwalten

Essenzielle Cookies

Leistungs-Cookies

Marketing-/Werbe-Cookies

Versprechen zu Drittanbietern

So können Sie Cookies kontrollieren oder ablehnen