Places SDK for Android (Baru) memberikan peningkatan performa dan model harga baru, sehingga aplikasi yang menggunakan Places SDK for Android (Lama) sebaiknya diupdate. Untuk mengetahui detail selengkapnya tentang perbandingan fitur, lihat Memilih SDK.
Gunakan panduan ini untuk memahami perbedaan utama di Places SDK for Android (Baru) dibandingkan dengan Places SDK for Android (Lama), beserta cara menangani perubahan yang diperlukan.
Praktik terbaik penagihan untuk migrasi
Panduan ini berlaku jika penggunaan API Anda cukup tinggi untuk beralih ke harga tingkat kedua. Saat bermigrasi ke versi API yang lebih baru, Anda juga akan ditagih untuk SKU yang berbeda. Untuk menghindari peningkatan biaya selama bulan transisi, sebaiknya alihkan ke API baru dalam produksi sedekat mungkin dengan awal bulan. Hal ini akan memastikan Anda mencapai tingkat harga bulanan yang paling hemat biaya selama bulan migrasi. Untuk mengetahui informasi tentang tingkat harga, lihat halaman harga dan FAQ harga.
Mengaktifkan Places API (Baru)
Places SDK for Android (Legacy) mengandalkan layanan Places API. Untuk menggunakan fitur Places SDK for Android (Baru), Anda harus mengaktifkan Places API (Baru) terlebih dahulu di project Google Cloud Anda. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan project Google Cloud.
Kemudian, Anda harus memastikan bahwa Anda telah menambahkan Places API (Baru) ke daftar API yang diizinkan pada kunci yang digunakan oleh aplikasi Anda. Untuk mengetahui informasi selengkapnya, lihat Menggunakan Kunci API.
Pastikan Anda memiliki kuota yang cukup di Places API (Baru)
Pastikan ada kuota yang cukup di Places API (Baru) untuk mencakup traffic Anda saat ini. Untuk meninjau dan mengelola kuota dan batas penggunaan, lihat Kuota dan pemberitahuan kuota.
Perhatikan perbedaannya:
- Kuota untuk Places SDK for Android (Legacy) bergantung pada kuota layanan Places API. Jumlah ini adalah jumlah semua metode Places API.
- Kuota untuk Places SDK for Android (Baru) bergantung pada kuota layanan Places API (Baru). Ada kuota terpisah untuk setiap metode API.
Periksa apakah perjanjian yang Anda negosiasikan mencakup Places API (Baru)
Jika Anda memiliki perjanjian yang dinegosiasikan, pastikan perjanjian tersebut mencakup Places API (Baru), dengan harga yang diharapkan. Jika tidak, hubungi kontak Penjualan Anda di Google atau partner Anda untuk membahas cara menyertakan API ini.
Perubahan umum
Beberapa perubahan umum yang berlaku untuk beberapa API mencakup:
Menggunakan model harga baru. Untuk informasi harga semua API, lihat Places SDK for Android (Baru).
Anda harus melakukan inisialisasi aplikasi dengan memanggil metode
Places.initializeWithNewPlacesApiEnabled(). Untuk mengetahui informasi selengkapnya tentang cara memilih layanan Places API, lihat Menyiapkan project Google Cloud.Place Details (Baru), Nearby Search (Baru), dan Text Search (Baru) memerlukan mask kolom untuk menentukan kolom yang ingin Anda tampilkan dalam respons.
Class baru telah ditambahkan untuk menentukan permintaan atau menambahkan kolom baru ke respons.
Objek respons
Placeberisi metodegetReviews()baru yang menampilkan Daftar objekReview. Saat aplikasi Anda menampilkan informasi yang diperoleh dari objekPlace, seperti foto dan ulasan, aplikasi juga harus menampilkan atribusi yang diperlukan.Untuk mengetahui informasi selengkapnya, lihat dokumentasi tentang atribusi.
Perubahan khusus API
Bagian ini mencakup panduan migrasi berikut untuk setiap API:
- Bermigrasi dari Place Details (Lama) ke Place Details (Baru)
- Bermigrasi dari Place Photo (Lama) ke Place Photo (Baru)
- Bermigrasi dari Autocomplete (Lama) ke Autocomplete (Baru)
- Bermigrasi dari Current Place (Lama) ke Nearby Search (Baru)