Najbliższe drogi

Interfejs Roads API przyjmuje do 100 niezależnych współrzędnych i zwraca najbliższy odcinek drogi dla każdego punktu. Przekazane 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 najbliższych dróg musi zostać wysł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

  • points

    Punkty, które mają zostać przyciągnięte. Parametr points przyjmuje listę par szerokości i długości geograficznej. Rozdzielaj wartości szerokości i długości geograficznej z przecinkami. Rozdzielaj współrzędne znakiem kreski pionowej „|”. 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 określonej 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 zwraca 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ź używa tego schematu.

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 z różnymi wartościami placeId lub location.

Więcej informacji znajdziesz w artykule SnappedPoint.

SnappedPoint

Pole Wymagane Typ Opis
wymagane LatitudeLongitudeLiteral Więcej informacji znajdziesz w artykule LatitudeLongitudeLiteral.
wymagane tekst

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 parametru originalIndex. Te wartości są indeksowane od 0, więc punkt z parametrem originalIndex o wartości 4 będzie przyciągniętą wartością 5. szerokości i długości geograficznej przekazanej do parametru ścieżki. Punkty najbliższych dróg mogą zawierać kilka punktów dla pojedynczych współrzędnych z różnymi wartościami location lub placeId.

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.