Mengueri perubahan POI antar-bulan (PLACES_COUNT_CHANGE)

Produk atau fitur ini ada dalam Pratinjau (pra-GA). Produk dan fitur pra-GA mungkin memiliki dukungan terbatas, dan perubahan pada produk serta fitur pra-GA mungkin tidak kompatibel dengan versi pra-GA lainnya. Penawaran Pra-GA tercakup dalam Persyaratan Khusus Layanan Google Maps Platform. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

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 wilayah geografis.
  • geo (GEOGRAPHY): Objek GEOGRAPHY BigQuery yang merepresentasikan area. Ini bisa berupa titik, poligon, atau jenis geografi lainnya.
• filters (JSON): Objek JSON yang berisi key-value pair untuk memfilter tempat. Lihat Parameter Filter. Filter ini harus mencakup 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 majemuk dari bulan1 ke bulan2.
added_count	INT64	Jumlah ID tempat sampel di sample_added_place_ids.
removed_count	INT64	Jumlah ID tempat sampel dalam sample_removed_place_ids.
sample_added_place_ids	ARRAY<STRING>	Daftar contoh ID tempat yang ada di month2, tetapi tidak ada di month1.
sample_removed_place_ids	ARRAY<STRING>	Daftar ID tempat sampel yang ada di bulan1, tetapi tidak ada di bulan2.

Hasil diurutkan berdasarkan percentage_change dan start_count menurun.

Cara kerjanya

Fungsi ini memproses setiap baris dalam tabel input_geographies. Untuk setiap objek geo, objek 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, alat ini menghitung statistik berguna lainnya seperti persentase perubahan dan tingkat pertumbuhan bulanan gabungan dari bulan pertama hingga kedua.

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

Contoh: Menghitung perubahan jumlah POI antara dua bulan

Contoh ini menunjukkan cara mengkueri perubahan jumlah POI 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 ini 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), sehingga menghasilkan net_change +1.363 tempat (+1,52% percentage_change).
• Pemeriksaan data sebenarnya: Array sample_added_place_ids mencantumkan ID Tempat tertentu yang menjadi aktif di month2 (Februari 2026), sementara sample_removed_place_ids mencantumkan ID Tempat yang tidak lagi ada.
• Bridge to Places API: Anda dapat meneruskan contoh ID Tempat ini langsung ke Place Details API (Baru) untuk mencari nama, alamat, dan atribut toko untuk bisnis yang baru dibuka atau ditutup.