Halaman ini menjelaskan praktik terbaik untuk meminta dan mengelola izin penggunaan lokasi latar belakang.
Meminta izin akses lokasi "Selalu izinkan"
Mulai Android 14, aplikasi harus memiliki
izin ACCESS_BACKGROUND_LOCATION untuk mengakses lokasi pengguna.
Navigation SDK menyertakan izin ini dalam file manifesnya, jadi Anda tidak
perlu memintanya secara eksplisit (jika tidak diperlukan untuk tujuan lain), karena
penggabung manifes Gradle akan memastikan izin tersebut digabungkan dengan manifes aplikasi.
Namun, memiliki izin ACCESS_BACKGROUND_LOCATION tidak cukup untuk
mengakses lokasi di latar belakang dan sebaiknya Anda meminta izin akses lokasi "Izinkan sepanjang
waktu" dari pengguna. Hal ini memastikan bahwa aplikasi dapat berjalan di
latar belakang dan menampilkan notifikasi, yang memaksimalkan akurasi lokasi selama
navigasi.
Dialog harus menjelaskan kepada pengguna bagaimana pemberian izin akan meningkatkan akurasi lokasi dan meningkatkan pengalaman navigasi mereka saat aplikasi berjalan di latar belakang.
Untuk mengetahui informasi selengkapnya tentang cara meminta akses lokasi kepada pengguna, lihat Meminta izin akses lokasi | Sensor dan lokasi | Android Developers dalam dokumentasi developer Android.
Memastikan pembersihan notifikasi navigasi yang tepat
Untuk memastikan aplikasi Anda tidak terus mengaktifkan notifikasi setelah tidak lagi diperlukan, pastikan Anda melakukan langkah-langkah pembersihan berikut:
- Setelah memanggil
startGuidance(), pastikan untuk memanggilstopGuidance()atauclearDestination(). - Setelah mendaftarkan
ArrivalListener, pastikan untuk membatalkan pendaftarannya. - Setelah mendaftarkan
RoadSnappedLocationProvider, pastikan untuk membatalkan pendaftarannya.
Menyelesaikan langkah-langkah ini akan memastikan bahwa notifikasi tidak tetap aktif saat tidak lagi diperlukan, yang dapat menyebabkan baterai terkuras dan kemungkinan kebocoran memori.
Saat memanggil ulang metode NavigationApi#initForegroundServiceManager, panggil NavigationApi#clearForegroundServiceManager terlebih dahulu
Jika aplikasi Anda menggunakan ForegroundServiceManager, panggil
NavigationApi#clearForegroundServiceManager sebelum memanggil
NavigationApi#initForegroundServiceManagerProvider, dan jika Anda telah
menginisialisasi ForegroundServiceManager, panggil
NavigationApi#initForegroundServiceManagerMessageAndIntent. Anda dapat melakukannya untuk
memperbarui ID notifikasi atau konten notifikasi setelah
melakukan inisialisasi pengelola layanan latar depan.
Tentang batasan baru yang diperkenalkan di Android 14
Android 14 (Android U) memperkenalkan batasan baru pada aplikasi yang mengakses lokasi pengguna di latar belakang. Untuk membantu mengurangi dampak perubahan ini, Navigation SDK telah diupdate di versi 5.4.0 untuk mengelola akses lokasi latar belakang dengan lebih baik. Sebaiknya update juga implementasi Anda untuk memastikan bahwa aplikasi Anda terus memiliki akses ke data lokasi yang paling presisi.
Pengaruh perubahan di Android 14 terhadap Navigation SDK
Saat Anda memanggil
startGuidance()
di aplikasi, layanan latar depan akan mulai menampilkan notifikasi pengguna untuk
navigasi belokan demi belokan. Navigasi belokan demi belokan bergantung pada kemampuan untuk
mengakses lokasi pengguna guna memperbarui rute dan menampilkan panduan
visual dan audio yang benar. Mulai Android 14, mengakses lokasi presisi pengguna di latar belakang memerlukan izin dari pengguna. Secara default, jika
aplikasi tidak memiliki izin pengguna untuk akses lokasi latar belakang dan
mencoba memulai layanan latar depan untuk pembaruan lokasi, sistem akan menampilkan
SecurityException, yang menyebabkan aplikasi error.
Cara Navigation SDK mengurangi masalah ini
Mulai versi 5.4.0, Navigation SDK menangani SecurityException ini
tanpa memengaruhi aplikasi, sehingga navigasi dapat terus berjalan di
latar belakang. Selain itu, Navigation SDK menyertakan izin ACCESS_BACKGROUND_LOCATION dalam AndroidManifest-nya. Dengan cara ini, aplikasi Anda tidak perlu mendeklarasikan izin itu sendiri, karena penggabungan Gradle akan
menanganinya. Namun, jika notifikasi tidak ditampilkan kepada pengguna sebelum aplikasi berjalan
di latar belakang, Navigation SDK akan mengandalkan sistem untuk memberikan
pembaruan lokasi. Update sistem ini mungkin tidak sering atau tidak akurat dan menghasilkan
pengalaman navigasi yang kurang optimal. Oleh karena itu, sebaiknya Anda juga
meminta akses lokasi latar belakang kepada pengguna.
Yang dapat dilakukan developer aplikasi untuk meningkatkan akurasi lokasi untuk navigasi
Anda dapat meningkatkan akurasi sinyal lokasi yang digunakan oleh Navigation SDK dengan mengupdate aplikasi untuk meminta akses lokasi latar belakang kepada pengguna. Untuk mengetahui informasi selengkapnya, lihat Meminta izin akses lokasi "Izinkan sepanjang waktu".