Ringkasan Roads API

Roads API adalah layanan yang menerima permintaan HTTPS dengan koordinat lintang/bujur untuk satu atau beberapa titik pada peta. Titik 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 jalan.
  • Menemukan jalan terdekat untuk sekumpulan koordinat
  • Dapatkan 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.

  • Snap to Roads Layanan ini menampilkan jalan yang paling mungkin ditempuh 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 lancar.
  • Jalan Terdekat Layanan ini menampilkan segmen jalan terdekat untuk titik GPS. Anda dapat menentukan hingga 100 titik GPS. Titik yang Anda tentukan tidak harus menjadi bagian dari jalur berkelanjutan.
  • Batas kecepatan Layanan ini menampilkan batas kecepatan yang dipasang untuk sebuah segmen jalan. Layanan Speed Limits tersedia untuk semua pelanggan yang memiliki lisensi Asset Tracking. Untuk pelanggan Paket Premium Google Maps Platform yang beralih 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 jalur jalan, segmen, atau batas kecepatan. Contoh berikut menunjukkan 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 bersama dengan data yang ditampilkannya.

Resource data Data yang ditampilkan Format pengembalian
Paskan ke jalan

Menampilkan array hingga 100 titik GPS dari sebuah rute. Mencakup koordinat bujur/lintang yang diikat jalan beserta ID tempat. Lihat detail dalam Respons dalam panduan Paskan ke jalan.

  • JSON
Jalan terdekat

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

Batas kecepatan

Array yang berisi hingga 100 elemen metadata jalan. File ini berisi batas kecepatan dan ID tempat, dengan satuan dalam KPH atau MPH. Lihat detail dalam Respons dalam panduan Batas kecepatan.

Cara menggunakan Roads API

1 Coba demo snap to jalan Klik demo untuk membuat jalur dan melihat bagaimana endpoint snap to jalan memberikan data yang lancar. Lihat Demo dalam panduan Paskan ke jalan. Anda tidak memerlukan kunci API.
2 Memulai Mulailah dengan Menyiapkan project Google Cloud Anda dan selesaikan petunjuk penyiapan yang mengikutinya, lalu pelajari cara menggunakan kunci API Anda.
3 Coba permintaan paskan ke jalan Gunakan salah satu contoh snap to jalan dan coba salah satu yang relevan dengan kasus penggunaan Anda.
4 Mendapatkan batas kecepatan untuk jalur jalan Anda Dengan menggunakan data jalur yang sama seperti yang Anda berikan untuk permintaan snap-to-road, keluarkan 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 Gabungkan data jalan ke aplikasi Anda sendiri! Lihat contoh kode mendetail dari demo singkat untuk mulai 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 Layanan Google Maps adalah library klien open source yang didukung komunitas berdasarkan Lisensi Apache 2.0. Download dari GitHub, tempat Anda juga dapat menemukan petunjuk penginstalan dan kode contoh.

Langkah selanjutnya