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

Entwickler im Europäischen Wirtschaftsraum (EWR)

In diesem Leitfaden wird beschrieben, wie Sie Anwendungen, die die Directions API oder die Distance Matrix API verwenden, zur 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 hoch genug ist, um in die zweite Preisstufe zu wechseln. Wenn Sie zu einer neueren Version einer API migrieren, wird Ihnen auch eine andere SKU in Rechnung gestellt. Um höhere Kosten im Monat der Umstellung zu vermeiden, empfehlen wir, die neuen APIs in der Produktion möglichst am Anfang des Monats zu aktivieren. So erreichen Sie im Migrationsmonat die kostengünstigsten monatlichen Preisstufen. Informationen zu den Preisstufen finden Sie auf der Preisseite und in den häufig gestellten Fragen zu Preisen.

REST API-Endpunkte aktualisieren

Aktualisieren Sie Ihren Code, um die neuen Endpunkte der Routes API zu verwenden.

Aus der Directions API

Directions API https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Routes API https://routes.googleapis.com/directions/v2:computeRoutes

Aus 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 in einen HTTPS-Anfragetext konvertieren

Bei 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

Bei der Routes API übergeben Sie Parameter in einem Anfragetext oder in Headern als Teil einer HTTP POST-Anfrage. Beispiele finden Sie unter:

Polylinien-codierte Wegpunkte in Standortwegpunkte umwandeln

In der Directions API (Legacy) können Sie Wegpunkte als codierte Polylinien angeben, um eine große Anzahl von Wegpunkten in die URL-Beschränkung von 16.384 Zeichen einzufügen. Diese Funktion ist in der Routes API nicht erforderlich, da Wegpunkte im REST- oder gRPC-Anfragetext als Breiten- und Längengradkoordinaten übertragen werden können. Beispiele finden Sie im Dokument Routenmatrix berechnen unter HTTP-Beispiel oder im Dokument Zwischenwegpunkte angeben unter Zwischenwegpunkt definieren.

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, sowie Parameter, die in der GA-Version nicht unterstützt werden. Aktualisieren Sie Ihren Code, wenn Sie einen dieser Parameter verwenden.

Anfrageparameter-Conversions

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

Wird im HTTP-POST-JSON-Anfragetext computeRoutes oder computeRouteMatrix mit RouteTravelMode-Werten (DRIVE, TWO_WHEELER, WALK, TRANSIT, TRUCK oder BICYCLE für computeRoutes) anstelle eines GET-URL-Suchparameters übergeben. Unterstützung für TWO_WHEELER, TRANSIT und TRUCK 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 Reisemodus (z. B. zu Fuß oder mit öffentlichen Verkehrsmitteln) als ein Schritt betrachtet. Die einzelnen Wegbeschreibungen für diesen Reisemodus befinden sich in Unterschritten. In der Routes API hingegen ist ein Schritt bei allen Mobilitätsformen immer eine Navigationsanweisung. Jede Navigationsanweisung ist also ein Schritt. Wenn mehrere Schritte in einem Reisemodus enthalten sind, stellt die Routes API in `stepsOverview` Metadaten mit einer Zusammenfassung der Schritte für diesen Reisemodus bereit. Verwenden Sie die Feldmaske `routes.legs.stepsOverview`, um diese Metadaten anzufordern. Weitere Informationen
transit_routing_preference transitRoutingPreference Weitere Informationen
units units Weitere Informationen
waypoints intermediates Die Unterstützung für codierte Polylinien wurde entfernt.
optimize=true für Wegpunkte "optimizeWaypointOrder": "true" Weitere Informationen

Antwortparameter-Conversions

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

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

Powered by Google, ©YEAR Google

Beispiel:

Powered by Google, ©2022 Google
distance distanceMeters Die 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 Anfragefehler verarbeiten.
geocoded_waypoints geocoding_results Wird nur für Compute-Routen 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 für ein hochpräzises Routing Orts-IDs anstelle von Koordinaten. Orts-IDs enthalten Daten, mit denen die Route an die richtigen Zugangspunkte angepasst 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 Option Nach Zielen suchen, um einen aussagekräftigeren Ort anzugeben. Das einfache Abrufen einer Adresse aus Koordinaten kann komplex sein und zu einer falschen Einrastung 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