Die Routes API bietet eine verbesserte Leistung bei der Berechnung von Wegbeschreibungen, Entfernungen und Reisezeiten. Daher lohnt es sich, Apps 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 dieser Anleitung werden die wichtigsten Unterschiede der Routes API im Vergleich zu den Produkten, die sie ersetzt, erläutert. Außerdem erfahren Sie, wie Sie mit erforderlichen Änderungen umgehen. Weitere Informationen zu anderen Features der Routes API finden Sie in der Produktübersicht.
Wichtigste Verbesserungen
In diesem Abschnitt werden einige der Verbesserungen beschrieben, die Sie bei der Verwendung der Routes API in Ihren Anwendungen erwarten können.
Anfragelimits erhöht
| Routes API |
|
| Distance Matrix API |
|
Schnellere Anfrageantworten
Die Compute-Route-Matrix-Funktion bietet die folgenden Latenzverbesserungen:
- Streamingelemente der Antwort empfangen, bevor die gesamte Matrix berechnet wurde.
- Verwenden Sie Feldmasken, um die Antwortdetails anzupassen, indem Sie nur die benötigten Daten anfordern. Dies ist eine Best Practice, mit der Sie auch Ihre Kosten senken können.
- Erweiterte Routenberechnungen für den Verkehr, um einen Kompromiss zwischen Datenqualität und Antwortzeit zu finden.
Verbesserungen beim Routing
Das Compute-Route-Feature bietet folgende Routing-Verbesserungen:
- Informationen zu Mautgebühren sowie Entfernung und voraussichtliche Ankunftszeit.
- Routen mit 2-Rad-Fahrzeugen.
- Wegpunkte mit Zwischenstopps qualifizieren
- Höhere Genauigkeit der voraussichtlichen Ankunftszeit durch Festlegen der Fahrtrichtung und der Straßenseite für Wegpunkte.
Nur die Daten anfordern, die Sie benötigen
Sie legen jetzt fest, welche Felder zurückgegeben werden sollen. Dadurch werden die Verarbeitungszeit und die Kosten reduziert.
| Routes API | In Ihren Anfragen müssen Sie eine Feldmaske verwenden, um anzugeben, welche Felder in der Antwort zurückgegeben werden sollen. Durch die Feldmaskierung wird sichergestellt, dass keine unnötigen Daten angefordert werden. Dadurch werden unnötige Verarbeitungszeit und Kosten 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 diese für Ihre App nicht unbedingt erforderlich sind. Dies kann zu unnötiger Verarbeitungszeit und Kosten führen. |
Verbesserte Routenberechnungen für Traffic
Die Routes API unterstützt drei Routingeinstellungen, mit denen Sie ein Gleichgewicht zwischen Antwortlatenz und Datenqualität beim Anfordern von Trafficinformationen finden können.
Weitere Informationen finden Sie unter Qualität und Latenz konfigurieren.
TRAFFIC_UNAWARE (Standard) |
Zur Berechnung der Route werden durchschnittliche zeitunabhängige Verkehrsdaten und keine Live-Verkehrsdaten verwendet. Dies führt zu einer niedrigsten 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 reduzierte Latenz Im Gegensatz zu TRAFFIC_AWARE_OPTIMAL werden bei dieser Einstellung Optimierungen angewendet, um die Latenz erheblich zu verringern.
Diese Einstellung ist auch für die Routes API neu. In der Directions API oder der Distance Matrix API gibt es keine Entsprechung.
|
TRAFFIC_AWARE_OPTIMAL |
Qualitativ hochwertige und umfassende Verkehrsdaten. Diese Einstellung erzeugt die höchste 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 Google Maps App verwendet wird. |
Vergleich der Routenberechnung
In der folgenden Tabelle werden die Routingoptionen der Routes API, der Directions API und der Distance Matrix API-Dienste verglichen.
| Traffic-Option | Routes API | Directions API Distance Matrix API |
Latenz |
|---|---|---|---|
| Kein Verkehr in Echtzeit | TRAFFIC_UNAWARE |
departure_time-Property nicht festgelegt |
Schnellste Latenz der drei Modi. |
| Aktuelle Verkehrslage wird angewendet | TRAFFIC_AWARE |
Kein Äquivalent | Neuer Modus von der Routes API. Sie bietet eine etwas höhere Latenz als Sie hat eine viel niedrigere Latenz als |
| Qualitativ hochwertige, umfassende Live-Traffic-Daten wurden angewendet. | TRAFFIC_AWARE_OPTIMAL |
departure_time Property festgelegt |
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) 100 nicht überschreiten. |
Wichtige Unterschiede
In diesem Abschnitt werden die wichtigsten Unterschiede zwischen der Routes API und den Diensten, die sie ersetzt, erläutert. Außerdem erfahren Sie, wie Sie diese bei der Migration von diesen Diensten in Ihren vorhandenen Anwendungen beheben können.
Einen Dienst statt zwei aufrufen
| Routes API | Aktivieren Sie in der API Console nur einen Dienst für Ihre Anwendung, um Compute Routes und Compute Route Matrix zu verwenden.
Weitere Informationen findest du unter Einrichtung in der Google API Console. |
| Directions API Distance Matrix API |
Aktivieren Sie zwei Dienste: die Directions API und die Distance Matrix API in der API Console als separate Dienste. |
Verwendet HTTPS POST-Anfragen
| Routes API | Übergeben Sie Parameter im Anfragetext oder in Headern als Teil einer HTTP POST-Anfrage. Beispiele: – Route berechnen – Routenmatrix berechnen |
| Directions API Distance Matrix API |
Übergeben Sie URL-Parameter mit einer HTTP GET-Anfrage. |
Unterschiede bei Antworten für erweiterte Textanzeigen
Die Routes API gibt die ETA zurück und verwendet die duration-Antworteigenschaft anders als die Directions API- und Distance Matrix API-Dienste (siehe Tabelle unten).
| Art der voraussichtlichen Ankunftszeit | Routes API | Directions API Distance Matrix API |
|---|---|---|
| Traffic, der bei der voraussichtlichen Ankunftszeit nicht berücksichtigt wird | Mit
|
Entspricht, wenn
|
| Voraussichtliche Ankunftszeit, bei der Echtzeitdaten zur Verkehrslage berücksichtigt werden. | Festgelegt mit
|
Legen Sie den Wert mit
|
Polylinien-Wegpunkte
Sie müssen mit diesem Dienst Ihre Breiten-/Längengradkoordinaten nicht mehr in Polylinien-Wegpunkte konvertieren. Er unterstützt POST-Anfragetext und ist daher nicht mehr von Beschränkungen für URL-Strings betroffen. Einige Nutzer der Distance Matrix API haben das Problem mit den Anfragelimits behoben, indem Breiten- und Längengradpunkte in Polylinien-Wegpunkte konvertiert wurden.
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. Wenn in einer Anfrage jedoch eine Mobilitätsform für eine Route angegeben ist, gibt die Routes API kein Array verfügbarer Mobilitätsformen als alternative Auswahlmöglichkeiten für die Anfrage zurück. Wenn Ihr Anwendungsfall auf diese Funktion basiert, melden Sie ein Problem und beschreiben Sie, wie Sie die Funktion verwenden, damit wir den Fall weiter verfolgen können.
XML als Antwortformat
Die Routes API stellt kein XML als Antwortformat bereit. Im Internet findest du eine Reihe von JSON-zu-XML-Konvertern, die für deine Zwecke geeignet sind.