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 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

      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".