Jalan Terdekat

Roads API dapat menerima 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 Snap to Roads.

Permintaan

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

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

Parameter yang diperlukan

  • poin

    Poin yang akan di-snap. Parameter poin menerima daftar pasangan garis lintang/garis 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 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 di-snap. 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 di-snap 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 di-snap dari garis lintang/garis bujur ke-5 yang diteruskan ke parameter jalur. Titik Jalan Terdekat mungkin berisi beberapa titik untuk koordinat tunggal dengan lokasi atau placeId yang berbeda.

LatitudeLongitudeLiteral

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

Kolom Wajib Jenis Deskripsi
wajib ada angka

Garis lintang dalam derajat desimal
wajib ada angka

Garis bujur dalam derajat desimal