Ringkasan Roads API

Roads API adalah layanan yang menerima permintaan HTTPS dengan koordinat garis lintang/bujur untuk satu atau beberapa titik di peta. API ini menggunakan titik-titik tersebut 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 tiba, atau metadata jalan lainnya. Dengan metadata jalan ini, Anda dapat meningkatkan kualitas aplikasi mengemudi dengan kemampuan berikut:

  • Menghubungkan koordinat garis lintang/bujur dengan jalan.
  • Menemukan jalan terdekat untuk sekumpulan 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 kemungkinan besar 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 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 perlu menjadi bagian dari jalur berkelanjutan.
  • Batas kecepatan Layanan ini menampilkan batas kecepatan yang diposting untuk segmen jalan. Layanan Batas Kecepatan tersedia untuk semua pelanggan dengan lisensi Pelacakan Aset. Untuk pelanggan Premium Plan Google Maps Platform yang beralih ke harga bayar sesuai penggunaan, fitur ini 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 serangkaian 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 merangkum resource yang tersedia melalui Roads API beserta data yang ditampilkan.

Resource data Data yang ditampilkan Format pengembalian
Paskan ke jalan

Menampilkan array hingga 100 titik GPS dari rute. Mencakup koordinat bujur/lintang yang disesuaikan dengan jalan beserta ID tempat. Lihat detailnya di Respons dalam panduan Paskan ke jalan.
  • JSON
Jalan terdekat

Array hingga 100 koordinat lintang/bujur independen bersama dengan ID tempat untuk jalan terdekat untuk setiap titik yang ditentukan. Poin tidak harus berurutan. Lihat detailnya di Respons dalam panduan Jalan terdekat.
Batas kecepatan

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

Cara menggunakan Roads API

1 Coba demo fitur paskan ke jalan Klik demo untuk membuat jalur dan melihat cara endpoint sesuaikan dengan jalan memberikan data yang lancar. Lihat Demo dalam panduan Paskan ke jalan. Anda tidak memerlukan kunci API.
2 Mulai penyiapan Mulai dengan Menyiapkan project Google Cloud dan selesaikan petunjuk penyiapan yang ada di bawahnya, lalu pelajari cara menggunakan kunci API Anda.
3 Coba permintaan petakan ke jalan Gunakan salah satu contoh fitur petakan ke jalan dan coba salah satu contoh yang relevan dengan kasus penggunaan Anda.
4 Mendapatkan batas kecepatan untuk jalur jalan Anda Menggunakan data jalur yang sama yang Anda berikan untuk permintaan tempel ke jalan, kirimkan kueri batas kecepatan. Lihat Contoh permintaan menggunakan jalur.
5 Pelajari cara memproses jalur panjang Ikuti bagian tentang Memproses jalur panjang dalam panduan Konsep lanjutan.
6 Sertakan data jalan ke dalam aplikasi Anda sendiri. Lihat contoh kode mendetail dari demo jalan yang disesuaikan 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 yang didukung komunitas, yang bersifat open source berdasarkan Lisensi Apache 2.0. Download library klien tersebut dari GitHub, tempat Anda juga dapat menemukan petunjuk penginstalan dan kode contoh.

Langkah berikutnya