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 |
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:
Beispiel:
|
|
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 |