Von Directions API oder Distance Matrix API migrieren

In diesem Leitfaden wird beschrieben, wie Sie Anwendungen migrieren, die entweder Directions API oder Distance Matrix API mithilfe der Routes API Weitere Informationen zur Routes API finden Sie in diesem Artikel Übersicht.

REST API-Endpunkte aktualisieren

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

Von 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 konvertieren, um den Text einer HTTPS-Anfrage zu verwenden

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

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

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

Polyliniencodierte Wegpunkte in Standort-Wegpunkte umwandeln

Wegpunkte als codierte Polylinien lassen sich in der Directions API für große Bildschirme Anzahl der Wegpunkte in der URL-Beschränkung von 16.384 Zeichen. Diese Funktion ist nicht in der Routes API erforderlich, da Wegpunkte in der REST- oder gRPC-Anfragetext als Breitengrad/Längengrad-Koordinaten. Beispiele: sieh dir die HTTP-Beispiel im Dokument Routenmatrix berechnen oder Wegpunkt-Zwischenpunkt festlegen im Dokument Wegpunkte angeben.

Parameter konvertieren

In den folgenden Tabellen sind die Parameter der Directions API und Distance Matrix API mit umbenannt oder geändert wurden oder Parameter, die in Google Analytics nicht unterstützt werden. Veröffentlichung. Aktualisieren Sie Ihren Code, wenn Sie einen dieser Parameter verwenden.

Anfragen mit Parametern

Parameter „Directions“ oder „Distance Matrix“ Routes API-Parameter Hinweise
alternatives computeAlternativeRoutes
arrival_time arrivalTime Nicht im selben Modus, sondern nur im TRANSIT-Modus verfügbar als 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.
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. Im Gegensatz dazu Routes API verwenden, stellen die Schritte durchgängig eine Navigationsanweisung dar für alle Arten von Reisen. Jede Navigationsanweisung ist also ein Schritt. Für mehrere Schritte in einer Mobilitätsform bietet die Routes API Metadaten, die eine Zusammenfassung der Schritte für diese Mobilitätsform enthalten, in `stepsOverview`. Verwenden Sie zum Anfordern dieser Metadaten den Feldmaske "routes.legs.stepsOverview". Weitere Informationen
transit_routing_preference transitRoutingPreference Weitere Informationen
units Nicht verfügbar für Route Matrix.
waypoints intermediates codierte Polylinien werden nicht mehr unterstützt.
optimize=true für Wegpunkte "optimizeWaypointOrder": "true" Weitere Informationen

Antwortparameter-Conversions

Parameter „Directions“ oder „Distance Matrix“ Routes API-Parameter Hinweise
copyrights

Nicht in der Antwort enthalten. Sie müssen die folgende Erklärung angeben, wenn Sie den Nutzern die Ergebnisse anzeigen:

Powered by Google, ©YEAR Google

Beispiel:

Powered by Google, ©2022 Google
distance distanceMeters Die Entfernung ist nur in Metern verfügbar.
duration_in_traffic duration Verwenden Sie duration, um in der Routes API entfernt zu werden.
status Nicht verfügbar. Verwenden Sie die HTTP-Antwortcodes für Fehler, die von der API gemeldet werden. Siehe Anfragefehler verarbeiten. .
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