En Yakın Yollar

Roads API, 100 bağımsız koordinata kadar alır ve her nokta için en yakın yol segmentini döndürür. Geçilen noktaların sürekli bir yolun parçası olması gerekmez.

Sıralı GPS noktalarıyla çalışıyorsanız yollara hızlı geçiş'i kullanın.

İstekler

En yakın yollar isteği HTTPS kullanılarak gönderilmelidir ve aşağıdaki biçimde olmalıdır:

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

Gerekli parametreler

  • puan

    Tutturulacak noktalar. Nokta parametresi, enlem/boylam çiftlerinden oluşan bir listeyi kabul eder. Enlem ve boylam değerlerini virgülle ayırın. Koordinatları dikey çizgi karakteriyle ayırın: "|". Örneğin: points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.

Örnekler

Aşağıdaki istek, belirtilen koordinat listesine göre bir dizi yol segmenti döndürür.

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'

Yanıtlar

Roads API, her geçerli istek için istek URL'sinde belirtilen biçimde bir yanıt döndürür.

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

Yanıtta aşağıdaki şema kullanılır.

NearestRoadsResponse

Alan Zorunlu Tür Açıklama
isteğe bağlı Array<SnappedPoint>

Tutturulan noktalar dizisi. Bazen aynı nokta için farklı yer kimliği veya konuma sahip birkaç tutturulmuş nokta içerir.

Daha fazla bilgi için SnappedPoint başlıklı makaleyi inceleyin.

SnappedPoint

Alan Zorunlu Tür Açıklama
required LatitudeLongitudeLiteral Daha fazla bilgi için LatitudeLongitudeLiteral sayfasına bakın.
required dize

Bir yerin benzersiz tanımlayıcısı. Roads API tarafından döndürülen tüm yer kimlikleri yol segmentlerine karşılık gelir.

isteğe bağlı sayı

Orijinal istekteki karşılık gelen değeri gösteren bir tam sayı. İstekteki her değer, yanıttaki bir yakalanan değerle eşlenmelidir. Ancak interpolate=true değerini ayarladıysanız veya en yakın yolları kullanıyorsanız yanıt, istekten daha fazla koordinat içerebilir. Ara değerlerde originalIndex bulunmaz. Bu değerler 0 değerinden dizine eklenir. Bu nedenle, originalIndex değeri 4 olan bir nokta, yol parametresine iletilen 5. enlem/boylamın sabitlenen değeri olur. En Yakın Yollar noktaları, farklı konum veya placeId değerine sahip tek koordinatlar için birden fazla nokta içerebilir.

LatitudeLongitudeLiteral

Ondalık derece cinsinden enlem ve boylam değerleriyle belirli bir konumu açıklayan bir nesne.

Alan Zorunlu Tür Açıklama
required sayı

Ondalık derece cinsinden enlem
required sayı

Ondalık derece cinsinden boylam