Bermigrasi ke lokasi dan layanan konteks Google Play API

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 meningkatkan algoritma 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. Gunakan API setelan lokasi untuk memvalidasi setelan lokasi saat ini.
  3. Gunakan layanan Google Play untuk fitur kompleks, seperti pembatasan wilayah, pengenalan aktivitas, dan awareness.
  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 Maven Google dan mendeklarasikan dependensi ke API yang diwajibkan. Untuk mengetahui informasi selengkapnya, lihat 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 mengetahui informasi selengkapnya, buka Mengubah Setelan Lokasi atau buka Sampel Lokasi Google Play untuk contoh kode.

Menggunakan layanan Google Play untuk fitur kompleks

Library layanan Google Play membantu Anda menerapkan pengalaman pengguna yang baru seputar konteks dan kesadaran akan keadaan sekitar pengguna. Berbagai library lokasi dan konteks memanfaatkan sensor tambahan di luar lokasi, dan melakukannya dengan cara yang hemat daya, memberi aplikasi Anda data yang lebih akurat sekaligus mengurangi dampaknya pada masa pakai baterai.

Sertakan library ini di aplikasi Anda, bukan menulis solusi kustom sendiri:

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 gabungan 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 gabungan 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 gabungan. 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.