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

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

Neue Funktionen in der allgemein verfügbaren Version

In der GA-Version wurden die folgenden neuen Features hinzugefügt, die nicht in der Vorschau enthalten waren:

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

    • Adressstrings („Chicago, IL“ oder „Darwin, NT, Australien“)

      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 wurde Unterstützung für den Anfrageparameter regionCode hinzugefügt. Damit können Sie angeben, 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. Plus Codes basieren nicht auf Adressen mit Straßennamen und Hausnummern, sondern auf Breiten- und Längengraden und werden als Zahlen und Buchstaben angezeigt.

  • Die compute routes response enthält jetzt das Array geocodingResults. Für jeden Ort in der Anfrage (Start, Ziel oder Zwischenwegpunkt), 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 als Breiten-/Längengradkoordinaten angegeben sind, werden ignoriert.

Änderungen an bestehenden Funktionen in der Vorabversion

Sie müssen die folgenden Funktionen jetzt explizit in GA aktivieren, indem Sie das neue Arrayfeld extraComputations in die Anfrage einfü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 Anfrageparameter extraComputations-Array 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 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 Anfrage-Arrayfeld extraComputations auf einen oder mehrere der folgenden Werte festlegen: