查詢每月 POI 變化 (PLACES_COUNT_CHANGE)

PLACES_COUNT_CHANGE 函式會計算 Places 數量的變化，並擷取多個輸入地理區域中，兩個特定月份之間新增和移除的地點 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 的 month1 和 month2 指定的兩個月內，落在地理區域 (或 geography_radius，如果 geo 是點且半徑在 filters 中指定) 內的地點數量。並根據這些地點計算其他實用的統計資料，例如從第一個月到第二個月的百分比變化和每月複合成長率。

計數只會包含符合 filters JSON 物件中定義的所有條件的地點。

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

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

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 個地點的net_change (+1.52% percentage_change)。
  • 基準真相檢查：sample_added_place_ids 陣列列出 month2 (2026 年 2 月) 啟用的特定地點 ID，sample_removed_place_ids 則列出不再存在的地點 ID。
  • 與 Places API 橋接：您可以將這些範例地點 ID 直接傳遞至 Place Details API (新版)，查詢新開幕或已停業商家的名稱、地址和屬性。

Places 數量變更函式的結果。