Fungsi PLACES_COUNT_PER_GEO

Fungsi PLACES_COUNT_PER_GEO menggunakan array area geografis untuk ditelusuri dan menampilkan tabel jumlah tempat per area. Misalnya, jika Anda menentukan array kode pos sebagai area penelusuran, responsnya akan berisi tabel dengan baris terpisah untuk setiap kode pos.

Karena fungsi PLACES_COUNT_PER_GEO menampilkan tabel, panggil fungsi tersebut menggunakan klausa FROM.

  • Parameter input:

    • Wajib: Parameter filter geographies yang menentukan area penelusuran. Parameter geographies mengambil array nilai yang ditentukan oleh jenis data GEOGRAPHY BigQuery, yang mendukung titik, linestring, dan poligon.

    • Opsional: Parameter filter tambahan untuk mempersempit penelusuran Anda.

  • Returns:

    • Tabel dengan satu baris per area geografis. Tabel ini berisi kolom geography (GEOGRAPHY), count (INT64), dan place_ids (ARRAY<STRING>) dengan place_ids berisi hingga 250 ID tempat untuk setiap area geografis.

Contoh: Menghitung jumlah restoran di setiap county di New York City

Contoh ini menghasilkan tabel jumlah restoran yang beroperasi per county di New York City.

Contoh ini menggunakan set data publik BigQuery Data Biro Sensus Amerika Serikat untuk mendapatkan batas tiga county di New York City: "Queens","Kings", "New York". Batas setiap county terdapat dalam kolom county_geom.

Contoh ini kemudian menggunakan fungsi ST_SIMPLIFY BigQuery untuk menampilkan versi county_geom yang disederhanakan. Fungsi ST_SIMPLIFY mengganti rantai tepi yang hampir lurus dengan satu tepi panjang.

DECLARE geos ARRAY<GEOGRAPHY>;

SET geos = (SELECT ARRAY_AGG(ST_SIMPLIFY(county_geom, 100))
            FROM `bigquery-public-data.geo_us_boundaries.counties`
            WHERE county_name IN ("Queens","Kings", "New York") AND state_fips_code = "36");

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_GEO`(
  JSON_OBJECT(
      'geographies', geos,
      'types', ["restaurant"],
      'business_status', ["OPERATIONAL"]
      )
);

Contoh: Menghitung jumlah per county yang difilter menurut merek

Contoh berikut menggunakan filter brand_ids untuk mengambil jumlah tempat dan contoh ID tempat untuk merek tertentu, seperti Starbucks "1413758728321880760":

DECLARE geos ARRAY<GEOGRAPHY>;

SET geos = (SELECT ARRAY_AGG(ST_SIMPLIFY(county_geom, 100))
            FROM `bigquery-public-data.geo_us_boundaries.counties`
            WHERE county_name IN ("Queens","Kings", "New York") AND state_fips_code = "36");

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_GEO`(
  JSON_OBJECT(
      'geographies', geos,
      'brand_ids', ["1413758728321880760"], -- Filter for Starbucks
      'business_status', ["OPERATIONAL"]
      )
);

Memvisualisasikan hasil

Gambar berikut menunjukkan data ini ditampilkan di Looker Studio sebagai peta wilayah, termasuk garis batas setiap county:

Peta terisi untuk memfilter minimarket dan toko kelontong yang dapat diakses dengan kursi roda di New York City.

Untuk mengimpor data ke Looker Studio:

  1. Jalankan fungsi di atas untuk menghasilkan hasil.

  2. Di hasil BigQuery, klik Open in -> Looker Studio. Hasil Anda akan otomatis diimpor ke Looker Studio.

  3. Looker Studio membuat halaman laporan default dan menginisialisasinya dengan judul, tabel, dan grafik batang dari hasil.

    Laporan default di Looker Studio.

  4. Pilih semuanya di halaman, lalu hapus.

  5. Klik Sisipkan -> Peta bidang untuk menambahkan peta bidang ke laporan Anda.

  6. Di bagian Chart types -> Setup, konfigurasikan kolom seperti yang ditunjukkan di bawah:

    Penyiapan peta panas di Looker Studio.

  7. Peta yang terisi akan muncul seperti di atas. Anda dapat memilih Chart types -> Styles untuk mengonfigurasi tampilan peta lebih lanjut.

Untuk mengetahui informasi dan contoh selengkapnya tentang cara memvisualisasikan hasil Places Insights, lihat Memvisualisasikan hasil kueri.