Aus dem Vorschau-Release migrieren

Die Routes API wurde im September 2022 als öffentliche Vorabversion (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 vom Vorabversion zum GA-Release migrieren.

Neue Funktionen im GA-Release

Im GA-Release werden die folgenden neuen Funktionen hinzugefügt, die nicht in der Vorabversion enthalten waren:

  • Neben Orts-IDs und Breiten-/Längengradkoordinaten können Sie jetzt im GA-Release (GA) einen Standort angeben. Dazu verwenden Sie Folgendes:

    • Adressstrings ("Chicago, IL" oder "Darwin, NT, Australia")

      Adressstrings sind oft die Art und Weise, wie Nutzer eine Adresse eingeben. {product_name} muss den Adressstring jedoch zuerst intern geocodieren, um ihn in Breiten- und Längengradkoordinaten zu konvertieren, bevor eine Route berechnet werden kann.

      Außerdem wird der Anfrageparameter regionCode unterstützt, mit dem Sie angeben können, dass geocodierte Ergebnisse für eine bestimmte geografische Region zurückgegeben werden sollen.

    • Plus Codes

      Plus Codes sind wie Adressen von Personen oder Orten, die keine tatsächliche Adresse haben. Anstelle von Adressen mit Straßennamen und Hausnummern basieren Plus Codes auf Breiten- und Längengraden 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 (Start-, Zielort oder Zwischenwegpunkt), der als Adressstring oder Plus Code angegeben wurde, führt die API eine Orts-ID-Suche durch. Jedes Element dieses Arrays enthält die Orts-ID für einen Standort sowie zusätzliche Metadaten zum Standort. Orte, die in der Anfrage als Orts-ID oder als Breiten- und Längengradkoordinaten angegeben sind, werden ignoriert.

Änderungen an vorhandenen Vorschaufunktionen

Sie müssen jetzt die folgenden Funktionen in Google Analytics explizit aktivieren, indem Sie der Anfrage das neue Array-Feld extraComputations hinzufügen:

In der Vorabversion haben Sie eine Feldmaske verwendet, um anzugeben, dass Informationen zu diesen Funktionen in der Antwort zurückgegeben werden sollen. 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 angegeben werden soll, um die Informationen in der Antwort zurückzugeben.

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 (Mautinformationen)

Die folgenden Felder sind nicht mehr in computeRoutes-Antworten enthalten, sofern sie nicht explizit durch Festlegen von extraComputations aktiviert werden:

  • routes.legs.travelAdvisory.tollInfo(Mautinformationen)
  • routes.travelAdvisory.tollInfo(Mautinformationen)
  • 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 Anfragearray-Feld extraComputations auf einen oder mehrere der folgenden Werte festlegen: