Selengkapnya tentang filter jenis

Di Places Aggregate API, filter jenis membantu Anda memfokuskan penelusuran dengan memungkinkan Anda memilih jenis tempat yang ingin disertakan atau dikecualikan dari respons. Anda dapat membuat daftar jenis yang diinginkan dan jenis yang tidak diinginkan, baik untuk kategori utama tempat maupun untuk detail lainnya. Dengan cara ini, Anda dapat membuat penelusuran tertentu untuk menemukan tempat yang benar-benar Anda cari.

Ada lebih dari 200 Jenis Tempat yang tersedia. Untuk daftar lengkap yang didukung Places Aggregate API, lihat Tabel A di bagian Jenis Tempat untuk Places API (Baru).

Cara kerja jenis tempat

Tempat dapat memiliki beberapa jenis tempat:

• Tempat dapat memiliki jenis utama tunggal yang mencerminkan fungsi utamanya. Namun, dalam beberapa kasus, jenis utama mungkin tidak ditentukan untuk suatu tempat.

• Tempat dapat memiliki satu atau beberapa jenis sekunder. Jenis sekunder adalah kategori tambahan yang berlaku untuk suatu tempat guna memberikan informasi tambahan tentang karakteristik dan layanan tempat tersebut.

Misalnya, suatu tempat dapat menentukan jenis utama sebagai restaurant, tetapi karena tempat tersebut juga berfungsi sebagai bar dan menyediakan layanan makanan, tempat tersebut juga dapat menentukan jenis tempat sekunder sebagai bar, food, dan establishment.

Filter menurut jenis

Untuk memfilter tempat menurut jenis utama, gunakan includedPrimaryTypes dan excludedPrimaryTypes dalam permintaan. Filter hanya berlaku untuk jenis utama tempat. Misalnya, filter includedPrimaryTypes untuk restaurant hanya menampilkan tempat yang terutama berfungsi sebagai restoran.

Untuk memfilter tempat menurut jenis utama dan sekunder, gunakan includedTypes dan excludedTypes dalam permintaan. Filter berlaku untuk kedua jenis tersebut. Misalnya, includedTypes dari bar menampilkan tempat yang memiliki bar sebagai jenis utama atau sekundernya.

Catatan: API menggunakan sistem jenis hierarkis. Menentukan jenis dalam filter Anda akan otomatis menyertakan semua turunannya (subjenis). Misalnya, jika Anda meminta gym di includedPrimaryTypes, hasilnya juga akan menyertakan tempat dengan jenis utama yoga_studio, karena jenis tersebut adalah subjenis dari gym.

Penting: Saat menggunakan beberapa filter, penting untuk memahami interaksi antar-filter. Secara khusus, tempat dievaluasi menggunakan logika ATAU dalam filter yang sama dan logika DAN di seluruh filter yang berbeda.

• Dalam filter (logika ATAU): Misalnya, includedTypes: restaurant, bar berarti tempat tersebut dapat berupa restaurant atau bar.
• Di seluruh filter (logika DAN): Semua kriteria filter yang ditentukan harus dipenuhi secara bersamaan. Artinya, setiap filter menambahkan lapisan batasan ke kueri dan hanya tempat yang memenuhi semua kondisi yang akan disertakan dalam hasil.

Misalnya, jika Anda menetapkan includedTypes: restaurant, bar dan excludedTypes: hotel; pertama, filter includedTypes akan memilih semua tempat yang dikategorikan sebagai restaurant atau bar. Kedua, filter excludedTypes kemudian akan menghapus tempat mana pun dari pilihan ini yang juga dikategorikan sebagai hotel. Akibatnya, kueri akan menampilkan tempat yang berupa restaurant atau bar, tetapi hanya jika tempat tersebut tidak diklasifikasikan sebagai hotel dalam jenisnya (utama atau sekunder).