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
- Zu aktivierender Dienst:
routes.googleapis.com - Authentifizierung: API-Schlüssel, OAuth 2.0, Dienstkonto
- Erste Schritte: Routes API einrichten
- Referenz: Routes API-Referenz
- Preise: Routes API-Nutzung und -Abrechnung
- Richtlinien: Routes API-Richtlinien
- Versionshinweise: Versionshinweise zur Routes API
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: ähnliche Produkte
- Ersetzt: Directions API, Distance Matrix API
- Häufig verwendet mit: Navigation SDK for Android, Navigation SDK for iOS, Route Optimization API, Geocoding API, Places API (New)
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
routingPreferenceden WertTRAFFIC_AWARE_OPTIMALhat. Lösung: Die Anzahl der Startorte × Zielorte darf bei Verwendung vonTRAFFIC_AWARE_OPTIMALmaximal 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.
- Routen zwischen zwei oder mehr Breiten-/Längengradkoordinaten als eine Reihe von Koordinaten für jeden Schritt entlang einer Route zurückgeben.
- Routen zwischen zwei oder mehr Gruppen von Breiten-/Längengradkoordinaten als eine Reihe von Manöverbeschreibungen für die Schritte entlang einer Route zurückgeben.
- Gibt die Entfernung zwischen den einzelnen Schritten einer Route zwischen zwei oder mehr Sätzen von Breiten- und Längengradkoordinaten zurück.
- Gibt die Reisedauer zwischen den einzelnen Schritten einer Route zwischen zwei oder mehr Breiten-/Längengradkoordinaten zurück.
- Gibt eine codierte Polylinie zwischen den einzelnen Schritten einer Route zwischen zwei oder mehr Sätzen von Breiten-/Längengradkoordinaten zurück.
- Gibt die Entfernung für eine Route zwischen zwei oder mehr Sätzen von Breiten- und Längengradkoordinaten zurück.
- Gibt die Reisedauer für eine Route zwischen zwei oder mehr Breiten- und Längengradkoordinaten zurück.
- Eine codierte Polylinie für eine Route zwischen zwei oder mehr Sätzen von Breiten-/Längengradkoordinaten zurückgeben.
- Mautinformationen für eine Route zwischen zwei oder mehr Breiten-/Längengradkoordinaten zurückgeben
- Mobilitätsform (Auto, öffentliche Verkehrsmittel, zu Fuß, Zweirad) für eine Routenanfrage angeben Hinweis: Übergeben Sie im Routes API-Webdienst (computeRoutes) „travelMode“ im HTTP POST-JSON-Text mit „RouteTravelMode“ (DRIVE, BICYCLE, TWO_WHEELER, WALK, TRANSIT oder TRUCK mit routeModifiers.vehicleInfo) und fügen Sie den erforderlichen X-Goog-FieldMask-Header anstelle eines alten GET-Modus-Suchparameters ein. Übergeben Sie in der Routes Library der Maps JavaScript API „travelMode“ und die Felder in „ComputeRoutesRequest“.
- Geben Sie einen Halte- oder Durchfahrtspunkt für eine Routenanfrage an.
- Angeben, wie Verkehrsdaten in einer Routenanfrage verwendet werden
- Sie können für eine Routenanfrage angeben, welche Elemente vermieden werden sollen, z. B. Autobahnen oder Mautstraßen.
- Wegpunkte entlang einer Route festlegen
- Zwischenstopps entlang einer Route festlegen
- Legen Sie einen Punkt fest, durch den eine Route führen soll.
- Fahrtrichtung und Straßenseite für eine Route angeben
- Reihenfolge der Stopps auf Ihrer Route optimieren
- Verbrauchsarme Routenplanung für eine Routenanfrage angeben Vorabversion
- Kürzere Strecke oder alternative Routenführung für eine Routenanfrage angeben Hinweis: In der Routes API ist das Anfordern einer Referenzroute mit kürzerer Entfernung (SHORTER_DISTANCE) experimentell, während das Anfordern alternativer Routen (computeAlternativeRoutes) allgemein verfügbar ist.
- Entfernungen für eine Matrix von Routen zwischen mehreren Start- und Zielorten zurückgeben
- Fahrtzeiten für eine Matrix von Routen zwischen mehreren Start- und Zielorten zurückgeben
- Mautinformationen für eine Matrix von Routen zwischen mehreren Start- und Zielorten zurückgeben
- Geben Sie die Mobilitätsform (Auto, öffentliche Verkehrsmittel, zu Fuß, Zweirad) für eine Routenmatrixanfrage an. Hinweis: Übergeben Sie im Routes API-Webdienst (computeRouteMatrix) „travelMode“ im HTTP-POST-JSON-Text mit „RouteTravelMode“ (DRIVE, TWO_WHEELER, WALK, TRANSIT oder TRUCK mit „origins[].routeModifiers.vehicleInfo“; BICYCLE wird für Routenmatrizen nicht unterstützt) und fügen Sie den erforderlichen X-Goog-FieldMask-Header ein. Übergeben Sie in der Routes Library der Maps JavaScript API travelMode und fields in ComputeRouteMatrixRequest.