Von Directions API oder Distance Matrix API migrieren

In diesem Leitfaden wird beschrieben, wie Sie Apps, die entweder die Directions API oder die Distance Matrix API verwenden, zur Verwendung der Routes API migrieren. Weitere Informationen zur Routes API finden Sie in der Produktübersicht.

REST API-Endpunkte aktualisieren

Aktualisieren Sie Ihren Code, um die neuen Routes API-Endpunkte zu verwenden

Von Directions API

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

Von 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 konvertieren, um einen HTTPS-Anfragetext zu verwenden

Mit der Directions API und der Distance Matrix API übergeben Sie Konfigurationsattribute als URL-Parameter an eine HTTP GET-Anfrage. Für die Directions API gilt beispielsweise Folgendes:

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

Mit der Routes API übergeben Sie Parameter in einem Anfragetext oder in Headern im Rahmen einer HTTP POST-Anfrage. Beispiele finden Sie unter:

Wegpunkte, die als codierte Polylinien dargestellt werden, in Wegpunkte in der Ferne umwandeln

In der Directions API können Sie Wegpunkte als codierte Polylinien angeben, um eine große Anzahl von Wegpunkten in das URL-Limit von 8.192 Zeichen aufzunehmen. Dieses Feature ist in der Routes API nicht erforderlich, da Wegpunkte im Text der REST- oder gRPC-Anfrage als Zwischenmittelpunkte übertragen werden können.

Vorhandene Parameter in Routes API-Parameter konvertieren

In der folgenden Tabelle finden Sie Parameter für die Directions API und die Distance Matrix API, die umbenannt oder geändert wurden oder die in der GA-Version nicht unterstützt werden. Aktualisieren Sie Ihren Code, wenn Sie einen dieser Parameter verwenden.

Parameter „Routes“ und „Distance Matrix“ Routes API-Parameter Hinweise
alternatives computeAlternativeRoutes
arrival_time Nicht verfügbar, weil der Modus „TRANSIT“ nicht verfügbar ist.
avoid routeModifiers
copyrights

Nicht in der Antwort enthalten. Du musst die folgende Anweisung einfügen, wenn die Ergebnisse für deine Nutzer angezeigt werden:

Powered by Google, ©YEAR Google

Beispiel:

Powered by Google, ©2022 Google
departure_time departureTime
distance distanceMeters Die Entfernung ist nur in Metern verfügbar.
duration_in_traffic Entfernt in der Routes API mit duration. Weitere Informationen finden Sie oben im Abschnitt Funktionsänderungen für die neue Routes API.
language languageCode Wird nur für Compute-Routen unterstützt.
mode travelMode

TWO_WHEELER wird jetzt unterstützt.

Modus „TRANSIT“ nicht verfügbar.
region regionCode

status Nicht verfügbar. Verwende die HTTP-Antwortcodes für Fehler, die von der API gemeldet werden. Weitere Informationen finden Sie unter Fehler bei Anfragen verarbeiten.
traffic_model Nicht verfügbar.
transit_mode Nicht verfügbar, weil der Modus „TRANSIT“ nicht verfügbar ist.
transit_routing_preference Nicht verfügbar, weil der Modus „TRANSIT“ nicht verfügbar ist.
units Für die Routenmatrix nicht verfügbar.
waypoints intermediates Die Unterstützung für codierte Polylinien wurde entfernt.
optimize=true für Wegpunkte Nicht verfügbar.