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 diesem Leitfaden erfahren Sie, welche wichtigen Unterschiede es zwischen der Routes API und den Produkten gibt, die sie ersetzt, und wie Sie mit den erforderlichen Änderungen umgehen. Weitere Informationen zu den 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 |
|
| Distance Matrix API |
|
Schnellere Antwortzeiten
Die Funktion „Compute Route Matrix“ bietet die folgenden Latenzverbesserungen:
- Streamingelemente der Antwort empfangen, bevor die gesamte Matrix berechnet wurde.
- Verwenden Sie Feldmasken, um die Antwortdetails anzupassen, und fordern Sie nur die Daten an, die Sie benötigen. Dies 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 „Compute Route“ bietet folgende Routing-Optimierungen:
- Zusätzlich zu Entfernung und voraussichtlicher Ankunftszeit werden Mautinformationen angezeigt.
- Routen für Zweiräder
- Qualifizieren Sie Ihre Zwischenstopp-Wegpunkte aus Sicherheitsgründen.
- Die Genauigkeit der voraussichtlichen Ankunftszeit wurde verbessert, indem für Wegpunkte die Fahrtrichtung und Straßenseite festgelegt wurden.
Nur die benötigten Daten anfordern
Sie können jetzt angeben, welche Felder zurückgegeben werden sollen, wodurch die Verarbeitungszeit und die Abrechnungskosten reduziert werden.
| Routes API | In Ihren Anfragen muss eine Feldmaske verwendet werden, um anzugeben, welche Felder in der Antwort zurückgegeben werden sollen. Mit der Feldmaskierung wird verhindert, 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 |
Es wird eine Standardliste von Feldern zurückgegeben, auch wenn diese für Ihre App nicht unbedingt erforderlich sind. Dies kann zu unnötigen Verarbeitungszeiten und Abrechnungskosten führen. |
Erweiterte Routenberechnungen für den Traffic
Die Routes API unterstützt drei Routing-Einstellungen, mit denen Sie beim Anfordern von Verkehrsinformationen einen Kompromiss zwischen Antwortlatenz und Datenqualität finden können.
Weitere Informationen finden Sie unter Qualität und Latenz konfigurieren.
TRAFFIC_UNAWARE (Standard) |
Es werden durchschnittliche zeitunabhängige Verkehrsdaten und keine Live-Verkehrsdaten verwendet, um die Route zu berechnen. Dies führt zu der niedrigsten Antwortlatenz. Diese Einstellung entspricht der Situation, in der keine Verkehrsinformationen in der Directions API und der Distance Matrix API verwendet werden. |
TRAFFIC_AWARE (neu) |
Leistungsoptimierte Live-Traffic-Qualität für eine 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 keine Entsprechung in der Directions API oder der Distance Matrix API.
|
TRAFFIC_AWARE_OPTIMAL |
Hochwertige, umfassende Verkehrsdaten. 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 Google Maps App verwendet wird. |
Vergleich der Routenberechnung
In der folgenden Tabelle werden die Routingoptionen der Routes API mit den Diensten Directions API und Distance Matrix API verglichen.
| Traffic-Option | Routes API | Directions API Distance Matrix API |
Latenz |
|---|---|---|---|
| Keine Echtzeit-Verkehrsinformationen | TRAFFIC_UNAWARE |
departure_time-Attribut 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. Sie bietet eine etwas höhere Latenz als Sie hat eine viel geringere Latenz als |
| Hochwertige, umfassende Echtzeit-Verkehrsdaten werden angewendet | 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 ersetzten Diensten beschrieben. Außerdem erfahren Sie, wie Sie diese Unterschiede bei der Migration von diesen Diensten in Ihren vorhandenen Apps 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 In der Google API Console einrichten. |
| Directions API Distance Matrix API |
Aktivieren Sie zwei Dienste: Directions API und 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: – Eine Route berechnen – Eine Routenmatrix berechnen |
| Directions API Distance Matrix API |
Übergeben Sie URL-Parameter mit einer HTTP GET-Anfrage. |
Unterschiede bei der Antwort zur voraussichtlichen Zeit bis zur Antwort
Die Routes API gibt die geschätzte Ankunftszeit zurück und verwendet die Antworteigenschaft duration anders als die Directions API und die Distance Matrix API, wie in der folgenden Tabelle dargestellt.
| Art der ETA | Routes API | Directions API Distance Matrix API |
|---|---|---|
| Ohne Berücksichtigung der Verkehrslage, zeitunabhängige voraussichtliche Ankunftszeit. | Mit
|
Entspricht dem Umstand, dass
|
| Die voraussichtliche Ankunftszeit, die die Verkehrslage in Echtzeit berücksichtigt. | Legen Sie sie mit
|
Legen Sie 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-Anfragetext und ist daher nicht mehr von URL-Stringbeschrä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 stellt in der Antwort keine formatierten Adressen bereit. Wenn Sie formatierte Adressen abrufen möchten, verwenden Sie die Geocoding API. Diese API wurde für diesen Anwendungsfall entwickelt und liefert qualitativ hochwertigere Ergebnisse.
Verfügbare Mobilitätsformen
Wie bei der Directions API wird in der Routes API „AUTO“ als Standardmodus verwendet, wenn für eine Routenanfrage keine Mobilitätsform angegeben ist. Wenn in einer Anfrage jedoch eine Mobilitätsform für eine Route angegeben ist, gibt die Routes API keine Liste der verfügbaren Mobilitätsformen als alternative Optionen für die Anfrage zurück. Wenn Ihr Anwendungsfall auf dieser Funktion basiert, erheben Sie ein Problem und beschreiben Sie, wie Sie die Funktion verwenden, damit wir uns darum kümmern können.
XML als Antwortformat
Die Routes API bietet XML nicht als Antwortformat an. Es gibt eine Reihe von JSON-zu-XML-Konvertern, die Ihren Anforderungen entsprechen sollten.