Standorte für eine Route angeben

Zum Berechnen einer Route müssen Sie mindestens die Standorte des Start- und Ziels der Route angeben. Sie definieren diese Orte als Wegpunkte auf der Route.

Zusätzlich zu Start- und Zielort können Sie verschiedene Arten von Wegpunkten angeben und angeben, wie Wegpunkte für eine Route gehandhabt werden sollen. Weitere Informationen und Beispiele finden Sie in den folgenden Themen:

Standorte für eine Route angeben

Sie stellen einen Standort dar, indem Sie ein Waypoint (REST)- oder Waypoint (gRPC)-Objekt erstellen. In der Wegpunktdefinition haben Sie folgende Möglichkeiten, einen Standort anzugeben:

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. Das ist möglicherweise nicht der Zugang zur Unterkunft oder nicht die 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"
  },
  ...
}

Standort als 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
      }
    }
  },
...
}

Standort 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, geocodiert die Routes API den String intern, um ihn in Breiten- und Längengradkoordinaten zu konvertieren.

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. Zum Beispiel kann "1st Street" 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 lassen sich 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. 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 eine Stadt im Bundesstaat Ohio in den Vereinigten Staaten, 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 Region gewichtet sind. Geben Sie dazu den Parameter regionCode an. Dieser Parameter gibt den Regionscode als zweistelligen ccTLD-Wert ("top-level domain") an. Die meisten ccTLD-Codes entsprechen den ISO 3166-1-Codes, mit einigen Ausnahmen. So lautet beispielsweise der ccTLD-Code des Vereinigten Königreichs „uk“ (.co.uk) und der ISO 3166-1-Code „gb“ (technisch für die Rechtspersönlichkeit „The United Kingdom of Great Britain and Northern Ireland“).

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 Lieferungen erschweren kann. Oder Personen mit einer Adresse bevorzugen die Annahme von Lieferungen an spezifischeren Orten, z. B. am Hintereingang oder am Ladedock.

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

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

    Beispiel: Die Adresse „450 Serra Mall, Stanford, CA 94305, USA“ hat 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. Mit der Geocoding API können Sie beispielsweise die umgekehrte Geocodierung eines durch Breiten- und Längengradkoordinaten angegebenen Standorts durchführen, um die Plus-Code-Adresse des Standorts zu ermitteln.