Standorte für eine Route angeben

Zum Berechnen einer Route müssen Sie mindestens die Standorte der Route angeben. Start- und Zielpunkt der Route. Diese Standorte definieren Sie als Wegpunkte auf der Route.

Neben Start- und Zielort können Sie verschiedene Arten von und Wegpunkte für eine Route behandelt. Weitere Informationen und Beispiele finden Sie in den folgenden Themen:

Standorte für eine Route angeben

Sie repräsentieren einen Standort, indem Sie einen Wegpunkt (REST) erstellen. oder das Objekt Wegpunkt (gRPC). Im Wegpunktdefinition können Sie einen Ort auf eine der folgenden Arten angeben:

Sie können Standorte für alle Wegpunkte in einer Anfrage auf die gleiche Weise angeben, oder mischen. Zum Beispiel können Sie Breitengrad/Längengrad-Koordinaten für den Ursprungswegpunkt und verwenden Sie eine Orts-ID als Zielwegpunkt.

Aus Effizienz- und Genauigkeitsgründen sollten Sie Orts-IDs anstelle von Breiten- und Längengraden verwenden. Koordinaten oder Adresszeichenfolgen. Orts-IDs sind eindeutig explizit und Vorteile der Geocodierung für Routen, z. B. Zugangspunkte und Verkehrsvariablen. Sie helfen, die folgenden Situationen zu vermeiden, die sich aus anderen Möglichkeiten der Standort angeben:

  • Die Verwendung von Breiten- und Längengraden kann dazu führen, dass der Ort an die Straße ausgerichtet ist, die diesen Koordinaten am nächsten ist. zum Grundstück oder zu einer Straße, die schnell oder sicher zum Ziel führt.
  • Adressstrings müssen zuerst von der Routes API geocodiert werden, damit sie konvertiert werden können in Breiten- und Längengrade umgewandelt werden, 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. Weil an Straßen ausgerichtet sind, wird Ihnen möglicherweise ein Orts-ID liefert unter bestimmten Umständen bessere Ergebnisse.

Orts-IDs aus der Geocoding API abrufen und die Places API (einschließlich Place Autocomplete). Weitere Informationen zu Orts-IDs finden Sie in der Orts-IDs

Im folgenden Beispiel wird mit der Eigenschaft placeId eine Orts-ID für beide übergeben. origin und destination:

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

Standort als Breiten- und Längengrad angeben

Um einen Standort in einem Wegpunkt zu definieren, geben Sie Standort (REST) oder Standort(gRPC) mithilfe von Längen- und Breitengrade angeben.

Gib beispielsweise einen Wegpunkt für die Routen origin und destination an. mithilfe der Koordinaten latitude und longitude:

{
  "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“, USA). Geocoding ist der Prozess, bei dem Eine Adresszeichenfolge in Breiten- und Längengradkoordinaten (z. B. Breitengrad 37.423021 und Längengrad -122.083739).

Wenn Sie einen Adressstring als Standort eines Wegpunkts übergeben, wird die Routes API Geocodiert den String intern, um ihn in Breiten- und Längengrad zu konvertieren. Koordinaten.

Um eine Route zu berechnen, geben Sie beispielsweise einen Wegpunkt für die Route origin und destination mit Adressstrings:

{
  "origin":{
    "address": "1600 Amphitheatre Parkway, Mountain View, CA"
  },
  "destination":{
    "address": "450 Serra Mall, Stanford, CA 94305, USA"
  },
  ...
}

In diesem Beispiel geocodiert das Routes API beide Adressen, um sie in Längen- und Breitengrade angeben.

Wenn der Adresswert mehrdeutig ist, ruft die Routes API möglicherweise eine Suche nach von ähnlichen Adressen unterscheiden können. Beispiel: „1st Street“ könnte ein einen vollständigen oder einen Teilwert für "1st street NE" oder "1st St SE". Dieses Ergebnis kann sich von dem Ergebnis unterscheiden, das von der Geocoding API zurückgegeben wird. Sie können zu möglichen Fehlinterpretationen bei der Verwendung von Orts-IDs.

Region für die Adresse festlegen

Wenn Sie einen unvollständigen Adressstring als Standort eines Wegpunkts übergeben, zeigt die API werden möglicherweise die falschen geocodierten Koordinaten für Breiten- und Längengrad verwendet. Beispiel: stellen Sie eine Anfrage und geben „Toledo“ an. als Ursprung und „Madrid“ als Ziel für eine Autoroute:

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

In diesem Beispiel ist das „Toledo“. wird als Stadt im US-Bundesstaat Ohio in den USA, nicht in Spanien. Daher gibt die Anfrage Ein leeres Array, d. h., dass keine Routen vorhanden sind:

{
  []
}

Sie können die API so konfigurieren, dass nach bestimmten Regionen gewichtete Ergebnisse zurückgegeben werden. einschließlich des Parameters regionCode. Dieser Parameter gibt den Regionscode als ccTLD („Top-Level-Domain“) aus zwei Zeichen bestehen. Die meisten ccTLD-Codes entsprechen den ISO 3166-1-Codes, wobei einige nennenswerte 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 Vereinigtes Königreich“).

Eine Routenanfrage für „Toledo“ nach "Madrid" einschließlich regionCode gibt geeignete Ergebnisse zurück, da "Toledo" als Stadt in Spanien:

{
  "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 Leute haben keine genaue Adresse, was es ihnen erschweren kann um Lieferungen zu erhalten. Oder Personen mit einer Adresse möchten die Lieferungen an spezifischen Orten wie Hintereingang oder Ladestation andocken.

Plus Codes sind wie Adressen von Personen oder Orten, die kein tatsächliche Adresse. Statt Adressen mit Straßennamen und Hausnummern werden Plus Codes basieren auf Breiten- und Längengraden und werden als Zahlen und Buchstaben.

Google hat Plus Codes entwickelt. um allen den Nutzen von Adressen zu bieten. Ein Plus Code ist ein codierter aus Breiten- und Längengraden abgeleitete Standortreferenz, eine Fläche darstellt: 1/8000. Grad durch 1/8000. Grad (ca. 14m x 14 m am Äquator) oder kleiner sein. Sie können Plus Codes als Ersatz für Adressen, die nicht existieren oder wo sich keine Gebäude befinden oder Straßen haben keinen Namen.

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

  • Ein Global Code besteht aus einer vierstelligen Vorwahl und sechs Zeichen oder längerer lokaler Code verwendet.

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

  • Ein zusammengesetzter Code besteht aus mindestens sechs Zeichen Ortscode in Kombination mit einem expliziten Ort.

    Beispiel: Die Adresse „450 Serra“ Mall, Stanford, CA 94305, USA den lokalen Code "CRHJ+C3" hat. Für eine Verbindung Adresse, kombinieren Sie den Ortscode mit Stadt, Bundesland, Postleitzahl und Land der Adresse im Format „CRHJ+C3 Stanford, CA 94305, USA“.

    Sie können beispielsweise eine Route berechnen, indem Sie einen Wegpunkt für die Route origin angeben. und destination mit Plus Codes:

    {
  "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: Place Autocomplete Place Details, Directions API und Geocoding API Sie können die Geocoding API verwenden, um die Geocodierung eines Standort, der durch Breitengrad/Längengrad-Koordinaten angegeben wird, um den Plus Code des Standorts.