Standorte für eine Route angeben

Zum Berechnen einer Route müssen Sie mindestens die Standorte des Start- und Zielorts der Route angeben. Diese Orte legen Sie als Wegpunkte auf der Route fest.

Neben Start- und Zielort können Sie verschiedene Arten von Wegpunkten angeben und angeben, wie Wegpunkte für eine Route zu behandeln sind. Weitere Informationen und Beispiele finden Sie in den folgenden Themen:

Standorte für eine Route angeben

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

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

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

  • Die Verwendung von Breiten- und Längengradkoordinaten kann dazu führen, dass der Standort an der Straße ausgerichtet wird, die diesen Koordinaten am nächsten liegt. Dabei handelt es sich möglicherweise nicht um einen Zugangspunkt zum Grundstück oder um 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ängengrade umzuwandeln, bevor eine Route berechnet werden kann. Diese Conversion kann sich auf die Leistung auswirken.

Standort 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 ausgerichtet sind, liefert eine Orts-ID unter Umständen bessere Ergebnisse.

Orts-IDs aus der Geocoding API und der Places API (einschließlich Place Autocomplete) abrufen Weitere Informationen

Im folgenden Beispiel wird die Eigenschaft placeId verwendet, um eine Orts-ID sowohl für origin als auch für destination zu übergeben:

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

Standort als Breiten- und Längengrad angeben

Wenn Sie den Standort als Wegpunkt definieren möchten, geben Sie den Standort (REST) oder Location(gRPC) mithilfe von Breiten- und Längengradkoordinaten an.

Sie können beispielsweise einen Wegpunkt für die Routen origin und destination mit den Koordinaten latitude und longitude angeben:

{
  "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ängengradkoordinaten umgewandelt (z. B. 37.423021 und Längengrad -122.083739).

Wenn Sie einen Adressstring als Standort eines Wegpunkts übergeben, geocodiert die Routes API den String intern, um ihn in Breiten- und Längengrade umzuwandeln.

Zur Berechnung einer Route geben Sie beispielsweise einen Wegpunkt für die Routen 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 geocodiert die Routes API beide Adressen, um sie in Breiten- und Längengrade umzuwandeln.

Wenn der Adresswert mehrdeutig ist, ruft die Routes API möglicherweise eine Suche auf, um ähnliche Adressen zu unterscheiden. So könnte "1st Street" ein vollständiger Wert oder ein Teilwert für "1st Street NE" oder "1st Street SE" sein. Dieses Ergebnis kann sich von dem von der Geocoding API zurückgegebenen Ergebnis unterscheiden. Sie können mögliche Fehlinterpretationen durch die Verwendung von Orts-IDs 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. Sie stellen beispielsweise eine Anfrage und geben „Toledo“ als Startort und „Madrid“ als Ziel für eine Autoroute an:

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

In diesem Beispiel wird "Toledo" als Stadt im Bundesstaat Ohio in den USA und nicht als Stadt in Spanien interpretiert. Daher gibt die Anfrage ein leeres Array zurück, d. h., es gibt keine Routen:

{
  []
}

Sie können die API so konfigurieren, dass nach bestimmten Regionen gewichtete Ergebnisse zurückgegeben werden. Dazu fügen Sie den Parameter regionCode ein. Mit diesem Parameter wird der Regionscode als zweistelliger ccTLD-Wert („Top-Level-Domain“) angegeben. Die meisten ccTLD-Codes sind mit ISO 3166-1-Codes identisch. Es gibt jedoch einige Ausnahmen. Die ccTLD des Vereinigten Königreichs lautet beispielsweise „uk“ (.co.uk), während der ISO 3166-1-Code „gb“ lautet (technisch für die Rechtspersönlichkeit „The United Kingdom of Great Britain and Northern Ireland“).

Eine Routenanfrage von „Toledo“ nach „Madrid“, die den Parameter regionCode enthält, gibt entsprechende 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 berechnete Route von Toledo (Spanien) nach Madrid:

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

Ort als Plus Code angeben

Viele Nutzer haben keine genaue Adresse, was den Empfang von Lieferungen erschweren kann. Oder Personen mit einer Adresse, die Lieferungen an bestimmten Orten annehmen möchten, z. B. an einem Hintereingang oder einer Ladedock.

Plus Codes sind wie Adressen für Personen oder Orte, die keine tatsächliche Adresse haben. Anstelle von Adressen mit Straßennamen und Nummern basieren Plus Codes auf Breiten- und Längengradkoordinaten und werden als Zahlen und Buchstaben angezeigt.

Google hat Plus Codes entwickelt, damit jeder von den Vorteilen einer Adresse profitieren kann. Ein Plus Code ist ein codierter Standortverweis, der aus Breiten- und Längengradkoordinaten abgeleitet wird und ein Gebiet darstellt, nämlich 1/8.000. eines Grades mal 1/8.000. eines Grads (ca. 14 m x 14 m auf dem Äquator) oder kleiner. Sie können Plus Codes als Ersatz für Adressen an Orten verwenden, an denen es keine gibt, Gebäude nicht nummeriert oder Straßen nicht benannt sind.

Plus Codes müssen als globalen oder zusammengesetzten Code formatiert sein:

  • Ein Globaler Code besteht aus einem vierstelligen Ortscode 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“. Anschließend verwenden Sie den gesamten 10-stelligen Plus Code, um den Wert für den Standort als „849VCWC8+R9“ anzugeben.

  • Ein zusammengesetzter 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 kombinierten Adresse kombinieren Sie den lokalen Code mit der Stadt, dem Bundesland, der Postleitzahl und dem Länderteil der Adresse im Format „CRHJ+C3 Stanford, CA 94305, USA“.

    Zur Berechnung einer Route geben Sie beispielsweise mithilfe von Plus Codes einen Wegpunkt für die Routen origin und destination an:

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

Plus Codes werden in den Google Maps Platform APIs unterstützt, darunter Place Autocomplete, Place Details, Directions API und Geocoding API. Mit der Geocoding API können Sie beispielsweise das Geocoding eines Standorts, der durch Breiten- und Längengradkoordinaten angegeben wurde, rückgängig machen, um den Plus Code des Standorts zu ermitteln.