In dieser Anleitung wird beschrieben, wie Sie Apps, die entweder die Directions API oder die Distance Matrix API verwenden, auf die Routes API umstellen. Weitere Informationen zur Routes API finden Sie in der Produktübersicht.
Best Practices für die Abrechnung bei der Migration
Diese Hinweise gelten, 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 erhöhte Kosten im Monat der Umstellung zu vermeiden, empfehlen wir, so nah wie möglich am Monatsanfang auf die neuen APIs umzustellen. So können Sie im Migrationsmonat die kostengünstigsten monatlichen Preisstufen erreichen. Informationen zu Preisstufen finden Sie auf der Preisseite und in den häufig gestellten Fragen zu Preisen.
REST API-Endpunkte aktualisieren
Code für die Verwendung der neuen Endpunkte der Routes API aktualisieren
Über die 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 für die Verwendung eines HTTPS-Anfragetexts 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 im Anfragetext oder in Headern als Teil einer HTTP POST-Anfrage. Beispiele finden Sie unter:
Polyliniencodierte Wegpunkte in Standortwegpunkte umwandeln
In der Directions API können Wegpunkte als codierte Polylinien angegeben werden, damit eine große Anzahl von Wegpunkten in die URL-Begrenzung von 16.384 Zeichen passt. 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 Eine Routenmatrix berechnen unter HTTP-Beispiel oder im Dokument Wegpunkte angeben unter Wegpunkt 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, oder Parameter, die in der GA-Version nicht unterstützt werden. Aktualisieren Sie Ihren Code, wenn Sie einen dieser Parameter verwenden.
Anfragen mit Parametern – Conversions
| Parameter für Wegbeschreibungen oder Distance Matrix | Routes API-Parameter | Hinweise |
|---|---|---|
alternatives |
computeAlternativeRoutes |
|
arrival_time |
arrivalTime |
Nur im TRANSIT-Modus verfügbar, nicht gleichzeitig mit 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. In der Routes API sind die Schritte dagegen für alle Arten von Fahrten einheitlich. 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 enthalten. Diese finden Sie unter „stepsOverview“. 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 |
Umwandlungen von Antwortparametern
| Parameter für Wegbeschreibungen oder Distance Matrix | Routes API-Parameter | Hinweise |
|---|---|---|
copyrights |
Nicht in der Antwort enthalten. Wenn Sie Nutzern die Ergebnisse anzeigen, muss die folgende Erklärung enthalten sein:
Beispiel:
|
|
distance |
distanceMeters |
Entfernungen sind nur in Metern verfügbar. |
duration_in_traffic |
duration |
In der Routes API entfernt. Verwenden Sie stattdessen 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 beheben. | |
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 |