月間の POI の変化をクエリする（PLACES_COUNT_CHANGE）

PLACES_COUNT_CHANGE 関数は、複数の入力地域にわたる 2 つの特定の月の間のスポット数の変化を計算し、追加および削除されたスポット 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): 各地域の固有の識別子。
    • geo （GEOGRAPHY）： エリアを表す BigQuery GEOGRAPHY オブジェクト。これは、ポイント、ポリゴン、その他の地理タイプにできます。
  • filters (JSON): スポットをフィルタするためのキーと値のペアを含む JSON オブジェクト。 フィルタ パラメータをご覧ください。次のフィルタを含める必要があります。
    • month1 (STRING): スポットを検索する最初の月。
    • month2 (STRING): スポットを検索する 2 番目の月。

出力テーブル スキーマ

PLACES_COUNT_CHANGE 関数は、次の列を含むテーブルを返します。

列名 データ型 説明
geo_id STRING 入力地域の ID。
start_count INT64 最初の月のスポット数。
end_count INT64 2 番目の月のスポット数。
net_change INT64 end_count と start_count の差（end_count - start_count）。
percentage_change FLOAT64 month1 から month2 への変化率。
compound_monthly_growth_rate FLOAT64 month1 から month2 までの複合月次成長率。
added_count INT64 sample_added_place_ids 内のサンプル スポット ID の数。
removed_count INT64 sample_removed_place_ids 内のサンプル スポット ID の数。
sample_added_place_ids ARRAY<STRING> month2 に存在し、month1 に存在しないサンプル スポット ID のリスト。
sample_removed_place_ids ARRAY<STRING> month1 に存在し、month2 に存在しないサンプル スポット ID のリスト。

結果は、percentage_change と start_count の降順で並べ替えられます。

仕組み

この関数は、input_geographies テーブルの各行を処理します。各 geo オブジェクトについて、その地域内（または geo がポイントで、半径が filters で指定されている場合は geography_radius 内）にあるスポットの数を、filters の month1 と month2 で指定された 2 か月間にカウントします。これらのスポットを使用して、最初の月から 2 番目の月までの変化率や複合月次成長率など、他の有用な統計情報を計算します。

カウントには、filters JSON オブジェクトで定義されたすべての条件に一致するスポットのみが含まれます。

例: 2 か月間のスポット数の変化を計算する

この例では、指定された地理位置情報ポイントから半径 5, 000 の範囲で、month1 パラメータと month2 パラメータを使用して、2 つの特定の月のスポット数の変化をクエリする方法を示します。

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

出力を分析する

このクエリは、入力地域ごとに 1 行を含むテーブルを返します。

  • 成長指標: 出力には、ベースライン数（start_count: 89,560）と比較数（end_count: 90,923）が表示され、net_change は +1,363 スポット（percentage_change は +1.52%）になります。
  • グラウンド トゥルースの検査: sample_added_place_ids 配列には、month2（2026 年 2 月）に有効になった特定のスポット ID が一覧表示され、sample_removed_place_ids には存在しなくなったスポット ID が一覧表示されます。
  • Places API へのブリッジ: これらのサンプル スポット ID を Place Details API （New）に直接渡して、 新規オープンまたは閉店した ビジネスの店舗名、住所、属性を検索できます。

Places Count Change 関数の結果。