Halaman ini diterjemahkan oleh Cloud Translation API.

Tentang data dan kueri Insight Tempat

Data Places Insights

Places Insights menyediakan set data lengkap dan sampel di BigQuery.

Set data contoh dimaksudkan agar Anda dapat mencoba Places Insight sehingga Anda dapat menilai kegunaan dan nilai produk sebelum memutuskan untuk membeli set data lengkap. Contoh set data hanya berisi data untuk kota itu sendiri. Laporan ini tidak berisi data untuk wilayah metropolitan di sekitarnya.

Contoh listingan mencakup data untuk kota teratas di setiap negara yang didukung: Sydney (AU), Sao Paulo (BR), Toronto (CA), Zurich (CH), Berlin (DE), Madrid (ES), Paris (FR), London (UK), Jakarta (ID), Mumbai (IN), Roma (IT), Tokyo (JP), Mexico City (MX), New York City (US).

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

Setiap dataset negara memiliki listingannya sendiri yang harus Anda ikuti secara terpisah. Untuk mengetahui informasi selengkapnya tentang cara berlangganan listingan, lihat Menyiapkan Insight Tempat.

Skema set data

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

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

Misalnya, jika Anda bekerja dengan set data untuk Spanyol (ES), lihat 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 besar untuk pemfilteran kompleks, penggabungan dengan data Anda sendiri, analisis kustom, dan dukungan untuk fungsi agregasi tambahan di luar COUNT, seperti AVG, SUM dan GROUP BY. Lihat dokumentasi.
Kueri set data menggunakan fungsi Jumlah Tempat: Fungsi jumlah tempat adalah kueri SQL yang telah ditentukan sebelumnya dan dioptimalkan yang berjalan langsung di BigQuery dan menyederhanakan tugas pengambilan data umum. Mereka memberikan insight yang lebih terperinci, seperti menampilkan ID Tempat untuk mencari detail tentang setiap tempat. Lihat dokumentasi.

Kueri langsung

Mengkueri data secara langsung akan menerapkan nilai minimum agregasi. Hasil hanya ditampilkan jika kueri menggabungkan setidaknya 5 Tempat. Misalnya, jika hasil kriteria penelusuran Anda adalah jumlah 0, 1, 2, 3, atau 4, maka 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 jumlah tempat

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

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

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

Kueri data secara langsung jika Anda tidak memerlukan jumlah hasil yang rendah, jika Anda ingin mendapatkan insight di luar 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 tertentu seperti nama atau alamat tempat.

Tabel ini memberikan perbandingan mendetail tentang perbedaan antara kueri langsung dan fungsi jumlah tempat.

	Fungsi jumlah tempat	Kueri set data langsung
Manfaat	Menampilkan ID Tempat yang dapat digunakan untuk mengkueri API lain. Dapat menampilkan jumlah apa 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 kompleks seperti pemfilteran dan penggabungan lanjutan. 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 x 40,0 meter (1.600 m²). Fungsi menampilkan hasil meskipun jumlah agregasi kurang dari 5 selama area penelusuran minimum terpenuhi.	Hasil dengan jumlah kurang dari 5 akan dihilangkan dari hasil (yaitu, baris dikecualikan).
Filter atribut yang didukung	Parameter filter fungsi jumlah tempat mendukung hal yang sama seperti filter atribut kueri langsung, kecuali: Tempat `id` Komponen alamat Jam buka Opsi pengisian daya EV Merek	Skema lengkap didukung.