Standorte für eine Route angeben

Entwickler im Europäischen Wirtschaftsraum (EWR)

Um eine Route zu berechnen, müssen Sie mindestens den Start- und Zielort der Route angeben. Sie definieren diese Orte als Wegpunkte auf der Route.

Neben Start und Ziel können Sie verschiedene Arten von Wegpunkten angeben und festlegen, wie Wegpunkte für eine Route behandelt werden sollen. Weitere Informationen und Beispiele finden Sie in den folgenden Themen:

Orte für eine Route angeben

Sie stellen einen Ort dar, indem Sie ein Waypoint-Objekt (REST) oder ein Waypoint-Objekt (gRPC) erstellen. In der Wegpunktdefinition können Sie einen Ort auf eine der folgenden Arten angeben:

Sie können Standorte für alle Wegpunkte in einer Anfrage auf dieselbe Weise angeben oder sie mischen. Sie können beispielsweise Breiten-/Längenkoordinaten für den Start-Waypoint und eine Orts-ID für den Ziel-Waypoint verwenden.

Verwenden Sie zur Effizienz und Genauigkeit Orts-IDs anstelle von Breiten-/Längengradkoordinaten oder Adressstrings. Orts-IDs sind eindeutig und bieten Vorteile für das Geocoding für das Routing, z. B. für Zugangspunkte und Verkehrsvariablen. Sie helfen, die folgenden Situationen zu vermeiden, die sich aus anderen Möglichkeiten zur Angabe eines Standorts ergeben können:

  • Wenn Sie Breiten- und Längengradkoordinaten verwenden, wird der Standort möglicherweise auf die Straße in der Nähe dieser Koordinaten ausgerichtet. Das ist aber möglicherweise kein Zugangspunkt zum Grundstück oder keine Straße, die schnell oder sicher zum Ziel führt.
  • Adressstrings müssen zuerst von der Routes API geocodiert werden, um sie in Breiten- und Längengradkoordinaten zu konvertieren, bevor eine Route berechnet werden kann. Diese Umstellung kann sich auf die Leistung auswirken.

Ort als Orts-ID angeben

Sie können eine Orts-ID verwenden, um den Ort eines Wegpunkts anzugeben. Da Breiten- und Längengradkoordinaten an Straßen ausgerichtet werden, kann eine Orts-ID unter Umständen bessere Ergebnisse liefern.

Orts-IDs aus der Geocoding API und der Places API (einschließlich Place Autocomplete) abrufen Weitere Informationen zu Orts-IDs finden Sie in der Übersicht zur Orts-ID.

Im folgenden Beispiel wird das Attribut placeId verwendet, um eine Orts-ID für origin und destination zu übergeben:

{
  "origin":{
    "placeId": "ChIJayOTViHY5okRRoq2kGnGg8o"
  },
  "destination":{
    "placeId": "ChIJTYKK2G3X5okRgP7BZvPQ2FU"
  },
  ...
}

Standort als Breiten- und Längengrad angeben

Wenn Sie den Standort in einem Wegpunkt definieren möchten, geben Sie den Standort (REST) oder Standort(gRPC) mit Breiten- und Längengradkoordinaten an.

Geben Sie beispielsweise einen Wegpunkt für die Route origin und destination mit den Koordinaten latitude und longitude an:

{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
...
}

Standort als Adressstring angeben

Adressstrings sind Adressen, die durch einen String dargestellt werden (z. B. „1600 Amphitheatre Parkway, Mountain View, CA“). Beim Geocoding wird eine Adresszeichenfolge in Breiten- und Längengrade umgewandelt, z. B. in Breitengrad 37.423021 und Längengrad -122.083739.

Wenn Sie einen Adressstring als Standort eines Wegpunkts übergeben, wird der String intern von der Routes API geocodiert, um ihn in Breiten- und Längengradkoordinaten zu konvertieren.

Wenn Sie beispielsweise eine Route berechnen möchten, geben Sie einen Wegpunkt für die Route origin und destination mithilfe von Adressstrings an:

{
  "origin":{
    "address": "1600 Amphitheatre Parkway, Mountain View, CA"
  },
  "destination":{
    "address": "450 Serra Mall, Stanford, CA 94305, USA"
  },
  ...
}

In diesem Beispiel werden beide Adressen von der Routes API geocodiert, um sie in Breiten- und Längengradkoordinaten umzuwandeln.

Wenn der Adresswert mehrdeutig ist, kann die Routes API eine Suche aufrufen, um ähnliche Adressen zu unterscheiden. „1st Street“ könnte beispielsweise ein vollständiger oder ein Teilwert für „1st Street NE“ oder „1st St SE“ sein. Dieses Ergebnis kann sich von dem unterscheiden, das von der Geocoding API zurückgegeben wird. Mit Orts-IDs können Sie mögliche Fehlinterpretationen vermeiden.

