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

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

Ü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. Für 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.

Konvertierungen von Anfrageparametern

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 Wird nur für Compute Routes unterstützt.
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 werden in einer Route für öffentliche Verkehrsmittel Abschnitt einer Fahrt mit der gleichen Mobilitätsform (z. B. zu Fuß oder mit öffentlichen Verkehrsmitteln) betrachtet wird, gilt als eine einzelne Route die Mobilitätsform in Teilschritten. Im Gegensatz dazu Routes API 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. Folgende Angaben sind erforderlich: wenn die Ergebnisse für Ihre Nutzenden angezeigt werden:

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 Wird nur für Compute Routes unterstützt. Enthält nur Geocoding-Antwortinformationen nur für Wegpunkte, die als Adressen angegeben wurden.
bounds viewport
legs.end_address Nicht verfügbar.
legs.start_address Nicht verfügbar.
overview_polyline Polylinie
summary description
waypoint_order optimizedIntermediateWaypointIndex