Parameter permintaan

Dokumen ini memberikan ringkasan yang jelas tentang semua parameter dalam Places Insights API. Kita akan membahas masing-masing bagian secara rinci, sehingga memberikan wawasan dan praktik baik untuk membantu Anda menggunakan alat ini untuk kebutuhan data geografis Anda.

Places Insights API memungkinkan Anda melakukan beberapa fungsi utama:

  • Menghitung tempat: Menentukan jumlah tempat yang cocok dengan kriteria, seperti jenis lokasi, status operasional, tingkat harga, dan rating.
  • Ambil detail tempat: Dapatkan nama tempat yang memenuhi filter tertentu, lalu mengambil informasi yang lebih detail menggunakan Places API.
  • Pemfilteran fleksibel: Menerapkan filter komprehensif untuk mendapatkan analisis yang akurat. Filter yang tersedia mencakup:
    • Area geografis (lingkaran, wilayah, atau poligon kustom)
    • Jenis tempat
    • Status operasional
    • Tingkat harga
    • Rentang rating

Parameter wajib

Bagian ini membahas parameter yang diperlukan saat mengajukan permintaan ke Places Insights API. Setiap permintaan harus menyediakan hal berikut:

  • Jenis insight.
  • Filter lokasi dan filter jenis.

Insight

Menentukan jenis insight yang ingin dihitung. Jenis insight berikut didukung:

  • INSIGHT_COUNT: Menampilkan jumlah tempat yang cocok dengan kriteria filter.
  • INSIGHT_PLACES: Menampilkan ID tempat yang cocok dengan kriteria filter.

Catatan: Jika opsi ini dipilih, Places Insights API akan menampilkan ID tempat hanya jika count 100 atau kurang.

Filter

Menentukan kriteria untuk memfilter tempat. Setidaknya, Anda harus menentukan LocationFilter dan TypeFilter.

Filter lokasi

Filter lokasi dapat memiliki salah satu jenis berikut:

  • circle: Mendefinisikan area sebagai lingkaran dengan pusat dan radius.
  • region: Mendefinisikan area sebagai wilayah.
  • custom_area: Mendefinisikan bidang sebagai poligon kustom.
Lingkaran

Jika memilih area geografis sebagai lingkaran, Anda harus memberikan center dan radius. Pusat dapat berupa lintang dan bujur, atau tempat ID pusat lingkaran.

  • tengah:
    • lat_lng: Lintang dan bujur pusat lingkaran. Lintang harus berupa angka antara -90, 90, inklusif. Bujur harus berupa angka antara -180, 180, inklusif.
    • place: ID tempat bagian tengah lingkaran. Perhatikan bahwa hanya titik tempat didukung. String ini harus diawali dengan awalan places/.
  • radius: Radius lingkaran dalam meter. Angka ini harus positif.
Wilayah

Anda dapat menentukan area sebagai wilayah menggunakan parameter place. Menggunakan ID tempat yang mewakili area geografis (seperti area yang dapat diwakili oleh poligon). Misalnya, ID tempat Tampa, FL adalah places/ChIJ4dG5s4K3wogRY7SWr4kTX6c.

Jenis Wilayah yang Tidak Didukung
establishment place_of_worship
floor post_box
food postal_code_suffix
general_contractor room
geocode street_address
health street_number
intersection sublocality_level_5
landmark subpremise

Anda dapat menggunakan kolom types dari panggilan Geocoding API untuk menentukan jenis lokasi atau alamat yang terkait dengan ID tempat, seperti apakah itu kota, kawasan, atau negara.

Area khusus

Mendefinisikan bidang poligon kustom menggunakan koordinat.

Anda dapat membuka https://geojson.io/ untuk menggambar poligon kustom dan masukkan koordinat tersebut ke dalam permintaan. Poligon harus memiliki minimal 4 koordinat awal, dengan koordinat pertama dan terakhir sama. Selain koordinat pertama dan terakhir, tidak boleh ada koordinat duplikat lainnya. Contoh:

"coordinates":[
   {
      "latitude":37.776,
      "longitude":-122.666
   },
   {
      "latitude":37.130,
      "longitude":-121.898
   },
   {
      "latitude":37.326,
      "longitude":-121.598
   },
   {
      "latitude":37.912,
      "longitude":-122.247
   },
   {
      "latitude":37.776,
      "longitude":-122.666
   }
]

Jenis filter

Menentukan jenis tempat yang akan disertakan atau dikecualikan. Untuk mengetahui daftar dan jenis tempat sekunder yang didukung Places Insights API, lihat Tabel A di bagian panduan Jenis Tempat untuk Places API (Baru). Setidaknya satu jenis included_types atau included_primary_types harus disertakan.

  • included_types: Daftar jenis tempat yang disertakan.
  • excluded_types: Daftar jenis tempat yang dikecualikan.
  • included_primary_types: Daftar jenis tempat utama yang disertakan.
  • excluded_primary_types: Daftar jenis tempat utama yang dikecualikan.

Untuk mempelajari lebih lanjut cara kerja filter jenis dan jenis tempat, buka informasi selengkapnya tentang jenis filter.

Parameter opsional

Tiga filter yang tersisa bersifat opsional:

  • operating_status: Menentukan status tempat yang akan disertakan atau dikecualikan. Setelan defaultnya adalah pemfilteran menurut operating_status: OPERATING_STATUS_OPERATIONAL (satu nilai tertentu).
  • price_levels: Menentukan tingkat harga tempat. Default-nya adalah tidak pemfilteran (semua tingkat harga disertakan dalam hasil).
  • rating_filter: Menentukan rentang rating tempat. Default-nya adalah tidak filter (semua peringkat disertakan dalam hasil).

Status operasional

Filter berdasarkan Status Operasional (seperti beroperasi atau sementara ditutup).

Tingkat harga

Filter berdasarkan Tingkat Harga (seperti gratis, sedang, atau mahal).

Filter rating

Memfilter tempat berdasarkan rating rata-rata dari pengguna. Kedua isian ini opsional dan jika dihilangkan, mereka akan secara {i>default<i} menyertakan tempat yang tidak memiliki rating.

  • min_rating: Rating pengguna rata-rata minimum (antara 1,0 dan 5,0).
  • max_rating: Rating pengguna rata-rata maksimum (antara 1,0 dan 5,0).