Nächstgelegene Straßen

Die Roads API akzeptiert bis zu 100 unabhängige Koordinaten und gibt für jeden Punkt das nächstgelegene Straßensegment zurück. Die übergebenen Punkte müssen nicht Teil eines durchgehenden Pfads sein.

Wenn Sie mit sequenziellen GPS-Punkten arbeiten, verwenden Sie die Funktion „An Straßen ausrichten“.

Anfragen

Eine Anfrage an die Funktion „Nächstgelegene Straßen“ muss über HTTPS gesendet werden und hat die folgende Form:

https://roads.googleapis.com/v1/nearestRoads?parameters&key=YOUR_API_KEY

Erforderliche Parameter

  • Punkt

    Die Punkte, die ausgerichtet werden sollen. Der Parameter „Punkt“ akzeptiert eine Liste von Breiten-/Längengrad-Paaren. Trennen Sie die Werte für Breiten- und Längengrad durch Kommas. Trennen Sie die Koordinaten durch einen senkrechten Strich: „|“. Beispiel: points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.

Beispiele

Die folgende Anfrage gibt eine Reihe von Straßensegmenten basierend auf der angegebenen Liste von Koordinaten zurück.

URL

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://roads.googleapis.com/v1/nearestRoads?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796&key=YOUR_API_KEY'

Antworten

Für jede gültige Anfrage gibt die Roads API eine Antwort in dem Format zurück, das in der Anfrage-URL angegeben ist.

{
  "snappedPoints":
    [
      {
        "location":
          { "latitude": 60.170878428876755, "longitude": 24.94269540970182 },
        "originalIndex": 0,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
      {
        "location":
          { "latitude": 60.17087741412199, "longitude": 24.942695474405202 },
        "originalIndex": 1,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
      {
        "location":
          { "latitude": 60.170875416131736, "longitude": 24.942695601802203 },
        "originalIndex": 2,
        "placeId": "ChIJfVFHrM0LkkYRBzUQos_jR5w",
      },
    ],
}

Die Antwort verwendet das folgende Schema.

NearestRoadsResponse

Feld Erforderlich Typ Beschreibung
optional Array<SnappedPoint>

Ein Array mit ausgerichteten Punkten. Manchmal enthält es mehrere ausgerichtete Punkte für denselben Punkt mit unterschiedlicher Orts-ID oder unterschiedlichem Standort.

Weitere Informationen finden Sie unter SnappedPoint.

SnappedPoint

Feld Erforderlich Typ Beschreibung
erforderlich LatitudeLongitudeLiteral Weitere Informationen finden Sie unter LatitudeLongitudeLiteral.
erforderlich String

Eine eindeutige Kennung für einen Ort. Alle von der Roads API zurückgegebenen Orts-IDs entsprechen Straßensegmenten.

optional Zahl

Eine Ganzzahl, die den entsprechenden Wert in der ursprünglichen Anfrage angibt. Jeder Wert in der Anfrage sollte einem ausgerichteten Wert in der Antwort zugeordnet werden. Wenn Sie jedoch „interpolate=true“ festgelegt haben oder die Funktion „Nächstgelegene Straßen“ verwenden, kann die Antwort mehr Koordinaten als die Anfrage enthalten. Interpolierte Werte haben keinen originalIndex. Diese Werte werden ab 0 indexiert. Ein Punkt mit einem „originalIndex“ von 4 ist also der ausgerichtete Wert des fünften Breiten-/Längengrads, der an den Parameter „path“ übergeben wurde. Punkte der Funktion „Nächstgelegene Straßen“ können mehrere Punkte für einzelne Koordinaten mit unterschiedlichem Standort oder unterschiedlicher Orts-ID enthalten.

LatitudeLongitudeLiteral

Ein Objekt, das einen bestimmten Standort mit Breiten- und Längengrad in Dezimalgrad beschreibt.

Feld Erforderlich Typ Beschreibung
erforderlich Zahl

Breitengrad in Dezimalgrad
erforderlich Zahl

Längengrad in Dezimalgrad