Standorte für eine Routenmatrix angeben

Zum Berechnen einer Routenmatrix müssen Sie mindestens die Standorte eines Routenstartpunkts und eines Routenziels angeben.

Standorte für eine Route angeben

Sie stellen einen Standort dar, indem Sie ein Waypoint (REST)- oder Waypoint (gRPC)-Objekt 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.

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 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 (einschließlich Place Autocomplete) abrufen 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
      }
    }
  },
...
}

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. „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 Ergebnis 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 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 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 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 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 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, 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 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. 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.