Zum Hauptinhalt springen

Entwickler

Dashboard
Dashboard
Query
Veraltet

Routenpfad

Migrationsleitfaden

routePath

Migrieren bis: Q1 2027

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

Operationen

AltNeu
routePathgetRoute

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 Query

Der Pfad der Route ist jetzt bereits in der Antwort von getRoute als recommended.path_plot enthalten, sodass keine separate Query zum Abrufen mehr nötig ist.

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

Argumente

id· ID · erforderlich
ID of a route that you require for a route path segment
alternativeId· ID
Optional alternative ID. By default we will retrieve the fastest route

Felder

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 hier.

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?

Erstellen

Entwickler

Updates

Ressourcen

Rechtliches

Kontakt

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.