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 kesintisiz 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 yollara yapılan istekler HTTPS kullanılarak gönderilmelidir ve şu biçimde olmalıdır:

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

Gerekli parametreler

  • puan

    Yakalanacak noktalar. Noktalar parametresi, enlem/boylam çiftlerinin listesini 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ıt aşağıdaki şemayı kullanır.

NearestRoadsResponse

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

Yakalanmış 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ı makaleye göz atın.

SnappedPoint

Alan Zorunlu Tür Açıklama
required LatitudeLongitudeLiteral Daha fazla bilgi için LatitudeLongitudeLiteral bölümüne 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 ilgili değeri gösteren bir tam sayı. İstekteki her değer, yanıttaki bir tutturulmuş değerle eşlenmelidir. Ancak interpolate=true ayarını yaptıysanız veya en yakın yolları kullanıyorsanız yanıtta istektekinden daha fazla koordinat bulunabilir. İnterpolasyon yapılan değerlerde originalIndex bulunmaz. Bu değerler 0'dan itibaren indekslenir. Bu nedenle, originalIndex değeri 4 olan bir nokta, yol parametresine iletilen 5. enlem/boylamın sabitlenmiş değeri olur. En yakın yollar noktaları, farklı konum veya yer kimliğine sahip tek koordinatlar için birkaç nokta içerebilir.

LatitudeLongitudeLiteral

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

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

Ondalık derece cinsinden enlem
required sayı

Ondalık derece cinsinden boylam