Ringkasan Roads API

Roads API adalah layanan yang menerima permintaan HTTPS dengan koordinat lintang/bujur untuk satu atau beberapa titik pada peta. Fitur ini menggunakan titik ini untuk menemukan segmen jalan terdekat dan menampilkan ID Tempat beserta metadata seperti segmen jalan terdekat dan batas kecepatan.

Alasan menggunakan Roads API

Dengan Roads API, Anda bisa mendapatkan batas kecepatan, perkiraan waktu kedatangan, atau metadata jalan lainnya. Dengan metadata jalan ini, Anda dapat meningkatkan kualitas aplikasi mengemudi dengan kemampuan berikut:

  • Hubungkan koordinat lintang/bujur dengan jalan atau beberapa jalan.
  • Menemukan jalan terdekat untuk mendapatkan kumpulan koordinat
  • Mendapatkan batas kecepatan untuk segmen jalan

Yang dapat Anda lakukan dengan Roads API

Dengan Roads API, Anda dapat memetakan koordinat GPS ke geometri jalan, dan menentukan batas kecepatan di sepanjang segmen jalan.

  • Paskan ke Jalan Layanan ini menampilkan jalan yang paling mungkin dilalui berdasarkan kumpulan koordinat GPS yang diberikan. Anda dapat menentukan hingga 100 titik GPS yang dikumpulkan di sepanjang rute. Secara opsional, Anda juga dapat meminta agar layanan menginterpolasi titik tambahan, sehingga menghasilkan jalur yang mengikuti geometri jalan dengan mulus.
  • Jalan Terdekat Layanan ini menampilkan segmen jalan terdekat untuk titik GPS. Anda dapat menentukan hingga 100 titik GPS. Titik yang Anda tetapkan tidak harus menjadi bagian dari jalur berkelanjutan.
  • Batas kecepatan Layanan ini menampilkan batas kecepatan yang diposting untuk suatu segmen jalan. Layanan Batas Kecepatan tersedia untuk semua pelanggan yang memiliki lisensi Asset Tracking. Untuk pelanggan Paket Premium Google Maps Platform yang melakukan transisi ke harga bayar sesuai penggunaan, fitur ini akan tetap aktif.

Cara kerja Roads API

Roads API menggunakan tiga endpoint yang menerima koordinat lintang/bujur atau ID tempat untuk memberikan data batas kecepatan, segmen, atau jalur jalan. Contoh berikut menampilkan permintaan untuk jalan terdekat berdasarkan sekumpulan koordinat lintang/bujur:

https://roads.googleapis.com/v1/nearestRoads
  ?points=60.170880%2C24.942795%7C60.170879%2C24.942796%7C60.170877%2C24.942796
  &key=YOUR_API_KEY

Referensi

Tabel berikut meringkas resource yang tersedia melalui Roads API beserta data yang ditampilkan.

Resource data Data yang dikembalikan Format pengembalian
Pemaskan ke jalan

Menampilkan array hingga 100 titik GPS dari suatu rute. Termasuk koordinat bujur/lintang yang ditangkap jalan beserta ID tempat. Lihat detail di Respons di panduan Paskan ke jalan.
  • JSON
Jalan terdekat

Array hingga 100 koordinat lintang/bujur independen beserta ID tempat untuk jalan terdekat bagi setiap titik yang ditentukan. Poin tidak harus berkelanjutan. Lihat detail di Respons di panduan Jalan terdekat.
Batas kecepatan

Array hingga 100 elemen metadata jalan. Ini berisi batas kecepatan dan ID tempat, dengan unit dalam KPH atau MPJ. Lihat detail di bagian Respons di panduan Batas kecepatan.

Cara menggunakan Roads API

1 Coba demo penunjuk posisi Klik demo untuk membuat jalur dan melihat bagaimana endpoint snap to road memberikan data yang lancar. Lihat Demo di panduan Paskan ke jalan. Anda tidak memerlukan kunci API.
2 Melakukan penyiapan Mulailah dengan Menyiapkan project Google Cloud Anda dan selesaikan petunjuk penyiapan yang mengikutinya, lalu pelajari cara menggunakan kunci API Anda.
3 Coba permintaan penunjuk posisi Gunakan salah satu contoh snap to road dan coba satu yang relevan dengan kasus penggunaan Anda.
4 Mendapatkan batas kecepatan untuk jalur jalan Anda Dengan menggunakan data jalur yang sama yang Anda berikan untuk permintaan snap to road, berikan kueri batas kecepatan. Lihat Contoh permintaan yang menggunakan jalur.
5 Pelajari cara memproses jalur yang panjang Ikuti bagian Memproses jalur panjang dalam panduan Konsep lanjutan.
6 Sertakan data jalan ke dalam aplikasi Anda sendiri. Lihat contoh kode mendetail dari demo yang diikat jalan untuk mulai membuat fungsi data jalan ke dalam aplikasi Anda sendiri.

Library klien yang tersedia

Panggil API ini dalam bahasa pilihan Anda melalui salah satu library klien berikut:

Klien Java, Klien Python, Klien Go, dan Klien Node.js untuk Layanan Google Maps adalah library klien open source yang didukung komunitas berdasarkan Lisensi Apache 2.0. Download semuanya dari GitHub, tempat Anda juga dapat menemukan petunjuk penginstalan dan kode contoh.

Langkah selanjutnya