Von der Directions API (alte Version) oder der Distance Matrix API (alte Version) migrieren

Entwickler im Europäischen Wirtschaftsraum (EWR)

In dieser Anleitung wird beschrieben, wie Sie Apps, die entweder die Directions API oder die Distance Matrix API verwenden, zur Verwendung der Routes API migrieren. Weitere Informationen zur Routes API finden Sie in der Produktübersicht.

Best Practices für die Abrechnung bei der Migration

Diese Anleitung gilt, wenn Ihre API-Nutzung so hoch ist, dass Sie in die zweite Preisstufe wechseln. Wenn Sie zu einer neueren Version einer API migrieren, wird Ihnen auch eine andere SKU in Rechnung gestellt. Um höhere Kosten während des Übergangsmonats zu vermeiden, empfehlen wir, so bald wie möglich zu Beginn des Monats zu den neuen APIs in der Produktion zu wechseln. So erreichen Sie während des Migrationsmonats die kostengünstigsten monatlichen Preisstufen. Informationen zu den Preisstufen finden Sie auf der Preisseite und in den FAQs zu den Preisen.

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 für die Verwendung eines HTTPS-Anfragetexts konvertieren

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 in einem Anfragetext oder in Headern als Teil einer HTTP POST-Anfrage. Beispiele:

Polylinien-codierte Wegpunkte in Standortwegpunkte konvertieren

Die Angabe von Wegpunkten als codierte Polylinien ist in der Directions API (Legacy) verfügbar, um eine große Anzahl von Wegpunkten in das URL-Limit von 16.384 Zeichen zu passen. Diese Funktion ist in der Routes API nicht erforderlich, da Wegpunkte im REST- oder gRPC-Anfragetext als Breiten-/Längenkoordinaten übertragen werden können. Beispiele finden Sie im HTTP-Beispiel im Dokument Routenmatrix berechnen oder unter Zwischenwegpunkt definieren im Dokument Zwischenwegpunkte angeben.

Parameter konvertieren

In den folgenden Tabellen sind Parameter in der Directions API und der Distance Matrix API aufgeführt, die umbenannt oder geändert wurden, oder Parameter, die in der GA-Version nicht unterstützt werden. Aktualisieren Sie Ihren Code, wenn Sie einen dieser Parameter verwenden.

Konvertierungen von Anfrageparametern

Parameter für Directions oder Distanzmatrix Parameter für die Routes API Hinweise
alternatives computeAlternativeRoutes
arrival_time arrivalTime Nur im Modus TRANSIT und nicht gleichzeitig mit departureTime verfügbar.
avoid routeModifiers
departure_time departureTime Kann nicht gleichzeitig mit arrivalTime verwendet werden.
language languageCode Nur für „Compute Routes“ unterstützt.
mode travelMode

Unterstützung für TWO_WHEELER und TRANSIT hinzugefügt.
region regionCode
traffic_model trafficModel Weitere Informationen
transit_mode "travelMode": "TRANSIT" In der Directions API (Legacy) wird bei einer Route mit öffentlichen Verkehrsmitteln jedes Segment einer Fahrt mit demselben Verkehrsmittel (z. B. zu Fuß oder mit öffentlichen Verkehrsmitteln) als ein Schritt betrachtet. Einzelne Wegbeschreibungen für dieses Verkehrsmittel befinden sich in Unterschritten. Im Gegensatz dazu sind Schritte in der Routes API einheitlich eine Navigationsanweisung für alle Arten von Reisen. Jede Navigationsanweisung ist also ein Schritt. Für mehrere Schritte in einem Verkehrsmittel stellt die Routes API Metadaten bereit, die eine Zusammenfassung der Schritte für dieses Verkehrsmittel in `stepsOverview` enthalten. Um diese Metadaten anzufordern, verwenden Sie die `routes.legs.stepsOverview` Feldmaske. Weitere Informationen.
transit_routing_preference transitRoutingPreference Weitere Informationen
units units Weitere Informationen
waypoints intermediates Unterstützung für codierte Polylinien entfernt.
optimize=true für Wegpunkte "optimizeWaypointOrder": "true" Weitere Informationen

Konvertierungen von Antwortparametern

Parameter für Directions oder Distanzmatrix Parameter für die Routes API Hinweise
copyrights

Nicht in der Antwort enthalten. Sie müssen die folgende Erklärung einfügen, wenn Sie die Ergebnisse Ihren Nutzern präsentieren:

Powered by Google, ©YEAR Google

Beispiel:

Powered by Google, ©2022 Google
distance distanceMeters Entfernung ist nur in Metern verfügbar.
duration_in_traffic duration In der Routes API entfernt, verwenden Sie duration.
status Nicht verfügbar. Verwenden Sie die HTTP-Antwortcodes für Fehler, die von der API gemeldet werden. Weitere Informationen finden Sie unter Anfragenfehler behandeln.
geocoded_waypoints geocoding_results Nur für „Compute Routes“ unterstützt. Enthält nur Geocoding-Antwortinformationen für Wegpunkte, die als Adressen angegeben wurden.
bounds viewport
legs.end_address Nicht verfügbar.

Verwenden Sie Orts-IDs anstelle von Koordinaten für eine hochgenaue Routenplanung. Orts-IDs enthalten Daten, mit denen die Route an die richtigen Zugangspunkte angehängt wird.

  • Wenn Sie mit einer Adresse beginnen: Verwenden Sie Place Autocomplete oder die Geocoding API, um sie in eine Orts-ID aufzulösen.
  • Wenn Sie mit Koordinaten beginnen: Verwenden Sie die Suche nach Zielen, um einen aussagekräftigeren Standort anzugeben. Eine Adresse aus Koordinaten zu ermitteln, kann komplex sein und zu einer falschen Zuordnung führen. Die Routes API führt keine umgekehrte Geocodierung von Koordinaten in Adressen durch.
legs.start_address Nicht verfügbar.
overview_polyline Polylinie
summary description
waypoint_order optimizedIntermediateWaypointIndex