Aus dem Vorschau-Release migrieren

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 Release für die allgemeine Verfügbarkeit migrieren.

Neue Funktionen im GA-Release

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

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

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

      Mit Adressstrings geben Nutzer oft eine Adresse ein. {product_name} muss jedoch zuerst den Adressstring 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

      Plus Codes sind wie Adressen von Personen oder Orten, die keine Adresse haben. Anstelle von Adressen mit Straßennamen und Zahlen 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 (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ängenkoordinaten angegeben wurden, werden ignoriert.

Änderungen an vorhandenen Vorschaufunktionen

Sie müssen jetzt die folgenden Funktionen in GA 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:

  • 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ückgeben soll.

Was sollte ich wissen?

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

  • travelAdvisory.tollInfo (Gebühreninformationen)

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

  • routes.legs.travelAdvisory.tollInfo(Gebühreninformationen)
  • routes.travelAdvisory.tollInfo(Gebühreninformationen)
  • 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 Mautgebühren, Kraftstoffverbrauch oder Verkehr auf einer Polylinie erhalten möchten, müssen Sie das neue Anfragearrayfeld extraComputations auf einen oder mehrere der folgenden Werte festlegen:

  • Wenn Sie Mautinformationen erhalten möchten, setzen Sie das neue Array-Feld extraComputations auf "TOLLS".

  • Um den Kraftstoffverbrauch zu erhalten, 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".