Die Routes API bietet eine verbesserte Leistung bei der Berechnung von Wegbeschreibungen, Entfernungen und Fahrtzeiten. Daher lohnt es sich, Anwendungen zu ersetzen, die derzeit die Directions API und die Distance Matrix API verwenden. Die meisten Funktionen der Routes API sind sowohl mit der Directions API als auch mit der Distance Matrix API abwärtskompatibel.
In diesem Leitfaden werden die wichtigsten Unterschiede der Routes API im Vergleich zu den Produkten beschrieben, die sie ersetzt. Außerdem erfahren Sie, wie Sie mit den erforderlichen Änderungen umgehen sollten. Weitere Informationen zu anderen Funktionen der Routes API finden Sie in der Produktübersicht.
Wichtige Verbesserungen
In diesem Abschnitt werden einige der Verbesserungen beschrieben, die Sie bei der Verwendung der Routes API in Ihren Anwendungen erwarten können.
Höhere Anfragelimits
| Routes API |
|
| Distance Matrix API |
|
Schnellere Antwortanfragen
Die Berechnung der Route Matrix bietet folgende Latenzverbesserungen:
- Streamingelemente der Antwort empfangen, bevor die gesamte Matrix berechnet wurde.
- Verwenden Sie Feldmasken, um die Antwortdetails anzupassen. Fordern Sie nur die benötigten Daten an. Dies ist eine Best Practice, mit der Sie auch Ihre Kosten senken können.
- Erweiterte Routenberechnungen für den Verkehr, damit Sie einen Kompromiss zwischen Datenqualität und Reaktionszeit finden können.
Verbesserungen beim Routing
Die Funktion für die Routenberechnung bietet folgende Verbesserungen beim Routing:
- Mautinformationen zusätzlich zur Entfernung und voraussichtlichen Ankunftszeit.
- Routen für Motorräder.
- Weisen Sie Ihre Wegpunkte mit Zwischenstopps für die Sicherheit ein.
- Erhöhte Genauigkeit der voraussichtlichen Ankunftszeit durch Festlegen der Fahrtrichtung und Straßenseite für Wegpunkte.
Nur die benötigten Daten anfordern
Sie geben jetzt an, welche Felder zurückgegeben werden sollen, um die Verarbeitungszeit und die Kosten zu reduzieren.
| Routes API | In Ihren Anfragen muss eine Feldmaske verwendet werden, um anzugeben, welche Felder in der Antwort zurückgegeben werden sollen. Durch die Maskierung von Feldern wird sichergestellt, dass keine unnötigen Daten angefordert werden. So werden unnötige Verarbeitungszeiten und Gebühren vermieden.
Weitere Informationen finden Sie unter Felder für die Rückgabe auswählen. |
| Directions API Distance Matrix API |
Gibt eine Standardliste von Feldern zurück, auch wenn Ihre Anwendung diese nicht unbedingt benötigt. Dies kann zu unnötigen Verarbeitungszeiten und Gebühren führen. |
Erweiterte Routenberechnungen für den Verkehr
Die Routes API unterstützt drei Routingeinstellungen, mit denen Sie beim Anfordern von Trafficinformationen ein Gleichgewicht zwischen Antwortlatenz und Datenqualität herstellen können.
Weitere Informationen finden Sie unter Qualität oder Latenz konfigurieren.
TRAFFIC_UNAWARE (Standard) |
Zur Berechnung der Route werden durchschnittliche zeitunabhängige Verkehrsdaten und keine Live-Verkehrsdaten verwendet. Dies führt zu einer geringeren Antwortlatenz. Diese Einstellung entspricht der Einstellung, wenn in der Directions API und der Distance Matrix API kein Verkehr verwendet wird. |
TRAFFIC_AWARE (neu) |
Leistungsoptimierte Qualität des Live-Traffics für geringere Latenz. Im Gegensatz zu TRAFFIC_AWARE_OPTIMAL werden mit dieser Einstellung Optimierungen vorgenommen, um die Latenz erheblich zu reduzieren.
Diese Einstellung ist auch für die Routes API neu und es gibt keine Entsprechung in der Directions API oder der Distance Matrix API.
|
TRAFFIC_AWARE_OPTIMAL |
Hochwertige und umfassende Zugriffsdaten Diese Einstellung führt zu der höchsten Latenz und entspricht der Einstellung departure_time in der Directions API und der Distance Matrix API. Diese Einstellung entspricht dem Modus, der von maps.google.com und der mobilen Google Maps App verwendet wird. |
Vergleich der Routenberechnung
In der folgenden Tabelle werden die Routenoptionen zwischen der Routes API und den Diensten Directions API und Distance Matrix API verglichen.
| Traffic-Option | Routes API | Directions API Distance Matrix API |
Latenz |
|---|---|---|---|
| Keine Echtzeitinformationen zur Verkehrslage | TRAFFIC_UNAWARE |
Property „departure_time“ nicht festgelegt |
Schnellste Latenz der drei Modi. |
| Aktuelle Verkehrslage angewendet | TRAFFIC_AWARE |
Kein Äquivalent | Neuer Modus durch die Routes API. Sie bietet eine etwas höhere Latenz als Sie hat eine viel niedrigere Latenz als |
| Umfassende und hochwertige Live-Traffic-Daten wurden angewendet. | TRAFFIC_AWARE_OPTIMAL |
departure_time-Property-Gruppe |
Entspricht dem Modus, der von maps.google.com und der mobilen Google Maps App verwendet wird. Bei Compute Route Matrix darf die Anzahl der Elemente in einer Anfrage (Anzahl der Startorte × Anzahl der Ziele) nicht höher als 100 sein. |
Wichtige Unterschiede
In diesem Abschnitt werden die wichtigsten Unterschiede zwischen der Routes API und den Diensten beschrieben, die sie ersetzt. Außerdem erfahren Sie, wie Sie diese Unterschiede beheben können, wenn Sie von diesen Diensten in Ihren vorhandenen Anwendungen migrieren.
Nur einen Dienst statt zwei aufrufen
| Routes API | Aktivieren Sie in der API Console nur einen Dienst für Ihre App, um Compute Routes und Compute Route Matrix zu verwenden.
Weitere Informationen finden Sie unter Einrichtung in der Google API Console. |
| Directions API Distance Matrix API |
Aktivieren Sie zwei Dienste: die Directions API und die Distance Matrix API als separate Dienste in der API Console. |
Verwendet HTTPS POST-Anfragen
| Routes API | Übergeben Sie Parameter im Anfragetext oder in Headern als Teil einer HTTP POST-Anfrage. Beispiele finden Sie unter: – Route berechnen – Routenmatrix berechnen |
| Directions API Distance Matrix API |
Übergeben Sie URL-Parameter mit einer HTTP GET-Anfrage. |
Unterschiede bei der Antwort auf erweiterte Textanzeigen
Die Routes API gibt die ETA zurück und verwendet die duration-Antworteigenschaft anders als die Directions API- und die Distance Matrix API-Dienste (siehe Tabelle unten).
| Art der voraussichtlichen Ankunftszeit | Routes API | Directions API Distance Matrix API |
|---|---|---|
| Traffic nicht bekannt, zeitunabhängige Ankunftszeit. | Mit
|
Entspricht, dass
|
| ETA, bei der Verkehrsinformationen in Echtzeit berücksichtigt werden. | Legen Sie ihn mit
|
Wird mit
|
Polylinien-Wegpunkte
Mit diesem Dienst müssen Sie Ihre Breiten- und Längengradkoordinaten nicht mehr in Polylinien-Wegpunkte konvertieren. Der Dienst unterstützt einen POST-Anfragetext und ist daher nicht mehr von URL-String-Limits betroffen. Einige Nutzer der Distance Matrix API haben das Problem mit den Anfragelimits gelöst, indem sie Breiten- und Längengradpunkte in Polylinien-Wegpunkte konvertiert haben.
Formatierte Adressen (umgekehrte Geocodierung)
Die Routes API stellt in der Antwort keine formatierten Adressen bereit. Verwenden Sie zum Abrufen formatierter Adressen die Geocoding API, die für diesen Anwendungsfall entwickelt wurde und qualitativ hochwertigere Ergebnisse liefert.
Verfügbare Mobilitätsformen
Wie bei der Directions API verwendet die Routes API DRIVE als Standardmodus, wenn in einer Routenanfrage keine Mobilitätsform angegeben ist. Wird in einer Anfrage jedoch eine Mobilitätsform für eine Route angegeben, gibt die Routes API kein Array der verfügbaren Mobilitätsformen als alternative Auswahlmöglichkeiten für die Anfrage zurück. Wenn Ihr Anwendungsfall diese Funktion erfordert, melden Sie ein Problem, in dem Sie beschreiben, wie Sie die Funktion verwenden, damit wir das Problem weiter untersuchen können.
XML als Antwortformat
Die Routes API stellt kein XML als Antwortformat zur Verfügung. Im Internet finden Sie eine Reihe von Convertern für JSON in XML, die für Ihre Zwecke geeignet sind.