Mengueri perubahan POI antar-bulan (PLACES_COUNT_CHANGE)

Fungsi PLACES_COUNT_CHANGE menghitung perubahan jumlah Tempat Menarik dan mengambil sampel ID Tempat yang ditambahkan dan dihapus antara dua bulan tertentu di beberapa geografi input.

Seperti PLACES_COUNT_V2, fungsi ini dirancang untuk batch processing yang efisien dengan menerima parameter tabel input geografi, sehingga Anda dapat mengevaluasi tren pertumbuhan dan perubahan komersial di banyak lokasi secara bersamaan.

Sintaksis

SELECT *
FROM
  `PROJECT_NAME.LINKED_DATASET_NAME.PLACES_COUNT_CHANGE`(
    TABLE input_geographies,
    filters
  );

Parameter

  • PROJECT_NAME: Nama project Google Cloud Anda.
  • LINKED_DATASET_NAME: Nama set data BigQuery yang berisi fungsi Places Insights (misalnya, places_insights___us).
  • input_geographies: Tabel BigQuery yang berisi geografi yang akan dianalisis. Tabel ini harus menyertakan kolom berikut:
    • geo_id (STRING): ID unik untuk setiap geografi.
    • geo (GEOGRAPHY): Objek GEOGRAPHY BigQuery yang mewakili area. Objek ini dapat berupa titik, poligon, atau jenis geografi lainnya.
  • filters (JSON): Objek JSON yang berisi pasangan nilai kunci untuk memfilter tempat. Lihat Parameter Filter. Objek ini harus menyertakan filter berikut:
    • month1 (STRING): Bulan pertama untuk mencari tempat.
    • month2 (STRING): Bulan kedua untuk mencari tempat.

Skema tabel output

Fungsi PLACES_COUNT_CHANGE menampilkan tabel dengan kolom:

Nama kolom Jenis data Deskripsi
geo_id STRING ID dari geografi input.
start_count INT64 Jumlah tempat dari bulan pertama.
end_count INT64 Jumlah tempat dari bulan kedua.
net_change INT64 Perbedaan antara end_count dan start_count (end_count - start_count).
percentage_change FLOAT64 Perubahan persentase dari bulan1 ke bulan2.
compound_monthly_growth_rate FLOAT64 Tingkat pertumbuhan bulanan gabungan dari bulan1 ke bulan2.
added_count INT64 Jumlah ID tempat sampel di sample_added_place_ids.
removed_count INT64 Jumlah ID tempat sampel di sample_removed_place_ids.
sample_added_place_ids ARRAY<STRING> Daftar ID tempat sampel yang ada di bulan2, tetapi tidak ada di bulan1.
sample_removed_place_ids ARRAY<STRING> Daftar ID tempat sampel yang ada di bulan1, tetapi tidak ada di bulan2.

Hasilnya diurutkan berdasarkan percentage_change dan start_count menurun.

Cara kerjanya

Fungsi ini memproses setiap baris dalam tabel input_geographies. Untuk setiap geo objek, fungsi ini menghitung jumlah tempat yang berada dalam geografi (atau dalam geography_radius jika geo adalah titik dan radius ditentukan dalam filters) dalam dua bulan yang ditentukan dalam month1 dan month2 di filters. Dengan menggunakan tempat tersebut, fungsi ini menghitung statistik berguna lainnya seperti perubahan persentase dan tingkat pertumbuhan bulanan gabungan dari bulan pertama hingga kedua.

Jumlah tersebut hanya mencakup tempat yang cocok dengan semua kondisi yang ditentukan dalam objek JSON filters.

Contoh: Menghitung perubahan jumlah TMI antara dua bulan

Contoh ini menunjukkan cara membuat kueri perubahan jumlah TMI antara dua bulan tertentu menggunakan parameter month1 dan month2, dengan radius 5.000 dari titik geolokasi tertentu.

WITH my_locations AS (
  SELECT
    'loc_1' AS geo_id,
    ST_GEOGFROMTEXT('POINT(-122.4194 37.7749)') AS geo
  -- Add more target locations as needed...
)

SELECT *
FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_CHANGE`(
  TABLE my_locations,
  JSON_OBJECT(
    'geography_radius', 5000,
    'month1', '2026-01', -- Baseline snapshot month (YYYY-MM)
    'month2', '2026-02'  -- Comparison snapshot month (YYYY-MM)
  )
);

Menganalisis output

Kueri menampilkan tabel dengan baris untuk setiap geografi input.

  • Metrik pertumbuhan: Output menampilkan jumlah dasar (start_count: 89.560) dan jumlah perbandingan (end_count: 90.923), yang menghasilkan net_change +1.363 tempat (+1,52% percentage_change).
  • Pemeriksaan kebenaran dasar: Array sample_added_place_ids mencantumkan ID Tempat tertentu yang menjadi aktif di month2 (Februari 2026), sedangkan sample_removed_place_ids mencantumkan ID Tempat yang tidak lagi ada.
  • Penghubung ke Places API: Anda dapat meneruskan ID Tempat sampel ini langsung ke Place Details API (Baru) untuk mencari nama toko, alamat, dan atribut untuk bisnis yang baru dibuka atau ditutup.

Hasil untuk fungsi Perubahan Jumlah Tempat.