Die Routes API bietet eine verbesserte Leistung bei der Berechnung von Wegbeschreibungen, Entfernungen und Reisezeiten. Es lohnt sich also, Apps zu ersetzen, die 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 zwischen der Routes API und den Produkten, die sie ersetzt, erläutert. Außerdem wird beschrieben, wie Sie die erforderlichen Änderungen vornehmen. Weitere Informationen zu anderen Routes API-Funktionen 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 Apps erwarten können.
Höhere Anfragebeschränkungen
| Routes API Compute Route Matrix |
|
| Distance Matrix API |
|
Schnellere Antworten auf Anfragen
Die Funktion „Compute Route Matrix“ bietet folgende Verbesserungen bei der Latenz:
- Streaming-Elemente der Antwort empfangen, bevor die gesamte Matrix berechnet wurde.
- Verwenden Sie Feldmasken, um die Antwortdetails anzupassen und nur die benötigten Daten anzufordern. Das ist eine Best Practice, die auch dazu beiträgt, Ihre Kosten zu senken.
- Erweiterte Routenberechnungen für den Verkehr, damit Sie einen Kompromiss zwischen Datenqualität und Antwortzeit finden können.
Verbesserungen beim Routing
Die Funktion „Route berechnen“ bietet die folgenden Verbesserungen für das Routing:
- Mautinformationen zusätzlich zu Entfernung und voraussichtlicher Ankunftszeit.
- Routen für Zweiräder
- Zwischenziele auf Sicherheit prüfen
- Höhere Genauigkeit bei der voraussichtlichen Ankunftszeit durch Festlegen der Fahrtrichtung und der Straßenseite für Wegpunkte.
Nur die benötigten Daten anfordern
Sie geben jetzt an, welche Felder zurückgegeben werden sollen. Dadurch werden die Verarbeitungszeit und die Abrechnungsgebühren reduziert.
| Routes API Compute Routes Compute Route Matrix |
In Ihren Anfragen muss eine Feldmaske verwendet werden, um anzugeben, welche Felder in der Antwort zurückgegeben werden sollen. Mit der Maskierung von Feldern lässt sich verhindern, dass unnötige Daten angefordert werden, was wiederum hilft, unnötige Verarbeitungszeiten und Gebühren zu vermeiden.
Weitere Informationen finden Sie unter Felder für die Rückgabe auswählen. |
| Directions API Distance Matrix API |
Es wird eine Standardliste von Feldern zurückgegeben, auch wenn Ihre Anwendung diese nicht unbedingt benötigt. Dies kann zu unnötiger Verarbeitungszeit und Abrechnungsgebühren führen. |
Erweiterte Routenberechnungen für den Verkehr
Die Routes API unterstützt drei Routing-Einstellungen, mit denen Sie bei der Anfrage von Verkehrsdaten ein Gleichgewicht zwischen Antwortlatenz und Datenqualität herstellen können.
Weitere Informationen finden Sie unter Qualität und Latenz konfigurieren.
TRAFFIC_UNAWARE (Standard) |
Verwendet zur Berechnung der Route durchschnittliche, zeitunabhängige Verkehrsdaten, keine Echtzeit-Verkehrsdaten. Das führt zu einer minimalen Antwortlatenz. Diese Einstellung entspricht dem Fall, in dem kein Traffic in der Directions API und der Distance Matrix API verwendet wird. |
TRAFFIC_AWARE (neu) |
Leistungsoptimierte Qualität der aktuellen Verkehrslage für geringere Latenz. Im Gegensatz zu TRAFFIC_AWARE_OPTIMAL werden bei dieser Einstellung Optimierungen angewendet, um die Latenz deutlich zu reduzieren.
Diese Einstellung ist auch neu für die Routes API und hat kein Äquivalent in der Directions API oder der Distance Matrix API.
|
TRAFFIC_AWARE_OPTIMAL |
Hochwertige, umfassende Verkehrsdaten. Diese Einstellung führt zur 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 Routingoptionen der Routes API mit denen der Directions API und der Distance Matrix API verglichen.
| Traffic-Option | Routes API | Directions API Distance Matrix API |
Latenz |
|---|---|---|---|
| Keine Echtzeit-Verkehrsinformationen | TRAFFIC_UNAWARE |
departure_time-Property nicht festgelegt |
Die niedrigste Latenz der drei Modi. |
| Aktuelle Verkehrslage berücksichtigt | TRAFFIC_AWARE |
Kein Äquivalent | Neuer Modus, der von der Routes API hinzugefügt wurde. Die Latenz ist etwas höher als bei Die Latenz ist viel geringer als bei |
| Hochwertige, umfassende Live-Verkehrsdaten werden angewendet. | TRAFFIC_AWARE_OPTIMAL |
departure_time Property-Satz |
Entspricht dem Modus, der von maps.google.com und der 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, beschrieben. Außerdem erfahren Sie, wie Sie diese Unterschiede bei der Migration von diesen Diensten in Ihren vorhandenen Anwendungen berücksichtigen können.
Einen statt zwei Dienste aufrufen
| Routes API | Aktivieren Sie in der API Console nur einen Dienst für Ihre App, damit Compute Routes und Compute Route Matrix verwendet werden können.
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 ETA-Antworten
Die Routes API gibt die voraussichtliche Ankunftszeit zurück und verwendet die Antwortproperty duration anders als die Dienste der Directions API und Distance Matrix API, wie in der Tabelle unten dargestellt.
| Art der voraussichtlichen Ankunftszeit | Routes API | Directions API Distance Matrix API |
|---|---|---|
| Voraussichtliche Ankunftszeit ohne Berücksichtigung der Verkehrslage und unabhängig von der Uhrzeit. | Mit
|
Entspricht dem Fall, dass
|
| Voraussichtliche Ankunftszeit unter Berücksichtigung der aktuellen Verkehrslage. | Legen Sie dafür
|
Wird in der Anfrage mit
|
Polylinien-Wegpunkte
Mit diesem Dienst müssen Sie Ihre Breiten-/Längengradkoordinaten nicht mehr in Polylinien-Wegpunkte umwandeln. Er unterstützt einen POST-Anfragebody und ist daher nicht mehr von URL-String-Beschränkungen betroffen. Einige Nutzer der Distance Matrix API haben das Problem mit den Anfragelimits behoben, indem sie Breiten-/Längengradpunkte in Polylinien-Wegpunkte umgewandelt haben.
Formatierte Adressen (umgekehrte Geocodierung)
Die Routes API gibt keine formatierten Adressen in der Antwort zurück. Wenn Sie formatierte Adressen benötigen, verwenden Sie die Geocoding API. Sie wurde für diesen Anwendungsfall entwickelt und liefert qualitativ hochwertigere Ergebnisse.
Verfügbare Mobilitätsformen
Wie bei der Directions API wird auch bei der Routes API „DRIVE“ als Standardmodus verwendet, wenn in einer Routenanfrage kein Mobilitätsmodus angegeben ist. Wenn in einer Anfrage jedoch eine Mobilitätsform für eine Route angegeben ist, gibt die Routes API kein Array mit verfügbaren Mobilitätsformen als alternative Optionen für die Anfrage zurück. Wenn Ihr Anwendungsfall auf dieser Funktion basiert, erstellen Sie ein Problem, in dem Sie beschreiben, wie Sie die Funktion verwenden, damit wir uns darum kümmern können.
XML als Antwortformat
Die Routes API bietet kein XML als Antwortformat. Im Internet finden Sie eine Reihe von JSON-zu-XML-Konvertern, die für Ihre Zwecke geeignet sein sollten.