Places SDK for Android mendukung Place Details yang ada. Jika Anda sudah memahami Places SDK for Android yang ada, Places Details versi baru akan melakukan perubahan berikut:
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.Penyamaran kolom wajib diisi. Anda harus menentukan kolom yang ingin ditampilkan dalam respons. Tidak ada daftar default kolom yang ditampilkan. Jika Anda menghapus daftar ini, metode akan menampilkan error.
Bagian berikut menjelaskan perubahan tambahan.
Mengakses jenis tempat baru
Setiap tempat dapat memiliki satu atau beberapa nilai jenis yang terkait dengannya. Places SDK untuk Android versi 3.3.0 dan yang lebih baru menambahkan banyak nilai jenis baru. Untuk mengetahui daftar lengkapnya, lihat Jenis tempat yang diperluas.
Metode
Place.getPlaceTypes()
menampilkan nilai jenis sebagai daftar nilai string. Nilai yang ditampilkan
bergantung pada versi Places SDK for Android Anda:
Places SDK for Android (Baru): Menampilkan string yang ditentukan oleh Tabel A dan Tabel B yang ditampilkan di Jenis Tempat (Baru), termasuk semua jenis tempat yang ditambahkan di versi 3.3.0.
Places SDK for Android: Menampilkan enum yang ditentukan oleh
Place.Types, yang tidak menyertakan jenis baru yang ditambahkan dalam versi 3.3.0 dan yang lebih baru.
Mengakses ulasan tempat
Places SDK for Android (Baru) menambahkan class
Review, yang berisi ulasan tempat. Objek Place dapat berisi hingga
lima ulasan.
Class Review juga dapat berisi atribusi dan atribusi penulis. Jika
menampilkan ulasan di aplikasi, Anda juga harus menampilkan atribusi
atau atribusi penulis. Untuk informasi selengkapnya, lihat Menampilkan
ulasan.
Untuk mengetahui informasi selengkapnya, lihat dokumentasi tentang atribusi.
Mengakses kode bahasa nama tempat
Metode
Place.getName()
yang ada menampilkan string teks yang berisi nama tempat. Untuk mengisi
objek Place dengan nama tempat, Anda harus menyertakan
Place.Field.DISPLAY_NAME dalam daftar kolom permintaan detail tempat.
Objek Place kini berisi kode bahasa untuk string nama. Untuk mengisi objek Place dengan kode bahasa, Anda harus:
Sertakan
Place.Field.DISPLAY_NAMEdalam daftar kolom permintaan. Nilai ini mengonfigurasi respons untuk menyertakan nama tempat dan kode bahasa dalam objekPlace.Panggil
PlacesClient.fetchPlace().PlacesClient.findCurrentPlace()tidak mendukung kolom kode bahasa.Gunakan metode
Place.getNameLanguageCode()untuk mengakses kolom kode bahasa di objekPlace.
Menetapkan kode wilayah
Places SDK for Android (Baru) menambahkan parameter permintaan kode wilayah ke Place Details. Kode wilayah digunakan untuk memformat respons, yang ditentukan sebagai nilai kode CLDR dua karakter. Parameter ini juga dapat memiliki efek bias pada hasil penelusuran. Tidak ada nilai default. Anda harus mengaktifkan SDK baru untuk menetapkan kode wilayah.
Jika nama negara kolom alamat dalam respons cocok dengan kode wilayah, kode negara akan dihilangkan dari alamat.
Sebagian besar kode CLDR identik dengan kode ISO 3166-1, dengan beberapa pengecualian. Misalnya, ccTLD Inggris Raya adalah "uk" (.co.uk) sedangkan kode ISO 3166-1-nya adalah "gb" (secara teknis untuk entitas "The United Kingdom of Great Britain and Northern Ireland"). Parameter ini dapat memengaruhi hasil berdasarkan hukum yang berlaku.
Contoh permintaan
Untuk contoh lengkap, lihat Place Details (Baru).