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:

• Fahrtrichtung und Straßenseite angeben
• Wegpunkte angeben
• Stopp entlang einer Route festlegen
• Punkt festlegen, durch den eine Route verlaufen soll
• 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:

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

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. Damit lassen sich die folgenden Situationen vermeiden, die sich aus anderen Möglichkeiten zur Angabe eines Standorts ergeben können:

• Die Verwendung von Breiten- und Längengraden kann dazu führen, dass der Ort an der Straße ausgerichtet wird, 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 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 (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"
  },
  ...
}

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

Hinweis:Die durch Breiten- und Längengradkoordinaten angegebenen Punkte werden an Straßen ausgerichtet und bieten möglicherweise nicht die für Ihre App erforderliche 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 zu konvertieren.

Hinweis: Die Breiten- und Längengradkoordinaten können von denen abweichen, die von der Geocoding API zurückgegeben werden. Die Routes API gibt beispielsweise möglicherweise Koordinaten für den Eingang eines Gebäudes statt für dessen Mitte zurück.

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. „1. Straße“ kann beispielsweise ein vollständiger Wert oder ein Teilwert für „1. Straße NE“ oder „1. Straße SO“ 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 nach bestimmten Regionen gewichtete Ergebnisse zurückgegeben werden. Dazu schließen 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 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 berechnete Route von Toledo, Spanien, nach Madrid, Spanien:

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

Einen Ort als Plus Code angeben

Viele Menschen haben keine genaue Adresse, was die Zustellung von Sendungen 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, an denen sie nicht vorhanden sind, oder an denen Gebäude nicht nummeriert oder Straßen keine Namen haben.

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

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

  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 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 Stadt-, Bundesstaat-, Postleitzahl- und 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 wie Place Autocomplete, Place Details, Directions API und Geocoding API unterstützt. 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.