Ringkasan Roads API

Roads API adalah layanan yang menerima permintaan HTTPS dengan koordinat lintang/bujur untuk satu atau beberapa titik pada peta. Model ini menggunakan titik untuk menemukan segmen jalan terdekat dan mengembalikan 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 jalan ini metadata, Anda dapat meningkatkan 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 jalan segmen.

  • Snap to Roads Layanan ini menampilkan respons jalan yang ditempuh berdasarkan koordinat GPS yang diberikan. Anda dapat menentukan hingga 100 Titik GPS yang dikumpulkan di sepanjang rute. Selain itu, Anda juga dapat meminta agar layanan menginterpolasi titik tambahan, menghasilkan jalur yang mulus mengikuti geometri jalan.
  • Jalan Terdekat Layanan ini menampilkan jalan terdekat segmen 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 akan menampilkan batas kecepatan untuk segmen jalan. Layanan Batas Kecepatan tersedia untuk semua pengguna dengan lisensi Asset Tracking. Untuk Premium Plan Google Maps Platform pelanggan yang beralih ke harga bayar sesuai penggunaan, fitur ini tetap aktif.

Cara kerja Roads API

Roads API menggunakan tiga endpoint yang menerima lintang/bujur koordinat atau ID tempat untuk memberikan data jalur jalan, segmen, atau batas kecepatan. Contoh berikut menampilkan permintaan untuk jalan terdekat berdasarkan sekumpulan jalan dari 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

Resource

Tabel berikut meringkas sumber daya 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. Menyertakan koordinat bujur/lintang yang terpotong di sepanjang jalan dengan ID tempat. Lihat detail di Respons di Paskan ke jalan kami.
  • 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 Jalan terdekat kami.
Batas kecepatan

Array hingga 100 elemen metadata jalan. Keduanya berisi kecepatan batas, dan ID tempat, dengan unit dalam KPH atau MPH. Lihat detail di Respons di Batas kecepatan kami.

Cara menggunakan Roads API

1 Coba demo penunjuk posisi Klik demo untuk membuat lintasan dan melihat cara endpoint pengepasan ke jalan 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 dan selesaikan petunjuk penyiapan yang mengikuti lalu mempelajari cara menggunakan kunci API Anda.
3 Coba permintaan penunjuk posisi Gunakan salah satu Snap ke contoh jalan dan coba satu yang relevan dengan kasus penggunaan Anda.
4 Mendapatkan batas kecepatan untuk jalur jalan Anda Menggunakan data jalur yang sama dengan yang Anda berikan untuk permintaan penunjuk posisi, mengajukan kueri batas kecepatan. Lihat Contoh permintaan yang menggunakan jalur.
5 Pelajari cara memproses jalur yang panjang Ikuti bagian tentang Memproses jalur yang panjang dalam panduan Konsep lanjutan.
6 Sertakan data jalan ke dalam aplikasi Anda sendiri. Lihat contoh kode terperinci dari demo yang dipaskan di jalan untuk memulai membangun 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 Google Maps Layanan adalah library klien yang didukung komunitas, yang bersifat open source di bawah Lisensi Apache 2.0. Download semuanya dari GitHub, tempat Anda juga dapat menemukan petunjuk penginstalan dan kode contoh.

Langkah berikutnya