月間の 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 Platform プロジェクトの名前です。
  • LINKED_DATASET_NAME: Places Insights 関数を含む BigQuery データセットの名前（例: places_insights___us）。
  • input_geographies: 分析する地域を含む BigQuery テーブル。このテーブルには、次の列が必要です。
    • geo_id (STRING): 各地域の固有の識別子。
    • geo （GEOGRAPHY）: 領域を表す BigQuery GEOGRAPHY オブジェクト。ポイント、ポリゴン、その他の地理情報タイプを指定できます。
  • filters (JSON): 場所をフィルタリングするための Key-Value ペアを含む 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 月 1 から月 2 までの複合月次成長率。
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 オブジェクトについて、filters の month1 と month2 で指定された 2 か月間に、その地理的範囲内（または、geo がポイントで、半径が filters の geography_radius で指定されている場合は、その範囲内）にある場所の数をカウントします。これらの場所を使用して、最初の月から 2 番目の月までの変化率や月ごとの複合成長率など、他の有用な統計情報を計算します。

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

例: 2 か月間の POI 数の変化を計算する

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

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 プレイス（+1.52% percentage_change）になります。
  • グラウンド トゥルースの検査: sample_added_place_ids 配列には、month2（2026 年 2 月）に有効になった特定の場所 ID がリストされます。一方、sample_removed_place_ids には、存在しなくなった場所 ID がリストされます。
  • Places API へのブリッジ: これらのサンプル Place ID を Place Details API（新規）に直接渡して、新規オープンまたは閉店したビジネスの店舗名、住所、属性を検索できます。

Places Count Change 関数の結果。