Bermigrasi ke Place Details (Baru)

Developer Wilayah Ekonomi Eropa (EEA)

Places SDK for Android mendukung Detail Tempat (Lama). Jika Anda sudah familiar dengan Places SDK for Android (Legacy), Place Details (Baru) 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 mana yang ingin ditampilkan dalam respons. Tidak ada daftar default kolom yang ditampilkan. Jika Anda tidak menyertakan 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 for Android versi 3.3.0 dan yang lebih baru menambahkan banyak nilai jenis baru. Untuk 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 dalam versi 3.3.0.

  • Places SDK for Android: Menampilkan enum yang ditentukan oleh Place.Types, yang tidak mencakup jenis baru yang ditambahkan di 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 Anda menampilkan ulasan di aplikasi, Anda juga harus menampilkan atribusi atau atribusi penulis. Untuk mengetahui informasi selengkapnya, lihat Menampilkan ulasan.

Untuk mengetahui informasi selengkapnya, lihat dokumentasi tentang atribusi.

Kode bahasa nama tempat akses

Di Places SDK for Android (Legacy), metode Place.getName() 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 sekarang berisi kode bahasa untuk string nama. Untuk mengisi objek Place dengan kode bahasa, Anda harus:

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

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

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

Menetapkan kode wilayah

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

Jika nama negara di kolom alamat dalam respons cocok dengan kode wilayah, kode negara akan dihapus 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 dapat memengaruhi hasil berdasarkan hukum yang berlaku.

Contoh permintaan

Untuk contoh lengkap, lihat Place Details (Baru).