Najbliższe drogi

Funkcja Roads API przyjmuje do 100 niezależnych współrzędnych geograficznych i zwraca najbliższy segment drogi dla każdego punktu. Punkty nie muszą być częścią ciągłej ścieżki.

Jeśli pracujesz z sekwencyjnymi punktami GPS, użyj funkcji Snap to Roads.

Żądania

Żądanie dotyczące najbliższych dróg musi być wysyłane za pomocą protokołu HTTPS i ma następującą postać:

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

Wymagane parametry

  • pkt

    Punkty, które mają zostać przyciągnięte. Parametr points może zawierać listę par szerokości i długości geograficznej. Rozdziel wartości szerokości i długości geograficznej przecinkami. Oddzielaj współrzędne znakiem „|”. Na przykład:points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796

Przykłady

Poniższe żądanie zwraca zestaw odcinków dróg na podstawie podanej listy współrzędnych.

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'

Odpowiedzi

W przypadku każdego prawidłowego żądania Roads API zwróci odpowiedź w formacie wskazanym w adresie URL żądania.

{
  "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",
      },
    ],
}

Odpowiedź jest zgodna z tym schematem.

NearestRoadsResponse

Pole Wymagane Typ Opis
opcjonalnie Array<SnappedPoint>

Tablica przyciągniętych punktów. Czasami zawiera kilka przyciągniętych punktów dla tego samego punktu o różnych identyfikatorach miejsca lub lokalizacjach.

Więcej informacji znajdziesz w sekcji SnappedPoint.

SnappedPoint

Pole Wymagane Typ Opis
wymagane LatitudeLongitudeLiteral Więcej informacji znajdziesz w sekcji LatitudeLongitudeLiteral.
wymagane ciąg znaków

Unikalny identyfikator miejsca. Wszystkie identyfikatory miejsc zwracane przez interfejs Roads API odpowiadają odcinkom dróg.

opcjonalnie liczba

Liczba całkowita wskazująca odpowiednią wartość w pierwotnym żądaniu. Każda wartość w żądaniu powinna być mapowana na przyciągniętą wartość w odpowiedzi. Jeśli jednak ustawisz interpolate=true lub używasz najbliższych dróg, odpowiedź może zawierać więcej współrzędnych niż żądanie. Wartości interpolowane nie będą miały originalIndex. Wartości te są indeksowane od 0, więc punkt o wartości originalIndex równej 4 będzie przyciągniętą wartością 5-tej szerokości/długości geograficznej przekazanej do parametru path. Punkty Nearest Roads mogą zawierać kilka punktów dla pojedynczych współrzędnych o różnej lokalizacji lub identyfikatorze miejsca.

LatitudeLongitudeLiteral

Obiekt opisujący konkretną lokalizację z szerokością i długością geograficzną w stopniach dziesiętnych.

Pole Wymagane Typ Opis
wymagane liczba

Szerokość geograficzna w stopniach dziesiętnych
wymagane liczba

Długość geograficzna w stopniach dziesiętnych