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, Anda harus bermigrasi ke layanan Google Play untuk memanfaatkan fitur terbaru yang didukung 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 menggunakan API setelan lokasi, aplikasi memberikan tingkat QoS yang diperlukan dan API meminta pengguna untuk melakukan perubahan yang sesuai pada setelan sistem. Lakukan langkah-langkah berikut untuk menggunakan API setelan lokasi di aplikasi Anda:

  1. Minta izin akses lokasi dalam manifes aplikasi.
  2. Siapkan objek LocationRequest, yang menentukan level QoS yang Anda inginkan.
  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 layanan Google Play versi terbaru, Anda memerlukan perangkat yang telah menginstal aplikasi Google Play Store dan Akun Google harus 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 Google Play Store, lihat Membuat dan Mengelola Perangkat Virtual.