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:
- Buat dan konfigurasi 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 versi 5.15.5 atau yang lebih baru, atau Google Maps versi 26.14 atau yang lebih baru.
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 perkiraan waktu tiba ke backend Anda.
- Jika pengemudi mengetuk Jangan izinkan, atau mencabut izin nanti, Google Maps atau Waze akan memberikan panduan belokan demi belokan, tetapi Navigation Connect tidak mengirimkan data. Backend Anda menerima status
CLIENT_ERRORdalam payload data perjalanan.
Driver harus mengonfirmasi ulang izin ini setiap 12 bulan.
Langkah berikutnya
Langkah pertama untuk menyiapkan Navigation Connect API adalah membuat dan mengonfigurasi project Google Cloud.