Place Details (Baru)

Pilih platform: Android iOS JavaScript Layanan Web

Anda dapat meminta detail lebih lanjut tentang tempat usaha atau lokasi tertentu minat dengan menggunakan tempat ID dan membuat Permintaan Place Details (Baru). Place Details (Baru) menampilkan detail yang lebih komprehensif informasi tentang tempat yang ditunjukkan, seperti alamat lengkap, nomor telepon jumlah pengguna, rating pengguna, dan ulasan.

Ada banyak cara untuk mendapatkan ID tempat. Anda dapat menggunakan:

Permintaan Place Details (Baru)

Anda dapat meminta detail tempat dengan menelepon PlacesClient.fetchPlace() dan meneruskan FetchPlaceRequest objek yang berisi ID tempat dan daftar kolom, serta sebagai parameter opsional:

// Define a place ID.
final String placeId = "INSERT_PLACE_ID_HERE";

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList("INSERT_PLACE_FIELDS_HERE");

// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);

Respons Place Details (Baru)

Place Details (Baru) menampilkan data dalam bentuk Place , yang hanya menyertakan kolom yang Anda minta menggunakan kolom daftar. Hasil data tempat tidak boleh kosong, jadi hanya hasil tempat dengan data yang dikembalikan (misalnya, jika tempat yang diminta tidak memiliki foto, kolom foto tidak akan ada dalam hasil).

Untuk mengakses kolom data, panggil metode method. Misalnya, untuk mengakses nama tempat, panggil getName().

Parameter wajib

Parameter yang diperlukan untuk FetchPlaceRequest adalah:

Parameter opsional

Parameter opsional untuk FetchPlaceRequest adalah:

  • Kode wilayah

    Kode wilayah yang digunakan untuk memformat respons, yang ditetapkan sebagai kode CLDR dua karakter. Tidak ada nilai default.

    Jika nama negara kolom Place.Field.ADDRESS dalam respons cocok dengan regionCode, kode negara dihilangkan dari Place.Field.ADDRESS.

    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 "Inggris Raya dan Irlandia Utara"). Parameter ini dapat memengaruhi hasil berdasarkan hukum yang berlaku.

    Untuk menetapkan parameter kode wilayah, panggil metode setRegionCode() saat membuat objek FetchPlaceRequest.

  • Token sesi

    Token sesi adalah string buatan pengguna yang melacak Panggilan Autocomplete (Baru) sebagai "sesi". Pelengkapan Otomatis (Baru) menggunakan token sesi untuk mengelompokkan fase kueri dan pemilihan tempat dari penelusuran pelengkapan otomatis pengguna ke dalam sesi terpisah untuk tujuan penagihan. Token sesi diteruskan ke Place Details (Baru) panggilan yang mengikuti panggilan Autocomplete (Baru). Untuk informasi selengkapnya, lihat Token sesi.

    Untuk menetapkan parameter token sesi, panggil metode setSessionToken() saat membuat objek FetchPlaceRequest.

Contoh Place Details

Contoh berikut meminta kolom ID, NAME, dan ADDRESS untuk Empire State Building di Kota New York.

// Define a place ID.
final String placeId = "ChIJaXQRs6lZwokRY6EFpJnhNNE";

// Specify the list of fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME, Place.Field.ADDRESS);

// Construct a request object, passing the place ID and field list.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

// Pass the request object and make the request
Task<FetchPlaceResponse> placeTask = placesClient.fetchPlace(request);