Jalan Terdekat

Roads API mengambil hingga 100 koordinat independen, dan menampilkan segmen jalan terdekat untuk setiap titik. Titik yang diteruskan tidak harus menjadi bagian dari jalur berkelanjutan.

Jika Anda menggunakan titik GPS berurutan, gunakan Paskan ke Jalan.

Permintaan

Permintaan ke jalan terdekat harus dikirim menggunakan HTTPS, dan menggunakan format berikut:

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

Parameter yang diperlukan

poin

Titik yang akan dipaskan. Parameter titik menerima daftar pasangan lintang/bujur. Pisahkan nilai lintang dan bujur dengan koma. Pisahkan koordinat dengan karakter pipa: "|". Contoh: points=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.

Contoh

Permintaan berikut menampilkan kumpulan segmen jalan berdasarkan daftar koordinat yang ditentukan.

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'

Respons

Untuk setiap permintaan yang valid, Roads API akan menampilkan respons dalam format yang ditunjukkan dalam URL permintaan.

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

Respons menggunakan skema berikut.

NearestRoadsResponse

Kolom Wajib Jenis Deskripsi
opsional Array<SnappedPoint>

Array titik yang diposisikan. Terkadang berisi beberapa titik yang diposisikan untuk titik yang sama dengan placeId atau lokasi yang berbeda.

Lihat SnappedPoint untuk mengetahui informasi selengkapnya.

SnappedPoint

Kolom Wajib Jenis Deskripsi
required LatitudeLongitudeLiteral Lihat LatitudeLongitudeLiteral untuk mengetahui informasi selengkapnya.
required string

ID unik untuk tempat. Semua ID tempat yang ditampilkan oleh Roads API sesuai dengan segmen jalan.

opsional angka

Bilangan bulat yang menunjukkan nilai yang sesuai dalam permintaan asli. Setiap nilai dalam permintaan harus dipetakan ke nilai yang dipaskan dalam respons. Namun, jika Anda telah menetapkan interpolate=true atau jika Anda menggunakan jalan terdekat, respons mungkin akan berisi lebih banyak koordinat daripada permintaan. Nilai yang diinterpolasi tidak akan memiliki originalIndex. Nilai ini diindeks dari 0, sehingga titik dengan originalIndex 4 akan menjadi nilai yang dipaskan dari lintang/bujur ke-5 yang diteruskan ke parameter jalur. Titik Nearest Roads dapat berisi beberapa titik untuk koordinat tunggal dengan lokasi atau placeId yang berbeda.

LatitudeLongitudeLiteral

Objek yang mendeskripsikan lokasi tertentu dengan Lintang dan Bujur dalam derajat desimal.

Kolom Wajib Jenis Deskripsi
required angka

Lintang dalam derajat desimal
required angka

Bujur dalam derajat desimal