Navigation SDK saat ini hanya tersedia untuk pelanggan tertentu. Hubungi bagian penjualan untuk mempelajari lebih lanjut.

Gaya visual peta baru akan segera hadir di Google Maps Platform. Perubahan pada gaya visual peta ini mencakup palet warna default baru serta peningkatan pada pengalaman dan kegunaan peta. Semua gaya peta akan otomatis diperbarui pada Maret 2025. Untuk informasi lebih lanjut tentang ketersediaan dan cara memilih untuk ikut serta lebih awal, lihat Gaya peta baru untuk Google Maps Platform.

Halaman ini diterjemahkan oleh Cloud Translation API.

Praktik terbaik penggunaan lokasi latar belakang

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, sehingga Anda tidak perlu memintanya secara eksplisit (jika tidak diperlukan untuk tujuan lain), karena penggabung manifes Gradle akan memastikannya digabungkan dengan manifes aplikasi.

Namun, memiliki izin ACCESS_BACKGROUND_LOCATION saja tidak cukup untuk mengakses lokasi di latar belakang dan sebaiknya Anda meminta izin 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.

Perintah harus menjelaskan kepada pengguna bagaimana pemberian izin akan meningkatkan akurasi lokasi dan meningkatkan pengalaman navigasi mereka saat aplikasi berjalan di latar belakang.

Untuk informasi selengkapnya tentang 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 menampilkan notifikasi setelah tidak lagi diperlukan, pastikan Anda melakukan langkah-langkah pembersihan berikut:

Setelah memanggil startGuidance(), pastikan untuk memanggil stopGuidance() atau clearDestination().
Setelah mendaftarkan ArrivalListener, pastikan untuk membatalkan pendaftarannya.
Setelah mendaftarkan RoadSnappedLocationProvider, pastikan untuk membatalkan pendaftarannya.

Menyelesaikan langkah-langkah ini memastikan bahwa notifikasi tidak tetap aktif saat tidak lagi diperlukan, yang dapat menyebabkan baterai cepat habis 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 melakukan inisialisasi 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 memitigasi perubahan ini, Navigation SDK diupdate ke versi 5.4.0 untuk mengelola akses lokasi latar belakang dengan lebih baik. Sebaiknya perbarui juga penerapan Anda untuk memastikan aplikasi Anda terus memiliki akses ke data lokasi yang paling akurat.

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 tepat 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 beralih ke latar belakang, Navigation SDK akan mengandalkan sistem untuk memberikan update lokasi. Update sistem ini mungkin tidak sering atau akurat dan menghasilkan pengalaman navigasi yang kurang optimal. Oleh karena itu, sebaiknya Anda juga meminta izin akses lokasi latar belakang kepada pengguna.

Yang dapat dilakukan developer aplikasi untuk meningkatkan akurasi lokasi navigasi

Anda dapat meningkatkan akurasi sinyal lokasi yang digunakan oleh Navigation SDK dengan mengupdate aplikasi untuk meminta pengguna memberikan akses lokasi latar belakang. Untuk mengetahui informasi selengkapnya, lihat Meminta izin akses lokasi "Selalu izinkan".