En Yakın Yollar

Roads API, 100'e kadar bağımsız koordinat 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çimdedir:

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 yol segmenti grubu 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

Her geçerli istek için Roads API, 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ı placeId veya konuma sahip birkaç tutturulmuş nokta içerir.

Daha fazla bilgi için SnappedPoint sayfasına bakın.

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 yakalanmış 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 sabitlenmiş değeri olur. Nearest Roads noktaları, farklı konum veya placeId değerine sahip tek koordinatlar için birden fazla nokta içerebilir.

LatitudeLongitudeLiteral

Belirli bir konumu ondalık derece cinsinden enlem ve boylamla açıklayan bir nesne.

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

Ondalık derece cinsinden enlem
required sayı

Ondalık derece cinsinden boylam