Von Directions API oder Distance Matrix API migrieren

In dieser Anleitung wird beschrieben, wie Sie Apps, die entweder die Directions API oder die Distance Matrix API verwenden, auf die Routes API umstellen. Weitere Informationen zur Routes API finden Sie in der Produktübersicht.

REST API-Endpunkte aktualisieren

Code für die Verwendung der neuen Endpunkte der Routes API aktualisieren

Über die Directions API

Directions API https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Routes API https://routes.googleapis.com/directions/v2:computeRoutes

Über die Distance Matrix API

Distance Matrix API https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters
Routes API https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix

URL-Parameter für die Verwendung eines HTTPS-Anfragetexts konvertieren

Bei der Directions API und der Distance Matrix API übergeben Sie Konfigurationseigenschaften als URL-Parameter an eine HTTP GET-Anfrage. Beispiel für die Directions API:

https://maps.googleapis.com/maps/api/directions/outputFormat?parameters

Bei der Routes API übergeben Sie Parameter im Anfragetext oder in Headern als Teil einer HTTP POST-Anfrage. Beispiele finden Sie unter:

Polyliniencodierte Wegpunkte in Standortwegpunkte umwandeln

In der Directions API können Wegpunkte als codierte Polylinien angegeben werden, um eine große Anzahl von Wegpunkten in die URL-Begrenzung von 16.384 Zeichen zu passen. Diese Funktion ist in der Routes API nicht erforderlich, da Wegpunkte im REST- oder gRPC-Anfragetext als Breiten- und Längengradkoordinaten übertragen werden können. Beispiele finden Sie im Dokument Eine Routenmatrix berechnen unter HTTP-Beispiel oder im Dokument Wegpunkte angeben unter Wegpunkt definieren.

Parameter konvertieren

In den folgenden Tabellen sind Parameter in der Directions API und der Distance Matrix API aufgeführt, die umbenannt oder geändert wurden, oder Parameter, die in der GA-Version nicht unterstützt werden. Aktualisieren Sie Ihren Code, wenn Sie einen dieser Parameter verwenden.

Anfragen mit Parametern

Parameter für Wegbeschreibungen oder Distance Matrix Routes API-Parameter Hinweise
alternatives computeAlternativeRoutes
arrival_time arrivalTime Nur im TRANSIT-Modus verfügbar, nicht gleichzeitig mit departureTime.
avoid routeModifiers
departure_time departureTime Kann nicht gleichzeitig mit arrivalTime verwendet werden.
language languageCode Unterstützt nur für Compute Routes.
mode travelMode

Unterstützung für TWO_WHEELER und TRANSIT hinzugefügt.
region regionCode
traffic_model trafficModel Weitere Informationen
transit_mode "travelMode": "TRANSIT" In der Directions API wird in einer ÖPNV-Route jedes Segment einer Fahrt mit demselben Verkehrsmittel (z. B. „Zu Fuß“ oder „ÖPNV“) als Schritt betrachtet. Einzelne Wegbeschreibungen für dieses Verkehrsmittel sind in Teilschritten enthalten. In der Routes API sind die Schritte dagegen für alle Arten von Fahrten einheitlich. Jede Navigationsanweisung ist also ein Schritt. Für mehrere Schritte in einem Verkehrsmittel stellt die Routes API Metadaten bereit, die eine Zusammenfassung der Schritte für dieses Verkehrsmittel enthalten. Diese finden Sie unter „stepsOverview“. Verwenden Sie die Feldmaske „routes.legs.stepsOverview“, um diese Metadaten anzufordern. Weitere Informationen
transit_routing_preference transitRoutingPreference Weitere Informationen
units units Weitere Informationen
waypoints intermediates Die Unterstützung für codierte Polylinien wurde entfernt.
optimize=true für Wegpunkte "optimizeWaypointOrder": "true" Weitere Informationen

Antwortparameterkonvertierungen

Parameter für Wegbeschreibungen oder Distance Matrix Routes API-Parameter Hinweise
copyrights

Nicht in der Antwort enthalten. Wenn Sie Nutzern die Ergebnisse anzeigen, muss die folgende Erklärung enthalten sein:

Powered by Google, ©YEAR Google

Beispiel:

Powered by Google, ©2022 Google
distance distanceMeters Entfernungen sind nur in Metern verfügbar.
duration_in_traffic duration In der Routes API entfernt. Verwenden Sie stattdessen duration.
status Nicht verfügbar. Verwenden Sie die HTTP-Antwortcodes für Fehler, die von der API gemeldet werden. Weitere Informationen finden Sie unter Anfragefehler behandeln.
geocoded_waypoints geocoding_results Unterstützt nur für Compute Routes. Enthält Geocoding-Antwortinformationen nur für Wegpunkte, die als Adressen angegeben sind.
bounds viewport
legs.end_address Nicht verfügbar.
legs.start_address Nicht verfügbar.
overview_polyline Polylinie
summary description
waypoint_order optimizedIntermediateWaypointIndex