Standorte für eine Route angeben

Zum Berechnen einer Route müssen Sie mindestens die Standorte des Start- und Ziels der Route angeben. Diese Orte definieren Sie 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:

• Richtung und seitliche Straßen des Fahrzeugs angeben
• Wegpunkte angeben
• Stopp entlang einer Route festlegen
• Punkt für eine Route festlegen
• Reihenfolge der Haltestellen auf Ihrer Route optimieren

Standorte für eine Route angeben

Zur Darstellung eines Standorts erstellen Sie ein Objekt vom Typ Wegpunkt (REST) oder Wegpunkt (gRPC). In der Wegpunktdefinition haben Sie folgende Möglichkeiten, einen Standort anzugeben:

• Place ID (bevorzugt)
• Koordinaten (Breiten- und Längengrad)
• Adressstring ("Chicago, IL" oder "Darwin, NT, Australien")
• Plus Code

Sie können Standorte für alle Wegpunkte in einer Anfrage auf die gleiche Weise angeben oder beides kombinieren. Sie können beispielsweise Breiten- und Längengradkoordinaten für den Startwegpunkt 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 Routen wie Zugangspunkte und Verkehrsvariablen. Damit lassen sich die folgenden Situationen vermeiden, die sich aus anderen Möglichkeiten zur Angabe eines Standorts ergeben können:

• Bei Verwendung von Breiten- und Längengradkoordinaten wird der Ort möglicherweise an der Straße ausgerichtet, die diesen Koordinaten am nächsten liegt. Das ist unter Umständen kein Zugangspunkt zum Grundstück oder sogar eine Straße, die schnell oder sicher zum Ziel führt.
• Adressstrings müssen zuerst von der Routes API geocodiert werden, damit sie vor der Routenberechnung in Breiten- und Längengrade umgewandelt werden können. 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 werden, 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 zu Orts-IDs finden Sie unter Orts-IDs.

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

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

Standort in Form von Breiten- und Längengraden angeben

Wenn Sie einen Standort in einem Wegpunkt definieren möchten, geben Sie den Location (REST) oder Location(gRPC) mithilfe von 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
      }
    }
  },
...
}

Hinweis:Die durch Breiten- und Längengrade angegebenen Punkte sind an Straßen ausgerichtet und entsprechen möglicherweise nicht der für Ihre App erforderlichen Genauigkeit. Verwenden Sie Breiten- und Längengradkoordinaten, wenn Sie sicher sind, dass die Werte die Punkte angeben, die Ihre App für die Routenplanung benötigt, ohne dabei mögliche Zugangspunkte oder zusätzliche Geocoding-Details zu berücksichtigen.

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

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

Hinweis:Die Breiten- und Längengradkoordinaten können sich von den Koordinaten unterscheiden, die von der Geocoding API zurückgegeben werden. So kann es beispielsweise sein, dass die Routes API Koordinaten für den Eingang eines Gebäudes und nicht für seinen Mittelpunkt zurückgibt.

Wenn Sie beispielsweise eine Route berechnen möchten, geben Sie mithilfe von Adressstrings einen Wegpunkt für die Route origin und destination 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 und wandelt sie in Breiten- und Längengrade um.

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 Ergebnis 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 und geben „Toledo“ als Startort und „Madrid“ als Ziel einer Autoroute an:

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

In diesem Beispiel wird "Toledo" als eine Stadt im Bundesstaat Ohio in den USA, 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 nach bestimmten Regionen gewichtete Ergebnisse zurückgegeben werden. Dazu fügen Sie den Parameter regionCode ein. 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 Routenanfrage von „Toledo“ nach „Madrid“, die den Parameter regionCode enthält, gibt entsprechende Ergebnisse zurück, da „Toledo“ in Spanien als Stadt 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, Spanien:

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

Standort 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 von Personen oder Orten, 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, um allen Nutzern den Nutzen von Adressen zu bieten. Ein Plus Code ist eine codierte Standortreferenz, die von Breiten- und Längengradkoordinaten abgeleitet wird und einen Bereich repräsentiert: 1/8.000. Grad mal 1/8.000. Grad (ca. 14 m x 14 m am Äquator) oder kleiner. Sie können Plus Codes als Ersatz für Adressen an Orten verwenden, an denen sie nicht vorhanden sind, oder an denen Gebäude nicht nummeriert oder Straßen nicht benannt sind.

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

• Ein globaler Code besteht aus einer vierstelligen Vorwahl und einer mindestens sechsstelligen Ortsvorwahl.

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

• Ein zusammengesetzter Code besteht aus einem mindestens 6 Zeichen langen Lokalcode in Kombination mit einem expliziten Ort.

  Beispiel: Die Adresse „450 Serra Mall, Stanford, CA 94305, USA“ hat den lokalen Code „CRHJ+C3“. Für eine kombinierte Adresse kombinieren Sie den lokalen Code mit dem Ort, dem Bundesstaat, der Postleitzahl und dem Länderteil der Adresse im Format „CRHJ+C3 Stanford, CA 94305, USA“.

  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, einschließlich Place Autocomplete, Place Details, Directions API und Geocoding API. Mit der Geocoding API lässt sich z. B. das Geocoding eines Standorts, der durch Breiten- und Längengrade angegeben wurde, rückgängig machen, um den Plus Code des Ortes zu ermitteln.