Standorte für eine Route angeben

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 Zielort können Sie verschiedene Arten von Wegpunkten und die Verarbeitung von Wegpunkten für eine Route angeben. Weitere Informationen und Beispiele finden Sie in den folgenden Themen:

Standorte für eine Route angeben

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

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

Verwenden Sie aus Effizienz- und Genauigkeitsgründen Orts-IDs anstelle von Breiten-/Längengraden oder Adressstrings. Orts-IDs sind eindeutig und bieten Vorteile beim Geocoding für die Routenplanung, z. B. Zugangspunkte und Verkehrsvariablen. Sie helfen, die folgenden Situationen zu vermeiden, die durch andere Möglichkeiten zur Angabe eines Standorts entstehen können:

  • Wenn Sie Breiten- und Längengrade verwenden, kann es passieren, dass der Standort an der Straße angedockt wird, die diesen Koordinaten am nächsten liegt. Dies ist möglicherweise nicht der Zugang zur Unterkunft oder eine 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 umzuwandeln, bevor eine Route berechnet werden kann. Diese Conversion kann sich auf die Leistung auswirken.

Ort als Orts-ID angeben

Sie können eine Orts-ID verwenden, um den Standort eines Wegpunkts anzugeben. Da Breiten- und Längengrade an Straßen angedockt sind, können Sie unter Umständen mit einer Orts-ID bessere Ergebnisse erzielen.

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

Im folgenden Beispiel wird mit der Property placeId eine Orts-ID sowohl für origin als auch für destination übergeben:

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

Einen Standort als Koordinaten für Breiten- und Längengrad angeben

Wenn Sie den Standort in einem Wegpunkt definieren möchten, geben Sie Standort (REST) oder Standort(gRPC) mithilfe von Koordinaten für Längen- und Breitengrad 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
      }
    }
  },
...
}

Ort als Adressstring angeben

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

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

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

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

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

Wenn der Adresswert mehrdeutig ist, ruft die Routes API möglicherweise eine Suche auf, um ähnliche Adressen zu unterscheiden. „1st Street“ kann beispielsweise ein vollständiger Wert 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-/Längengradkoordinaten. Angenommen, Sie stellen eine Anfrage, in der Sie „Toledo“ als Start- und „Madrid“ als Zielort für eine Autoroute angeben:

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

In diesem Beispiel wird „Toledo“ als Stadt im US-Bundesstaat Ohio und nicht in Spanien interpretiert. Daher gibt die Anfrage ein leeres Array zurück, 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. Geben Sie dazu den Parameter regionCode an. Dieser Parameter gibt den Regionscode als zweistelligen Wert für die Ländercode der Top-Level-Domain (ccTLD) an. Die meisten ccTLD-Codes entsprechen den ISO 3166-1-Codes, mit einigen Ausnahmen. So lautet beispielsweise die ccTLD des Vereinigten Königreichs „uk“ (.co.uk), der ISO 3166-1-Code dagegen „gb“ (technisch für die Entität „Vereinigtes Königreich von Großbritannien und Nordirland“).

Eine Wegbeschreibungsanfrage von „Toledo“ nach „Madrid“ mit dem Parameter regionCode liefert die richtigen Ergebnisse, 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, die von Toledo, Spanien, nach Madrid, Spanien, berechnet wurde:

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

Einen Ort als Plus Code angeben

Viele Menschen haben keine genaue Adresse, was die Zustellung von Sendungen erschweren kann. Personen mit einer Adresse möchten Lieferungen möglicherweise an einem bestimmten Ort entgegennehmen, z. B. an einer Hintertür oder einem Verladedock.

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-/Längengraden und werden als Zahlen und Buchstaben angezeigt.

Google hat Plus Codes entwickelt, um allen und allem die Vorteile von Adressen zu bieten. 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. Sie können Plus Codes als Ersatz für Adressen verwenden, 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 sein:

  • Ein Global Code besteht aus einer vierstelligen Ortsvorwahl 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“. Verwenden Sie dann den gesamten Pluscode mit 10 Ziffern, 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“. Geben Sie bei einer zusammengesetzten Adresse den Ortscode mit dem Teil der Adresse mit Stadt, Bundesstaat, Postleitzahl und Land in der Form „CRHJ+C3 Stanford, CA 94305, USA“ an.

    Sie können beispielsweise eine Route berechnen, indem Sie mithilfe von Plus Codes einen Wegpunkt für die Route origin und destination 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 die Autovervollständigung von Orten, die Ortsdetails, die Directions API und die Geocoding API. Sie können die Geocoding API beispielsweise verwenden, um die umgekehrte Geocodierung eines durch Breiten- und Längengradkoordinaten angegebenen Standorts durchzuführen, um die Plus-Code-Adresse des Standorts zu ermitteln.