Tentang data dan kueri Insight Tempat

Data Places Insights

Places Insights menyediakan set data lengkap dan sampel di BigQuery.

Set data sampel dimaksudkan agar Anda dapat mencoba Places Insights sehingga Anda dapat menilai kegunaan dan nilai produk sebelum membuat keputusan untuk membeli set data lengkap. Set data sampel hanya berisi data untuk kota itu sendiri. Data ini tidak berisi data untuk wilayah metropolitan di sekitarnya.

Listingan contoh mencakup data untuk kota teratas di setiap negara yang didukung:

Amsterdam (NL)	Helsinki (FI)	Plovdiv (BG)
Ankara (TR)	Hong Kong (HK)	Riffa (BH)
Arequipa (PE)	Jakarta (ID)	Roma (IT)
Athena (GR)	Jeddah (SA)	Santiago (CL)
Bad Gastein (AT)	Johannesburg (ZA)	Sao Paulo (BR)
Berlin (DE)	Kuala Lumpur (MY)	Sharjah (AE)
Brno (CZ)	Lisbon (PT)	Singapura (SG)
Brussels (BE)	London (GB)	Stockholm (SE)
Bukares (RO)	Lusail (QA)	Sydney (AU)
Buenos Aires (AR)	Madrid (ES)	Taipei (TW)
Busan (KR)	Manila (PH)	Tel Aviv-Yafo (IL)
Kairo (EG)	Medellín (CO)	Tokyo (JP)
Chiang Mai (TH)	Mexico City (MX)	Toronto (CA)
Kopenhagen (DK)	Mumbai (IN)	Warsawa (PL)
Cork (IE)	New York City (AS)	Wellington (NZ)
Debrecen (HU)	Oslo (NO)	Zurich (CH)
Hanoi (VN)	Paris (FR)

Set data lengkap mencakup data untuk setiap negara yang didukung dan harus dibeli. Jika Anda tertarik untuk mendaftar ke Places Insights, isi formulir permintaan. Hanya pelanggan data yang perlu meminta akses ke set data Places Insights. Setelah langganan aktif di project BigQuery, setiap pengguna yang memiliki akses ke project tersebut dapat mengkueri data Places Insights.

Setiap set data negara memiliki listingannya sendiri yang harus Anda berlangganan secara terpisah. Untuk mengetahui informasi selengkapnya tentang cara berlangganan listingan, lihat Menyiapkan Places Insights.

Skema set data

Skema set data tempat untuk setiap negara terdiri dari dua bagian:

• Skema inti yang umum digunakan pada set data untuk semua negara.
• Skema khusus negara yang menentukan komponen skema khusus untuk negara tersebut.

Misalnya, jika Anda menggunakan set data untuk Spanyol (ES), referensikan skema inti dan skema khusus ES.

Skema untuk set data merek menentukan tiga kolom:

• id: ID merek.
• name: Nama merek, seperti "Hertz" atau "Chase".
• category: Kategori tingkat tinggi merek, seperti "SPBU", "Makanan dan Minuman", atau "Penginapan".

Membuat kueri data Places Insights

Places Insights menawarkan dua cara untuk mengkueri set data:

• Membuat kueri set data secara langsung menggunakan SQL: Jalankan kueri SQL BigQuery standar terhadap tabel set data. Hal ini memberikan fleksibilitas paling tinggi untuk pemfilteran yang kompleks, penggabungan dengan data Anda sendiri, analisis kustom, dan dukungan untuk fungsi agregasi tambahan selain COUNT, seperti AVG, SUM, dan GROUP BY. Lihat dokumentasi.
• Membuat kueri set data menggunakan fungsi Places Count: Fungsi Places Count adalah kueri SQL yang telah ditetapkan dan dioptimalkan, yang berjalan langsung di BigQuery dan menyederhanakan tugas pengambilan data umum. API ini memberikan insight yang lebih terperinci, seperti menampilkan ID Tempat untuk mencari detail tentang setiap tempat. Lihat dokumentasi.

Kueri langsung

Membuat kueri data secara langsung akan menerapkan nilai minimum agregasi. Hasil hanya ditampilkan jika kueri menggabungkan minimal 5 Tempat. Misalnya, jika hasil kriteria penelusuran Anda adalah jumlah 0, 1, 2, 3, atau 4, hasil tersebut akan dihilangkan dari respons. Misalnya, kueri untuk jumlah total restoran di area tertentu hanya akan menampilkan respons jika jumlah totalnya adalah 5 atau lebih, jika tidak, tidak ada respons yang ditampilkan.

Kueri fungsi Places Count

Fungsi Places Count dapat menampilkan daftar ID Tempat, yang dapat digunakan untuk mencari informasi tempat satu per satu menggunakan produk GMP lainnya seperti Places API dan Kit UI Tempat.

Fungsi Jumlah Tempat tidak menerapkan nilai minimum agregasi, tetapi menerapkan area penelusuran minimum 40,0 meter kali 40,0 meter (1.600 m²). Artinya, selama kueri penelusuran Anda lebih besar dari area penelusuran minimum, Anda akan selalu mendapatkan hasil, termasuk jika ada 0 tempat yang cocok dengan kueri Anda.

Kapan harus membuat kueri data secara langsung dan kapan harus menggunakan fungsi

Buat kueri data secara langsung jika Anda tidak memerlukan jumlah hasil yang rendah, jika Anda ingin mendapatkan insight selain jumlah, seperti AVG, SUM, atau COUNTIF, atau jika Anda perlu melakukan kueri yang lebih kompleks seperti menggabungkan set data.

Buat kueri menggunakan fungsi jika Anda perlu mengetahui apakah ada sedikit atau tidak ada hasil, atau jika Anda perlu mengambil informasi tempat individual seperti nama atau alamat tempat.

Tabel ini memberikan perbandingan mendetail tentang perbedaan antara kueri langsung dan fungsi Places Count.

	Fungsi Places Count	Kueri set data langsung
Manfaat	Menampilkan ID Tempat yang dapat digunakan untuk mengkueri API lain. Dapat menampilkan jumlah berapa pun. Dioptimalkan untuk performa dan biaya pemrosesan yang rendah. Mudah digunakan. Tidak perlu menulis kueri yang rumit. Memvalidasi parameter input dan menampilkan error sehingga lebih mudah digunakan dan di-debug.	Memungkinkan kueri yang kompleks seperti pemfilteran lanjutan dan penggabungan. Tidak menerapkan area penelusuran minimum. Mendukung fungsi agregat tambahan selain COUNT seperti AVG, SUM, dan GROUP BY.
Antarmuka	Empat fungsi SQL standar yang menghasilkan insight COUNT: jumlah tunggal, jumlah per jenis, jumlah per geografi, jumlah per sel H3. JSON_OBJECT meneruskan argumen ke fungsi.	Tulis SQL Anda sendiri untuk menjalankan fungsi agregasi seperti COUNT, COUNT_IF, SUM, dan AVG.. Insight tambahan dapat dihasilkan menggunakan JOIN, GROUP BY, WHERE, dan lainnya.
Batasan	Menerapkan area penelusuran minimum 40,0 meter kali 40,0 meter (1.600 m2). Fungsi akan menampilkan hasil meskipun jumlah agregasi kurang dari 5, asalkan area penelusuran minimum terpenuhi.	Hasil dengan jumlah kurang dari 5 akan dihilangkan dari hasil (yaitu, baris dikecualikan).
Filter atribut yang didukung	Parameter filter fungsi Places Count mendukung hal yang sama seperti filter atribut kueri langsung, kecuali untuk: Tempat id Komponen alamat	Skema lengkap didukung.