In diesem Leitfaden wird beschrieben, wie Sie Apps, die die Directions API oder die Distance Matrix API verwenden, mithilfe der 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 Routes API-Endpunkte zu verwenden
Von der Directions API
Directions API | https://maps.googleapis.com/maps/api/directions/outputFormat?parameters |
Routes API | https://routes.googleapis.com/directions/v2:computeRoutes |
Von der 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 so konvertieren, dass sie einen HTTPS-Anfragetext verwenden
Mit der Directions API und der Distance Matrix API übergeben Sie Konfigurationseigenschaften als URL-Parameter an eine HTTP GET
-Anfrage. 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 konvertieren
In der Directions API können Wegpunkte als codierte Polylinien angegeben werden, wenn die URL-Beschränkung auf 16.384 Zeichen sehr viele Wegpunkte umfasst. 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 und im Dokument Wegpunkte zwischen zwei Ebenen angeben unter Wegpunkt zwischengeschaltet.
Parameter konvertieren
In den folgenden Tabellen finden Sie eine Liste der umbenannten oder geänderten Parameter in der Directions API und der Distance Matrix API sowie der Parameter, die in der GA-Version nicht unterstützt werden. Aktualisieren Sie Ihren Code, wenn Sie einen dieser Parameter verwenden.
Conversions von Anfrageparametern
„Directions“- oder „Distance Matrix“-Parameter | 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-Routen 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 betrachtet. Die einzelnen Routen für diese Mobilitätsform sind in Teilschritte. Im Gegensatz dazu sind Schritte in der Routes API durchgängig 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 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 |
Conversions von Antwortparametern
„Directions“- oder „Distance Matrix“-Parameter | Routes API-Parameter | Hinweise |
---|---|---|
copyrights |
Nicht in der Antwort enthalten. Sie müssen die folgende Anweisung einfügen, wenn Sie Ihren Nutzern die Ergebnisse anzeigen:
Beispiel:
|
|
distance |
distanceMeters |
Entfernungen sind nur in Metern verfügbar. |
duration_in_traffic |
duration |
Verwenden Sie duration , wenn es aus der Routes API entfernt wurde. |
status |
Nicht verfügbar. Verwenden Sie die HTTP-Antwortcodes für Fehler, die von der API gemeldet werden. Weitere Informationen finden Sie unter Anfragefehler behandeln. | |
geocoded_waypoints |
geocoding_results |
Wird nur für Compute-Routen unterstützt. Enthält 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 |