Jalan Terdekat

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

Jika Anda bekerja dengan titik GPS berurutan, gunakan Paskan ke Jalan.

Permintaan

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

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

Parameter yang diperlukan

  • poin

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

Contoh

Permintaan berikut menampilkan sekumpulan 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 disesuaikan. Terkadang berisi beberapa titik yang di-snap untuk titik yang sama dengan placeId atau lokasi yang berbeda.

Lihat SnappedPoint untuk mengetahui informasi selengkapnya.

SnappedPoint

Kolom Wajib Jenis Deskripsi
wajib ada LatitudeLongitudeLiteral Lihat LatitudeLongitudeLiteral untuk mengetahui informasi selengkapnya.
wajib ada 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 disesuaikan dalam respons. Namun, jika Anda telah menetapkan interpolate=true atau jika Anda menggunakan jalan terdekat, respons mungkin 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 disesuaikan dari lintang/bujur ke-5 yang diteruskan ke parameter jalur. Titik Jalan Terdekat dapat berisi beberapa titik untuk satu koordinat dengan lokasi atau placeId yang berbeda.

LatitudeLongitudeLiteral

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

Kolom Wajib Jenis Deskripsi
wajib ada angka

Lintang dalam derajat desimal
wajib ada angka

Bujur dalam derajat desimal