Dokumen ini menjelaskan proses penyiapan Navigation Connect API dan mencantumkan persyaratan perangkat pengemudi untuk menggunakan Navigation Connect API.
Proses penyiapan Navigation Connect
Sebelum dapat menggunakan Navigation Connect API, Anda harus menyelesaikan langkah-langkah penyiapan berikut:
- Membuat dan mengonfigurasi project Google Cloud.
- Aktifkan Navigation Connect API dan verifikasi aplikasi Anda.
- Siapkan OAuth untuk membuat token OAuth.
- Siapkan akun layanan Anda untuk mengaktifkan komunikasi antara infrastruktur backend Anda dan Google Maps atau Waze.
Persyaratan perangkat minimum untuk menggunakan Navigation Connect
Persyaratan ini diperlukan agar perangkat pengemudi berhasil menjalankan sesi Navigation Connect. Sesi menggunakan Navigation Connect API untuk mengirim data perjalanan real-time, seperti lokasi dan perkiraan waktu tiba, ke server backend Anda.
Versi aplikasi yang didukung
Perangkat harus menginstal Waze atau Google Maps untuk Android. Tabel berikut mencantumkan versi minimum setiap aplikasi untuk Navigation Connect dan untuk fitur yang memerlukan versi lebih baru.
| Aplikasi | Versi minimum | Pelaporan rute yang tersisa | Pelaporan deviasi rute |
|---|---|---|---|
| Waze untuk Android | 5.15.5 | 5.20.0.2 | 5,22 |
| Waze untuk iOS | 5.15.5 | 5.20.0.1 | 5,22 |
| Google Maps untuk Android | 26.14 | 26,27 | Tidak didukung |
Lokasi presisi diaktifkan
Minta pengemudi untuk mengaktifkan izin akses lokasi presisi di perangkatnya. Waze dan Google Maps memerlukan lokasi presisi untuk memulai navigasi.
Izin pengemudi
Navigation Connect memerlukan izin pengemudi untuk membagikan data perjalanan. Anda tidak perlu memicu dialog izin; Google Maps atau Waze akan otomatis menangani antarmuka pengguna ini.
Pada perjalanan pertama yang dimulai dari aplikasi Anda, Google Maps atau Waze akan meminta pengemudi untuk membagikan data perjalanannya.
- Jika pengemudi mengetuk Izinkan, Navigation Connect akan mulai membagikan data lokasi real-time dan PWT ke backend Anda.
- Jika pengemudi mengetuk Jangan izinkan, atau mencabut izin di lain waktu, Google Maps atau Waze
akan memberikan rute belokan demi belokan, tetapi Navigation Connect tidak akan mengirimkan
data. Backend Anda menerima status
CLIENT_ERRORdalam payload data perjalanan.
Pengemudi harus mengonfirmasi ulang izin ini setiap 12 bulan.
Langkah berikutnya
Langkah pertama untuk menyiapkan Navigation Connect API adalah membuat dan mengonfigurasi project Google Cloud.