월별 관심 장소 변경사항 쿼리 (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: 장소 통계 함수가 포함된 BigQuery 데이터 세트의 이름입니다 (예: places_insights___us).
  • input_geographies: 분석할 지역이 포함된 BigQuery 테이블입니다. 이 테이블에는 다음 열이 반드시 포함되어야 합니다.
    • geo_id(STRING): 각 지역의 고유 식별자입니다.
    • geo(GEOGRAPHY): 영역을 나타내는 BigQuery GEOGRAPHY 객체입니다. 이는 점, 다각형 또는 기타 지리 유형일 수 있습니다.
  • filters(JSON): 장소를 필터링하기 위한 키-값 쌍이 포함된 JSON 객체입니다. 필터 매개변수를 참조하세요. 다음 필터를 포함해야 합니다.
    • month1(STRING): 장소를 찾을 첫 번째 월입니다.
    • month2(STRING): 장소를 찾을 두 번째 월입니다.

출력 테이블 스키마

PLACES_COUNT_CHANGE 함수는 다음 열이 있는 테이블을 반환합니다.

열 이름 데이터 유형 설명
geo_id 문자열 입력 지역의 ID입니다.
start_count INT64 첫 달의 장소 수입니다.
end_count INT64 두 번째 달의 장소 수입니다.
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에 지정된 두 달 동안 지리적 위치 (또는 geo가 지점이고 반경이 filters에 지정된 경우 geography_radius 내)에 속하는 장소의 수를 계산합니다. 이러한 장소를 사용하여 첫 번째 달부터 두 번째 달까지의 백분율 변화 및 복합 월간 성장률과 같은 다른 유용한 통계를 계산합니다.

개수에는 filters JSON 객체에 정의된 모든 조건과 일치하는 장소만 포함됩니다.

예: 두 달 사이의 관심 장소 수 변화 계산

이 예시에서는 month1 및 month2 매개변수를 사용하여 특정 두 달 사이의 관심 장소 수 변화를 쿼리하는 방법을 보여줍니다. 이때 지정된 위치정보 지점에서 반경 5, 000m를 기준으로 합니다.

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)가 표시되며, net_change는 +1,363개 장소 (+1.52% percentage_change)입니다.
  • 정답 검사: sample_added_place_ids 배열에는 month2 (2026년 2월)에 활성화된 특정 장소 ID가 나열되고, sample_removed_place_ids에는 더 이상 존재하지 않는 장소 ID가 나열됩니다.
  • Places API로 연결: 이러한 샘플 장소 ID를 장소 세부정보 API(New)에 직접 전달하여 새로 개업하거나 폐업한 비즈니스의 매장 이름, 주소, 속성을 조회할 수 있습니다.

장소 수 변경 함수 결과