Bermigrasi ke Place Details (Baru)

Places SDK for Android mendukung Place Details. Jika Anda sudah terbiasa dengan Places SDK for Android, Place Details versi baru membuat perubahan berikut:

  • Menggunakan model penetapan harga baru. Guna mengetahui informasi harga untuk semua API, lihat Places SDK for Android (Baru).

  • Anda harus menginisialisasi aplikasi dengan memanggil Places.initializeWithNewPlacesApiEnabled() . Untuk informasi selengkapnya tentang memilih layanan Places API, lihat Menyiapkan project Google Cloud.

  • Penyamaran kolom wajib diisi. Anda harus menentukan kolom yang ingin ditampilkan dalam responsnya. Tidak ada daftar default untuk kolom yang ditampilkan. Jika Anda menghilangkan daftar ini, metode akan mengembalikan pesan {i>error<i}.

Bagian berikut menjelaskan perubahan tambahan.

Mengakses jenis tempat baru

Setiap tempat dapat memiliki satu atau beberapa nilai type yang terkait dengannya. Tujuan Places SDK for Android versi 3.3.0 dan yang lebih baru menambahkan banyak jenis baru masing-masing. Untuk daftar lengkapnya, lihat Jenis tempat yang diperluas.

Place.getPlaceTypes() mengembalikan nilai jenis sebagai daftar nilai string. Nilai-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 ditampilkan pada Jenis Tempat (Baru), termasuk semua jenis tempat yang ditambahkan ditambahkan dalam versi 3.3.0.

  • Places SDK for Android: Menampilkan enum yang ditentukan oleh Place.Types, yang tidak termasuk jenis baru yang ditambahkan dalam versi 3.3.0 dan kemudian.

Mengakses ulasan tempat

Places SDK for Android (Baru) menambahkan Review , yang berisi ulasan tempat. Objek Place dapat berisi hingga lima ulasan.

Class Review juga dapat berisi atribusi dan atribusi penulis. Jika Anda menampilkan ulasan di aplikasi, Anda juga harus menampilkan semua atribusi atau atribusi penulis. Untuk informasi selengkapnya, lihat Menampilkan peninjauan.

Untuk informasi selengkapnya, lihat dokumentasi tentang atribusi.

Akses kode bahasa nama tempat

Layanan Place.getName() mengembalikan {i>string<i} teks yang berisi nama tempat. Untuk mengisi Objek Place dengan nama tempat, Anda harus menyertakan Place.Field.NAME di daftar kolom permintaan detail tempat.

Objek Place kini berisi kode bahasa untuk string nama. Kepada mengisi objek Place dengan kode bahasa, Anda harus:

  1. Sertakan Place.Field.NAME dalam daftar kolom permintaan. Nilai ini mengonfigurasi respons untuk menyertakan nama tempat dan kode bahasa di Objek Place.

  2. Panggil PlacesClient.fetchPlace(). PlacesClient.findCurrentPlace() tidak mendukung kolom kode bahasa.

  3. Gunakan Place.getNameLanguageCode() untuk mengakses kolom kode bahasa dalam objek Place.

Tetapkan kode wilayah

Places SDK for Android (Baru) menambahkan parameter permintaan kode wilayah ke Detail Tempat. Kode wilayah digunakan untuk memformat respons, yang ditetapkan sebagai kode CLDR dua karakter dengan sejumlah nilai. Parameter ini juga dapat memiliki efek bias pada hasil penelusuran. Ada tidak ada nilai default. Anda harus mengaktifkan SDK baru untuk menetapkan kode wilayah.

Jika nama negara dari kolom alamat dalam respons cocok dengan wilayah kode negara, kode negara dihilangkan dari alamat.

Sebagian besar kode CLDR identik dengan kode ISO 3166-1, dengan beberapa pengecualian. Misalnya, ccTLD Inggris Raya adalah "uk" (.co.uk) dengan ISO 3166-1 kodenya adalah "gb" (secara teknis untuk entitas "Inggris Raya dan Irlandia Utara"). Parameter dapat memengaruhi hasil berdasarkan hukum.

Contoh permintaan

Untuk contoh lengkapnya, lihat Place Details (Baru).