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 zusammenhängenden Pfads sein.

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

Anfragen

Eine Anfrage an „Nearest Roads“ 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 zu fangenden Punkte. Für den Parameter „points“ kann eine Liste von Breiten-/Längengradpaaren angegeben werden. Trennen Sie Breiten- und Längengradwerte durch Kommas. Koordinaten durch einen senkrechten Strich trennen: „|“. 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 Roads API eine Antwort im 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 von angepassten Punkten. Manchmal enthält sie mehrere gerundete Punkte für denselben Punkt mit unterschiedlicher placeId oder unterschiedlichem Standort.

Weitere Informationen finden Sie unter SnappedPoint.

SnappedPoint

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

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

optional Zahl

Eine Ganzzahl, die den entsprechenden Wert in der ursprünglichen Anfrage angibt. Jeder Wert in der Anfrage sollte einem gerundeten Wert in der Antwort zugeordnet werden. Wenn Sie jedoch „interpolate=true“ festgelegt haben oder die nächstgelegenen Straßen verwenden, kann die Antwort mehr Koordinaten als die Anfrage enthalten. Interpolierte Werte haben keine originalIndex. Diese Werte werden ab 0 indexiert. Ein Punkt mit einem „originalIndex“ von 4 ist also der angepasste Wert des fünften Breiten-/Längengrads, der an den Parameter „path“ übergeben wurde. „Nearest Roads“-Punkte können mehrere Punkte für einzelne Koordinaten mit unterschiedlichem Standort oder unterschiedlicher placeId 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
required Zahl

Längengrad in Dezimalgrad