In diesem Leitfaden wird beschrieben, wie Sie Apps, die entweder die Directions API oder die Distance Matrix API verwenden, zur 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 Endpunkte der Routes API 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 werden Konfigurationseigenschaften als URL-Parameter an eine HTTP GET
-Anfrage übergeben. Für die Directions API gilt beispielsweise Folgendes:
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
In der Directions API können Sie Wegpunkte als codierte Polylinien angeben, damit eine große Anzahl von Wegpunkten in das URL-Limit von 16.384 Zeichen passt. Diese Funktion ist in der Routes API nicht erforderlich, da Wegpunkte im REST- oder gRPC-Anfragetext als Breiten-/Längengradkoordinaten übertragen werden können. Beispiele finden Sie im HTTP-Beispiel im Dokument Routenmatrix berechnen oder unter Zwischenwegpunkt definieren im Dokument Wegpunkte angeben.
Parameter konvertieren
In den folgenden Tabellen sind Parameter in der Directions API und Distance Matrix API aufgeführt, die umbenannt oder geändert wurden, sowie Parameter, die in der GA-Version nicht unterstützt werden. 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 |
Nur im TRANSIT -Modus und nicht gleichzeitig mit departureTime verfügbar. |
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 wird bei einer Route für öffentliche Verkehrsmittel jedes Segment einer Fahrt mit derselben Mobilitätsform (z. B. zu Fuß oder mit öffentlichen Verkehrsmitteln) als ein Schritt angesehen. Die einzelnen Routen für diese Mobilitätsform werden in Teilschritten behandelt. In der Routes API hingegen sind Schritte durchweg eine Navigationsanweisung für alle Arten von Fahrten. Jede Navigationsanweisung ist also ein Schritt. Für mehrere Schritte in einer Mobilitätsform stellt die Routes API Metadaten bereit, die eine Zusammenfassung der Schritte für diese Mobilitätsform in „stepsOverview“ enthalten. Verwenden Sie die Feldmaske „routes.legs.stepsOverview“, um diese Metadaten anzufordern. 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. Du musst die folgende Anweisung einschließen, wenn du den Nutzern die Ergebnisse zeigst:
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 wurden. Weitere Informationen finden Sie unter 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 |