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 aplikasi mengemudi Anda dengan kemampuan berikut:
- Hubungkan koordinat lintang/bujur dengan jalan atau jalan.
- Menemukan jalan terdekat untuk 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 disediakan. Anda dapat menentukan hingga 100 titik GPS yang dikumpulkan di sepanjang rute. Secara opsional, Anda juga dapat meminta layanan tersebut 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 diposting untuk segmen jalan. Layanan Speed Limit tersedia untuk semua pelanggan yang memiliki lisensi Pelacakan Aset. Untuk pelanggan Premium Plan Google Maps Platform yang beralih ke harga bayar sesuai penggunaan, fitur tersebut tetap aktif.
Cara kerja Roads API
Roads API menggunakan tiga endpoint yang menerima koordinat lintang/bujur atau ID tempat untuk memberikan data jalur, 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 meringkas resource yang tersedia melalui Roads API bersama dengan data yang ditampilkan.
Resource data | Data yang ditampilkan | Format pengembalian |
---|---|---|
Paskan ke jalan |
Menampilkan array hingga 100 titik GPS dari rute. Menyertakan koordinat garis lintang/garis bujur yang dipaskan bersama ID tempat. Lihat detail dalam Respons di panduan Paskan ke jalan. |
|
Jalan terdekat |
Array yang terdiri dari hingga 100 koordinat lintang/bujur independen beserta ID tempat untuk jalan terdekat bagi 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. Ini berisi batas kecepatan dan ID tempat, dengan unit dalam KPH atau MPH. Lihat detail dalam Respons di panduan Batas kecepatan. |
Cara menggunakan Roads API
1 | Coba demo snap-to-road | Klik demo untuk membuat jalur dan melihat bagaimana endpoint snap-to-road memberikan data yang lancar. Lihat Demo dalam panduan Paskan ke jalan. Anda tidak memerlukan kunci API. |
2 | Memulai persiapan | Mulailah dengan Menyiapkan project Google Cloud Anda dan selesaikan petunjuk penyiapan yang mengikuti, lalu pelajari cara menggunakan kunci API Anda. |
3 | Mencoba permintaan snap-to-road | Gunakan salah satu contoh snap to road dan coba salah satu yang relevan dengan kasus penggunaan Anda. |
4 | Mendapatkan batas kecepatan untuk jalur jalan Anda | Dengan menggunakan data jalur yang sama dengan yang Anda berikan untuk permintaan snap-to-road, ajukan kueri batas kecepatan. Lihat Contoh permintaan menggunakan jalur. |
5 | Pelajari cara memproses jalur panjang | Ikuti bagian tentang Memproses jalur panjang di panduan Konsep lanjutan. |
6 | Gabungkan data jalan ke dalam aplikasi Anda sendiri! | Lihat contoh kode mendetail dari demo jalan yang diikat 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 untuk Layanan Google Maps
- Klien Python untuk Layanan Google Maps
- Klien Go untuk Layanan Google Maps
- Klien Node.js untuk Layanan Google Maps
Klien Java, Klien Python, Klien Go, dan Klien Node.js untuk Layanan Google Maps adalah library klien yang didukung oleh komunitas, yang bersifat open source berdasarkan Lisensi Apache 2.0. Download file dari GitHub, tempat Anda juga dapat menemukan petunjuk penginstalan dan kode contoh.
Langkah berikutnya
- Mencoba Roads API: Buka Roads Inspector
- Pelajari cara membuat permintaan Roads API: Buka layanan yang Anda minati :
- Memahami Konsep Lanjutan: Buka Konsep Lanjutan
- Mengikuti praktik terbaik: Buka Praktik Terbaik Layanan Web