Die Routes API bietet eine verbesserte Leistung bei der Berechnung von Wegbeschreibungen, Entfernung und Fahrzeit. 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 dieser Anleitung erfahren Sie mehr über die wichtigsten Unterschiede zwischen der Routes API und den Produkten, die sie ersetzt, sowie darüber, wie Sie notwendige Änderungen vornehmen. 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 Apps erwarten können.
Erhöhte Anfragelimits
| Routes API Compute Route Matrix |
|
| Distance Matrix API |
|
Schnellere Antworten auf Anfragen
Die Funktion „Compute Route Matrix“ bietet die folgenden 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 Daten anzufordern, die Sie benötigen. Das ist eine Best Practice, die auch dazu beiträgt, Ihre Kosten zu senken.
- Erweiterte Routenberechnungen für den Verkehr, damit Sie zwischen Datenqualität und Reaktionszeit abwägen können.
Verbesserungen beim Routing
Die Funktion „Route berechnen“ bietet die folgenden Verbesserungen beim Routing:
- Mautinformationen zusätzlich zu Entfernung und voraussichtlicher Ankunftszeit.
- Routen für Zweiräder
- Zwischenziele auf Sicherheit prüfen
- Höhere Genauigkeit der voraussichtlichen Ankunftszeit durch Festlegen der Fahrtrichtung und Straßenseite für Wegpunkte.
Nur die benötigten Daten anfordern
Sie können jetzt angeben, 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. Durch die 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 Zurückzugebende Felder auswählen. |
| Directions API Distance Matrix API |
Gibt eine Standardliste von Feldern zurück, auch wenn Ihre App diese nicht unbedingt benötigt. Dies kann zu unnötiger Verarbeitungszeit und unnötigen Abrechnungsgebühren führen. |
Erweiterte Routenberechnungen für den Verkehr
Die Routes API unterstützt drei Routing-Einstellungen, mit denen Sie beim Anfordern 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) |
Für die Berechnung der Route werden durchschnittliche zeitunabhängige Verkehrsdaten verwendet, nicht Live-Verkehrsdaten. Dadurch wird die Reaktionslatenz minimiert. Diese Einstellung entspricht dem Fall, in dem kein Verkehr in der Directions API und der Distance Matrix API verwendet wird. |
TRAFFIC_AWARE (neu) |
Leistungsoptimierte Live-Verkehrsinformationen für geringere Latenz. Im Gegensatz zu TRAFFIC_AWARE_OPTIMAL werden bei dieser Einstellung Optimierungen angewendet, um die Latenz erheblich 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 Routing-Optionen 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 Verkehrsinformationen in Echtzeit | TRAFFIC_UNAWARE |
departure_time-Property nicht festgelegt |
Die niedrigste Latenz der drei Modi. |
| Aktuelle Verkehrslage angewendet | 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 | TRAFFIC_AWARE_OPTIMAL |
departure_time Property-Set |
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, sowie Möglichkeiten beschrieben, wie Sie diese Unterschiede bei der Migration von diesen Diensten in Ihren bestehenden Apps berücksichtigen können.
Nur einen Dienst anrufen
| 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 Directions API und die Distance Matrix API-Dienste, wie in der Tabelle unten dargestellt.
| Art der erweiterten Textanzeige | Routes API | Directions API Distance Matrix API |
|---|---|---|
| Verkehrsunabhängige, zeitunabhängige voraussichtliche Ankunftszeit. | Wird mit
|
Entspricht dem Fall, dass
|
| Voraussichtliche Ankunftszeit unter Berücksichtigung der Verkehrslage in Echtzeit. | Legen Sie die Einstellung mit
|
Wird in der Anfrage mit
|
Polylinien-Wegpunkte
Mit diesem Dienst müssen Sie Ihre Breiten-/Längenkoordinaten nicht mehr in Polylinien-Wegpunkte umwandeln. Er unterstützt einen POST-Anfragetext 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 bei der Routes API DRIVE als Standardmodus verwendet, wenn in einer Routenanfrage keine Mobilitätsform angegeben ist. Wenn in einer Anfrage jedoch eine Mobilitätsform für eine Route angegeben wird, 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, reichen Sie ein Problem ein, 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 Ihren Anforderungen entsprechen sollten.