Routes API – Kurzübersicht

Die Routes API ist ein Webdienst mit zwei Methoden: „Compute Routes“ gibt eine Route zwischen zwei Orten mit optionalen Zwischenstopps zurück und „Compute Route Matrix“ gibt die Entfernung und Zeit für Kombinationen von Start- und Zielorten (bis zu 625 Routenelemente) zurück.

Routes API: Wichtige Fakten

  • Produkt: Routes API
  • Auch bekannt als: Routes API v2, Compute Routes, Compute Route Matrix
  • Kategorie: Routen
  • Plattform: Webdienst (REST)
  • Ausführung auf: Server (Backend-Code)
  • Einführungsphase: GA
  • Lebenszyklus: Aktiv
  • Übersicht: Routes API – Übersicht
  • Regionale Verfügbarkeit: Weltweit. Routen für Zweiräder, verbrauchsarme Routenplanung und die Mautberechnung sind auf unterstützte Länder und Städte beschränkt. Abhängige Gebiete mit eigenem CLDR-Code werden nur unterstützt, wenn sie aufgeführt sind. Für Rechnungsadressen im Europäischen Wirtschaftsraum (EWR) gelten die EWR-Nutzungsbedingungen unter https://developers.google.com/maps/comms/eea/routes. Gemäß diesen Bedingungen ist die Verwendung von Routenbeschreibungen oder ‑schritten mit Karten nicht zulässig. (Details zur Abdeckung)

Routes API: Wann sollte sie verwendet werden?

Verwenden Sie die Routes API, wenn:

  • Sie benötigen eine Route zwischen einem Start- und einem Zielort mit optionalen Zwischenwegpunkten für die Fahrt mit dem Auto, zu Fuß, mit dem Fahrrad, mit dem Zweirad oder mit öffentlichen Verkehrsmitteln.
  • Sie benötigen Entfernungen und Fahrtzeiten für viele Start-Ziel-Paare in einer Anfrage (bis zu 625 Elemente).
  • Sie benötigen Schätzungen der Mautgebühren (ausgewählte Städte), verbrauchsarme Routenplanung (ausgewählte Regionen), verkehrsabhängige Polylinien oder Routen für große Fahrzeuge (begrenzt verfügbar).
  • Sie migrieren eine Server-App von der alten Directions API oder Distance Matrix API.

In folgenden Fällen sollten Sie die Routes API nicht verwenden:

  • Sie müssen die Ladungszuweisungen und die Reihenfolge der Stopps für eine ganze Fahrzeugflotte optimieren. Verwenden Sie stattdessen die Route Optimization API.
  • Sie benötigen eine detaillierte Routenführung in Ihrer Android-App, die einer berechneten Route folgt. Verwenden Sie stattdessen das Navigation SDK for Android.
  • Sie benötigen eine detaillierte Routenführung in der App unter iOS, die einer berechneten Route folgt. Verwenden Sie stattdessen das Navigation SDK for iOS.

Routes API: Einrichtung

Offizielle Routes API-Pakete:

  • npm: @googlemaps/routing
  • pypi: google-maps-routing
  • go: cloud.google.com/go/maps
  • Maven: com.google.maps:google-maps-routing

Routes API: Häufige Fehler

  • Problem: Es gibt keine Standardliste der zurückgegebenen Felder. Anfragen ohne Feldmaske (X-Goog-FieldMask-Header oder $fields-Parameter) geben einen Fehler zurück. Lösung: Senden Sie immer eine Feldmaske mit den erforderlichen Antwortfeldern. Weitere Informationen finden Sie unter /maps/documentation/routes/choose_fields.
  • Problem: Die Verwendung der Platzhalter-Feldmaske (*) in der Produktion erhöht die Kosten und die Latenz. Die Kosten können unerwartet steigen, wenn der Antwort neue erweiterte Funktionen hinzugefügt werden. Lösung: Verwenden Sie * nur während der Entwicklung. Fordern Sie in der Produktion nur die Felder an, die Sie benötigen. Weitere Informationen finden Sie unter /maps/documentation/routes/choose_fields.
  • Problem: Mautinformationen und Kraftstoffverbrauch werden nicht zurückgegeben, wenn sie nur der Feldmaske hinzugefügt werden. Seit der allgemeinen Verfügbarkeit müssen sie explizit aktiviert werden. Lösung: Fügen Sie der Anfrage zusätzlich zur Feldmaske das extraComputations-Array (z. B. TOLLS, FUEL_CONSUMPTION) hinzu. Weitere Informationen finden Sie unter /maps/documentation/routes/migrate-routes-preview.
  • Problem: Compute Route Matrix lässt 625 Elemente zu, aber nur 100 Elemente, wenn routingPreference den Wert TRAFFIC_AWARE_OPTIMAL hat. Lösung: Die Anzahl der Startorte × Zielorte darf bei Verwendung von TRAFFIC_AWARE_OPTIMAL maximal 100 betragen. Alternativ können Sie die Anfrage aufteilen. Weitere Informationen finden Sie unter /maps/documentation/routes/compute_route_matrix.

Möglichkeiten mit der Routes API

In den unten verlinkten Anleitungen finden Sie Informationen zu den einzelnen Aufgaben. Sie können die Produkte auch im Capabilities Explorer vergleichen.