Tentang data dan kueri Insight Tempat

Data Places Insights

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

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 sebesar 1. Baris hasil hanya ditampilkan jika menggabungkan setidaknya 1 tempat. Jika kriteria penelusuran Anda cocok dengan 0 tempat, baris tersebut akan dihilangkan dari respons.

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 m2). 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 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 menampilkan ID Tempat untuk mencari informasi tempat tertentu seperti nama atau alamat tempat, atau jika Anda ingin kueri menampilkan jumlah 0 secara eksplisit, bukan menghilangkannya.

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.
  • Menampilkan jumlah 0 eksplisit.
  • 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, termasuk jumlah 0, selama area penelusuran minimum terpenuhi. Hasil dengan jumlah 0 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.