Die Routes API wurde im September 2022 als öffentliche Vorschau (pre-GA) veröffentlicht. Pre-GA-Angebote sind durch die dienstspezifischen Nutzungsbedingungen für die Google Maps Platform abgedeckt. Weitere Informationen finden Sie unter Beschreibungen der Startphase.
In diesem Abschnitt wird beschrieben, wie Sie eine App von der Vorabversion zum GA-Release migrieren.
Neue Funktionen im GA-Release
Der GA-Release enthält die folgenden neuen Funktionen, die nicht in der Vorschau enthalten waren:
Neben Orts-IDs und Breiten- und Längengradkoordinaten können Sie jetzt im GA-Release einen Standort angeben:
Adressstrings ("Chicago, IL" oder "Darwin, NT, Australien")
Mit Adressstrings geben Nutzer oft eine Adresse ein. Allerdings muss {product_name} den Adressstring zuerst intern geocodieren, um ihn in Breiten- und Längengradkoordinaten umzuwandeln, bevor eine Route berechnet werden kann.
Außerdem wird der Anfrageparameter
regionCode
unterstützt, mit dem Sie geocodierte Ergebnisse für eine bestimmte Region angeben können.-
Plus Codes sind wie Adressen für Personen oder Orte, die keine richtige Adresse haben. Anstelle von Adressen mit Straßennamen und -nummern basieren Plus Codes auf Breiten- und Längengrad und werden als Zahlen und Buchstaben angezeigt.
Die Antwort für Compute-Routen enthält jetzt das Array
geocodingResults
. Für jeden Standort in der Anfrage (Startort, Ziel oder Wegpunkt), der als Adressstring oder als Plus Code angegeben wurde, führt die API eine Orts-ID-Suche durch. Jedes Element dieses Arrays enthält die Orts-ID, die einem Standort entspricht, sowie zusätzliche Metadaten zum Standort. Standorte in der Anfrage, die als Orts-ID oder Breiten-/Längenkoordinaten angegeben wurden, werden ignoriert.
Änderungen an vorhandenen Vorschaufunktionen
Sie müssen jetzt die folgenden Funktionen explizit aktivieren, indem Sie der Anfrage das neue Array-Feld extraComputations
hinzufügen:
In der Vorabversion haben Sie eine Feldmaske verwendet, um in der Antwort Informationen zu diesen Funktionen zurückzugeben. Jetzt müssen Sie Folgendes tun:
- Legen Sie den neuen Array-Anfrageparameter
extraComputations
fest, um diese Funktionen zu aktivieren. - Legen Sie eine Feldmaske fest, die die Informationen in der Antwort zurückgibt.
Was sollte ich wissen?
Die folgenden Felder sind nicht mehr in computeRouteMatrix-Antworten enthalten, sofern sie nicht explizit durch Festlegen von extraComputations
aktiviert werden:
travelAdvisory.tollInfo
(Gebühreninformationen)
Die folgenden Felder sind nicht mehr in computeRoutes-Antworten enthalten, sofern sie nicht explizit durch Festlegen von extraComputations
aktiviert werden:
routes.legs.travelAdvisory.tollInfo
(Informationen zu Mautgebühren)routes.travelAdvisory.tollInfo
(Informationen zu Mautgebühren)routes.travelAdvisory.fuelConsumptionMicroliters
(Kraftstoffverbrauch)routes.travelAdvisory.speedReadingIntervals
(Verkehr auf einer Polylinie)routes.legs.travelAdvisory.speedReadingIntervals
(Verkehr auf einer Polylinie)
Was muss ich tun?
Wenn Sie die Antwortfelder für Mautinformationen, Kraftstoffverbrauch oder Verkehr auf einer Polylinie erhalten möchten, müssen Sie das neue Feld für das Anfragearray (extraComputations
) so festlegen, dass es einen oder mehrere der folgenden Werte enthält:
Wenn Sie Mautinformationen erhalten möchten, setzen Sie das neue Array-Feld
extraComputations
auf"TOLLS"
.Wenn Sie den Kraftstoffverbrauch abrufen möchten, setzen Sie das neue Arrayfeld
extraComputations
auf"FUEL_CONSUMPTION"
.Wenn Sie Verkehrsinformationen zu Polylinien erhalten möchten, setzen Sie das neue Arrayfeld
extraComputations
auf"TRAFFIC_ON_POLYLINE"
.