Meminta lokasi latar belakang

Halaman ini membahas hal berikut:

  • Cara meminta akses lokasi latar belakang.
  • Cara menangani permintaan berdasarkan versi SDK target aplikasi Anda.
  • Cara preferensi pengguna untuk perkiraan lokasi memengaruhi cara aplikasi Anda mendapatkan lokasi latar belakang.
Gambar 7. Halaman setelan yang menyertakan opsi Izinkan sepanjang waktu, yang memberikan akses lokasi latar belakang.

Konten dialog izin bergantung pada versi SDK target

Saat fitur di aplikasi Anda meminta lokasi latar belakang pada perangkat yang menjalankan Android 10 (API level 29), dialog izin sistem akan menyertakan opsi bernama Izinkan sepanjang waktu. Jika pengguna memilih opsi ini, fitur di aplikasi Anda akan mendapatkan akses lokasi latar belakang.

Di Android 11 (API level 30) dan yang lebih tinggi, dialog sistem tidak menyertakan opsi Izinkan sepanjang waktu. Sebaliknya, pengguna harus mengaktifkan lokasi latar belakang pada halaman setelan, seperti yang ditunjukkan pada gambar 7.

Anda dapat membantu pengguna membuka halaman setelan ini dengan mengikuti praktik terbaik saat meminta izin lokasi latar belakang. Proses pemberian izin bergantung pada versi SDK target aplikasi.

Aplikasi menargetkan Android 11 atau yang lebih baru

Jika aplikasi Anda belum diberi izin ACCESS_BACKGROUND_LOCATION, dan shouldShowRequestPermissionRationale() menampilkan true, tampilkan UI edukasi kepada pengguna yang menyertakan informasi berikut:

  • Penjelasan lengkap tentang alasan fitur aplikasi memerlukan akses ke lokasi latar belakang.
  • Label opsi setelan yang dapat dibaca pengguna dan memberikan lokasi latar belakang (misalnya, label Izinkan sepanjang waktu dalam gambar 7). Anda dapat memanggil getBackgroundPermissionOptionLabel() untuk mendapatkan label ini. Nilai hasil dari metode ini dilokalkan ke preferensi bahasa perangkat pengguna.
  • Opsi bagi pengguna untuk menolak izin. Jika pengguna menolak akses lokasi latar belakang, mereka tetap harus dapat menggunakan aplikasi.
Pengguna dapat mengetuk notifikasi sistem untuk mengubah setelan lokasi untuk aplikasi
Gambar 8. Notifikasi mengingatkan pengguna bahwa mereka telah memberikan akses lokasi latar belakang ke suatu aplikasi.

Aplikasi yang menargetkan Android 10 atau yang lebih rendah

Saat fitur di aplikasi meminta akses lokasi latar belakang, pengguna akan melihat dialog sistem. Dialog ini menyertakan opsi untuk membuka opsi izin lokasi aplikasi di halaman setelan.

Selama aplikasi Anda sudah mengikuti praktik terbaik untuk meminta izin akses lokasi, Anda tidak perlu membuat perubahan untuk mendukung perilaku ini.

Pengguna dapat memengaruhi akurasi lokasi latar belakang

Jika pengguna meminta perkiraan lokasi, pilihan pengguna dalam dialog izin akses lokasi juga berlaku untuk lokasi latar belakang. Dengan kata lain, jika pengguna memberi aplikasi izin ACCESS_BACKGROUND_LOCATION, tetapi hanya memberikan akses perkiraan lokasi di latar depan, aplikasi Anda juga hanya memiliki akses perkiraan lokasi di latar belakang.

Referensi lainnya

Untuk mengetahui informasi selengkapnya tentang izin akses lokasi di Android, lihat materi berikut:

Codelab

Video

Contoh