Aus dem Vorschau-Release migrieren

Entwickler im Europäischen Wirtschaftsraum (EWR)

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 den Beschreibungen der Startphase.

In diesem Abschnitt wird beschrieben, wie Sie eine App von der Vorschauversion zur GA-Version migrieren.

Neue Funktionen in der GA-Version

Die GA-Version enthält die folgenden neuen Funktionen, die in der Vorschauversion nicht enthalten waren:

  • Neben Orts-IDs und Breiten-/Längengradkoordinaten können Sie in der GA-Version jetzt auch einen Standort angeben, indem Sie Folgendes verwenden:

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

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

      Außerdem wurde die Unterstützung für den Anfrageparameter regionCode hinzugefügt, 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 für Personen oder Orte, 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 auf die Routenberechnung enthält jetzt das geocodingResults Array. Für jeden Standort in der Anfrage (Startpunkt, Ziel oder Zwischenziel), der als Adress string 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 als Breiten-/Längengradkoordinaten angegeben wurden, werden ignoriert.

Änderungen an vorhandenen Vorschaufunktionen

Sie müssen die folgenden Funktionen jetzt explizit in der GA-Version aktivieren, indem Sie der Anfrage das neue Arrayfeld extraComputations hinzufügen:

In der Vorschauversion haben Sie eine Feldmaske verwendet, um anzugeben, dass Informationen zu diesen Funktionen in der Antwort zurückgegeben werden sollen. Jetzt müssen Sie beides tun:

  • Legen Sie den neuen Anfrageparameter extraComputations fest, um diese Funktionen zu aktivieren.
  • Legen Sie eine Feldmaske fest, um anzugeben, dass die Informationen in der Antwort zurückgegeben werden sollen.

Was sollte ich wissen?

Die folgenden Felder sind nicht mehr in den Antworten von „computeRouteMatrix“ enthalten, es sei denn, sie werden explizit durch Festlegen von extraComputations aktiviert:

  • travelAdvisory.tollInfo (Mautinformationen)

Die folgenden Felder sind nicht mehr in den Antworten von „computeRoutes“ enthalten , es sei denn, sie werden explizit durch Festlegen von extraComputations aktiviert:

  • 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 Anfragearrayfeld extraComputations so festlegen, dass es einen oder mehrere der folgenden Werte enthält:

  • Wenn Sie Mautinformationen erhalten möchten, legen Sie das neue extraComputations Arrayfeld auf "TOLLS" fest.

  • Wenn Sie Informationen zum Kraftstoffverbrauch erhalten möchten, legen Sie das neue extraComputations Arrayfeld auf "FUEL_CONSUMPTION" fest.

  • Wenn Sie Verkehrsinformationen auf Polylinien erhalten möchten, legen Sie das neue extraComputations Arrayfeld auf "TRAFFIC_ON_POLYLINE" fest.