查詢每月 POI 變化 (PLACES_COUNT_CHANGE)

PLACES_COUNT_CHANGE 函式會計算興趣點數量的變化，並擷取多個輸入地理區域之間兩個特定月份新增和移除的樣本地點 ID。

與 PLACES_COUNT_V2 類似，這個函式旨在接受地理區域的輸入表格參數，以進行有效率的批次處理，讓您同時評估多個地點的成長趨勢和商業變化。

語法

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

參數

• PROJECT_NAME：Google Cloud 專案的名稱。
• LINKED_DATASET_NAME：包含 Places Insights 函式的 BigQuery 資料集名稱 (例如 places_insights___us)。
• input_geographies：包含要分析地理區域的 BigQuery 資料表。這個資料表必須包含下列資料欄：
  • geo_id (STRING)： 每個地理區域的專屬 ID。
  • geo (GEOGRAPHY)： 代表區域的 BigQuery GEOGRAPHY 物件。可以是點、多邊形或其他地理位置類型。
• filters (JSON)： JSON 物件，包含用於篩選地點的鍵/值組合。請參閱「篩選參數」。必須包含下列篩選器：
  • month1 (STRING)： 要搜尋地點的第一個月。
  • month2 (STRING)： 要尋找地點的第二個月。

輸出資料表結構定義

PLACES_COUNT_CHANGE 函式會傳回含有下列資料欄的表格：

資料欄名稱	資料類型	說明
geo_id	STRING	輸入地理位置的 ID。
start_count	INT64	第一個月的地點數量。
end_count	INT64	第二個月的地點數量。
net_change	INT64	end_count 和 start_count 之間的差異 (end_count - start_count)。
percentage_change	FLOAT64	從第 1 個月到第 2 個月的百分比變化。
compound_monthly_growth_rate	FLOAT64	第 1 個月到第 2 個月的複合月成長率。
added_count	INT64	sample_added_place_ids 中的樣本地點 ID 數量。
removed_count	INT64	sample_removed_place_ids 中的樣本地點 ID 數量。
sample_added_place_ids	ARRAY<STRING>	第 2 個月有，但第 1 個月沒有的範例地點 ID 清單。
sample_removed_place_ids	ARRAY<STRING>	在第 1 個月出現，但第 2 個月沒有的範例地點 ID 清單。

結果會依 percentage_change 和 start_count 遞減排序。

運作方式

函式會處理 input_geographies 資料表中的每一列。針對每個 geo 物件，系統會計算在 filters 中指定的兩個月內，落入地理區域 (或 geography_radius 內，如果 geo 是點且半徑在 filters 中指定) 的地點數量。month1month2系統會根據這些地點計算其他實用統計資料，例如從第一個月到第二個月的百分比變化和每月複合成長率。

這項計數只會納入符合 filters JSON 物件中所有條件的地點。

示例：計算兩個月之間 POI 數量的變化

這個範例說明如何使用 month1 和 month2 參數，查詢兩個特定月份之間 POI 數量的變化，並以特定地理位置點為中心，半徑 5000 公尺的範圍為準。

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)
  )
);

分析輸出內容

查詢會傳回資料表，其中每個輸入地理區域各佔一個資料列。

• 成長指標：輸出內容會顯示基準計數 (start_count：89,560) 和比較計數 (end_count：90,923)，因此得出 +1,363 個地點 (+1.52% percentage_change)。net_change
• 實況檢查：sample_added_place_ids 陣列會列出 month2 (2026 年 2 月) 啟用的特定地點 ID，而 sample_removed_place_ids 則會列出不再存在的地點 ID。
• 橋接至 Places API：您可以將這些範例地點 ID 直接傳遞至Place Details API (新版)，查詢新開或已歇業商家的店名、地址和屬性。