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 Anda inginkan dan jenis yang tidak Anda inginkan, baik untuk kategori utama suatu tempat maupun untuk detail lainnya. Dengan begitu, Anda dapat membuat penelusuran tertentu untuk menemukan tempat yang Anda cari.

Tersedia lebih dari 200 Jenis Tempat. 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 satu jenis utama 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 utamanya sebagai restaurant, tetapi karena juga berfungsi sebagai bar dan menyediakan layanan makanan, tempat tersebut juga dapat menentukan jenis tempat sekundernya 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 fungsi utamanya adalah restoran.

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

Penting: Saat menggunakan beberapa filter, interaksi antar-filter penting untuk dipahami. Secara khusus, tempat dievaluasi menggunakan logika OR dalam filter yang sama dan logika AND di berbagai filter.

• Dalam filter (logika OR): Misalnya, includedTypes: restaurant, bar berarti tempat dapat berupa restaurant atau bar.
• Filter silang (logika AND): Semua kriteria filter yang ditentukan harus dipenuhi secara bersamaan. Artinya, setiap filter menambahkan lapisan pembatasan pada 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 akan menghapus semua tempat dari pilihan ini yang juga dikategorikan sebagai hotel. Akibatnya, kueri akan menampilkan tempat yang merupakan restaurant atau bar, tetapi hanya jika tempat tersebut tidak diklasifikasikan sebagai hotel dalam jenisnya (primer atau sekunder).