Bermigrasi ke API lokasi dan konteks

Google menyarankan untuk menggunakan API lokasi dan konteks dalam layanan Google Play di aplikasi yang memerlukan layanan lokasi. Jika aplikasi Anda menggunakan API lokasi framework, penting untuk bermigrasi ke layanan Google Play guna memanfaatkan fitur terbaru yang didukung oleh Google.

Penggunaan layanan Google Play merupakan opsi yang disarankan untuk mendapatkan layanan lokasi di aplikasi Anda karena alasan berikut:

  1. Layanan Google Play menyediakan antarmuka yang sederhana dan tampilan API yang lebih rapi.
  2. Anda menentukan kualitas layanan yang diinginkan, dan API akan mengelola teknologi yang mendasarinya untuk Anda.
  3. API layanan Google Play dioptimalkan untuk performa dan penggunaan baterai.
  4. API layanan Google Play dikelola secara aktif. Google terus menyempurnakan algoritme dan menambahkan lebih banyak fitur.

Mengupdate aplikasi

Langkah-langkah berikut menjelaskan proses untuk mengupdate aplikasi guna menggunakan API lokasi dan konteks:

  1. Siapkan Layanan Google Play di project Anda.
  2. Update aplikasi untuk menggunakan API setelan lokasi guna memvalidasi setelan lokasi saat ini.
  3. Ganti logika kustom yang digunakan untuk tugas kompleks, seperti mencoba mengidentifikasi apakah pengguna dekat dengan suatu area atau mencoba menebak apa yang sedang dilakukan pengguna, dengan API tingkat tinggi, seperti Geofencing API atau Activity Recognition API.
  4. Ganti penggunaan API lokasi framework dengan API penyedia lokasi fusi.
  5. Hapus referensi ke API lokasi framework.

Menyiapkan layanan Google Play di project

Guna menyediakan API lokasi dan konteks untuk project, Anda harus menambahkan referensi ke repositori Google maven dan mendeklarasikan dependensi ke API yang diwajibkan. Untuk informasi selengkapnya, buka Menyiapkan Layanan Google Play.

Menggunakan API setelan lokasi

Dengan API setelan lokasi, aplikasi menyediakan tingkat QoS yang diinginkan dan API meminta pengguna untuk melakukan perubahan yang diperlukan ke setelan sistem. Lakukan langkah-langkah berikut untuk menggunakan API setelan lokasi di aplikasi Anda:

  1. Minta izin lokasi di manifes aplikasi.
  2. Siapkan objek LocationRequest, yang menentukan tingkat QoS yang diinginkan.
  3. Gunakan API setelan lokasi untuk memeriksa setelan saat ini.

Untuk informasi selengkapnya, buka Mengubah Setelan Lokasi atau buka Sampel Lokasi Google Play untuk contoh kode.

Mengganti logika kustom dengan API tingkat tinggi

API tingkat tinggi, seperti API pembatasan wilayah dan API pengenalan aktivitas, memberikan fitur yang dapat digunakan aplikasi Anda untuk memberikan pengalaman yang luar biasa. Namun, fitur semacam itu memerlukan logika kompleks yang terkadang sulit untuk dikode dan dikelola. Jika aplikasi Anda memiliki logika kustom semacam itu, Anda harus mengganti logika tersebut dengan komponen yang memanfaatkan API tingkat tinggi.

Untuk mengetahui detail implementasi, buka panduan untuk API lokasi dan konteks tertentu.

Mengganti API lokasi framework dengan API penyedia lokasi fusi

Anda dapat menggunakan API penyedia lokasi fusi untuk mendapatkan data lokasi, seperti lintang dan bujur. API penyedia lokasi fusi menggunakan objek Location—seperti API framework lokasi—untuk mewakili lokasi geografis. API menyediakan fitur untuk memproses pembaruan lokasi serta untuk mendapatkan lokasi terakhir yang diketahui. Semua fitur ini menjadikan API penyedia lokasi fusi kandidat yang baik untuk menggantikan komponen yang menggunakan API lokasi framework, dengan perubahan yang minimal pada aplikasi.

Mendapatkan lokasi terakhir yang diketahui merupakan titik awal yang baik untuk banyak pengalaman, karena ini merupakan operasi cepat yang menggunakan data lokasi yang diminta oleh semua klien di perangkat. Untuk melacak lokasi secara rutin, aplikasi Anda dapat berlangganan ke menerima pembaruan lokasi, yang memberikan data terbaru dan memungkinkan pengalaman yang lebih kompleks.

Menghapus referensi ke API lokasi framework

Ganti referensi ke class di paket com.google.android.location dengan class dari paket com.google.android.gms.location, kecuali referensi ke class Location, yang digunakan API penyedia lokasi fusi. Biasanya Anda dapat menghapus komponen yang mengelola penyedia yang berbeda, seperti GPS dan Wi-Fi, dari aplikasi. API lokasi dan konteks akan secara otomatis mengelola penyedia ini.

Menguji aplikasi

Untuk menjalankan aplikasi yang menggunakan versi layanan Google Play terbaru, Anda perlu perangkat yang menginstal aplikasi Play Store dan harus ada Akun Google yang login. Untuk tujuan pengembangan, Anda dapat menggunakan opsi berikut:

  • Perangkat fisik yang tersambung ke lingkungan pengembangan Anda menggunakan kabel USB.
  • Emulator yang menginstal aplikasi Play Store.

Untuk informasi selengkapnya terkait penyambungan perangkat fisik ke lingkungan pengembangan, buka Menjalankan Aplikasi di Perangkat Hardware. Untuk membuat emulator yang menyertakan aplikasi Play Store, buka Membuat dan Mengelola Perangkat Virtual.