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