Region für die Adresse festlegen

Wenn Sie einen unvollständigen Adressstring als Standort eines Wegpunkts übergeben, verwendet die API möglicherweise die falschen geocodierten Breiten- und Längengradkoordinaten. Sie stellen beispielsweise eine Anfrage, in der Sie „Toledo“ als Start- und „Madrid“ als Zielort für eine Route mit dem Auto angeben:

{
  "origin":{
    "address": "Toledo"
  },
  "destination":{
    "address": "Madrid"
  },
  "travelMode": "DRIVE"
}

In diesem Beispiel wird „Toledo“ als Stadt im Bundesstaat Ohio in den USA interpretiert, nicht in Spanien. Daher wird mit der Anfrage ein leeres Array zurückgegeben, was bedeutet, dass keine Routen vorhanden sind:

{
  []
}

Sie können die API so konfigurieren, dass Ergebnisse zurückgegeben werden, die nach einer bestimmten Region gewichtet sind. Fügen Sie dazu den Parameter regionCode ein. Mit diesem Parameter wird der Regionscode als zweistelliger Wert der Ländercode der Top-Level-Domain (ccTLD) angegeben. Die meisten ccTLD-Codes entsprechen den ISO 3166-1-Codes. Es gibt jedoch einige Ausnahmen. Die ccTLD des Vereinigten Königreichs ist beispielsweise „uk“ (.co.uk), der ISO 3166-1-Code lautet „gb“ (technisch für das Land „Vereinigtes Königreich Großbritannien und Nordirland“).

Eine Anfrage für die Wegbeschreibung von „Toledo“ nach „Madrid“, die den Parameter regionCode enthält, gibt passende Ergebnisse zurück, da „Toledo“ als Stadt in Spanien interpretiert wird:

{
  "origin":{
    "address": "Toledo"
  },
  "destination":{
    "address": "Madrid"
  },
  "travelMode": "DRIVE",
  "regionCode": "es"
}

Die Antwort enthält jetzt die Route von Toledo nach Madrid in Spanien:

{
  "routes": [
    {
      "distanceMeters": 75330,
      "duration": "4137s",
      ...
    }
  ]
}

Ort als Plus Code angeben

Viele Menschen haben keine genaue Adresse, was es ihnen erschweren kann, Lieferungen zu erhalten. Oder Personen mit einer Adresse möchten Lieferungen möglicherweise an bestimmten Orten entgegennehmen, z. B. an einem Hintereingang oder einer Laderampe.

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.

Google hat Plus Codes entwickelt, um allen und allem die Vorteile von Adressen zu ermöglichen. Ein Plus Code ist ein codierter Verweis auf den Standort, der sich aus den Koordinaten (Breiten- und Längengrad) ableiten lässt und einen Bereich definiert: 1/8.000stel eines Grades mal 1/8.000stel eines Grades (ca. 14 m × 14 m am Äquator) oder kleiner. Plus Codes können als Ersatz für Adressen verwendet werden, wenn keine Adressen vorhanden sind, z. B. wenn Gebäude keine Hausnummern oder Straßen keine Namen haben.

Plus Codes müssen als globaler oder als zusammengesetzter Code formatiert werden:

  • Ein Global Code besteht aus einem vierstelligen Code für das Gebiet und einem mindestens sechsstelligen lokalen Code.

    Für die Adresse „1600 Amphitheatre Parkway, Mountain View, CA“ lautet der globale Code beispielsweise „849V“ und der lokale Code „CWC8+R9“. Sie verwenden dann den gesamten 10‑stelligen Plus Code, um den Standortwert als „849VCWC8+R9“ anzugeben.

  • Ein Compound Code besteht aus einem mindestens sechsstelligen lokalen Code in Kombination mit einem expliziten Ort.

    Die Adresse „450 Serra Mall, Stanford, CA 94305, USA“ hat beispielsweise den lokalen Code „CRHJ+C3“. Bei einer zusammengesetzten Adresse kombinieren Sie den lokalen Code mit dem Teil der Adresse, der Stadt, Bundesstaat, Postleitzahl und Land enthält, z. B. „CRHJ+C3 Stanford, CA 94305, USA“.

    Sie können beispielsweise eine Route berechnen, indem Sie einen Wegpunkt für die Route origin und destination mit Plus Codes angeben:

    {
  "origin":{
    "address": "849VCWC8+R9"
  },
  "destination":{
    "address": "CRHJ+C3 Stanford, CA 94305, USA"
  },
  "travelMode": "DRIVE"
}

Plus Codes werden in Google Maps Platform-APIs unterstützt, darunter Place Autocomplete, Place Details, Directions API (Legacy) und Geocoding API. Mit der Geocoding API können Sie beispielsweise einen Standort, der durch Breiten- und Längengradkoordinaten angegeben wird, umgekehrt geocodieren, um den Plus Code des Standorts zu ermitteln.