PLACES_COUNT_V2 함수

PLACES_COUNT_V2 함수는 지정된 필터를 기반으로 여러 입력 지역의 장소 수와 샘플 장소 ID가 포함된 BigQuery 테이블을 반환합니다. 이 함수는 지역의 입력 테이블 매개변수를 수락하여 효율적인 일괄 처리를 위해 설계되었으며, 입력 테이블을 통해 지역을 제공하여 단일 쿼리에서 관심 있는 여러 영역을 분석할 수 있습니다.

구문

SELECT * FROM `PROJECT_NAME.LINKED_DATASET_NAME.PLACES_COUNT_V2`(
  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 객체입니다. 필터 매개변수를 참고하세요.

출력 테이블 스키마

PLACES_COUNT_V2 함수는 다음 열이 포함된 테이블을 반환합니다.

열 이름 데이터 유형 설명
geo_id STRING input_geographies 테이블의 입력 지역에 대한 고유 식별자입니다.
input_geography GEOGRAPHY input_geographies 테이블의 원래 GEOGRAPHY 객체입니다.
place_count INTEGER 필터와 일치하는 총 장소 수입니다.
sample_place_ids ARRAY<STRING> 기준과 일치하는 최대 250개의 장소 ID 배열입니다.

작동 방식

함수는 input_geographies 테이블의 각 행을 처리합니다. 각 geo 객체에 대해 지리 내에 있는 장소의 수를 계산합니다 (또는 geo이 점이고 반경이 filters에 지정된 경우 geography_radius 내). 개수에는 filters JSON 객체에 정의된 모든 조건을 충족하는 장소만 포함됩니다.

예: 뉴욕시 3개 카운티의 레스토랑 수 계산

이 예에서는 뉴욕시의 세 카운티에 있는 운영 중인 식당 수를 보여주는 표를 생성합니다.

이 예에서는 미국 인구조사국 데이터 BigQuery 공개 데이터 세트를 사용하여 뉴욕시의 세 카운티('퀸스', '킹스', '뉴욕')의 경계를 가져옵니다. 각 카운티의 경계는 county_geom 열에 포함됩니다.

먼저 각 카운티의 geo_id와 단순화된 GEOGRAPHY를 저장할 임시 테이블 new_york_counties를 만듭니다.

SELECT *
FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_V2`(
  (
    SELECT
      county_name AS geo_id,
      ST_SIMPLIFY(county_geom, 100) AS geo
    FROM
      `bigquery-public-data.geo_us_boundaries.counties`
    WHERE
      state_fips_code = "36"  -- New York State
      AND county_name IN ("Queens", "Kings", "New York")
  ),
  JSON_OBJECT(
      'types', ["restaurant"],
      'business_status', ['OPERATIONAL']
  )
);

대답 표에는 각 카운티에 대한 행이 3개 있으며, 운영 중인 레스토랑의 geo_id, input_geography, place_count, sample_place_ids가 표시됩니다.

뉴욕 카운티의 장소 수 함수 결과

PLACES_COUNT_V2 사용의 이점

PLACES_COUNT_V2은 PLACES_COUNT 및 PLACES_COUNT_PER_GEO에 비해 다음과 같은 상당한 이점을 제공합니다.

  • 일괄 처리: 표에 여러 지역 입력을 제공하여 단일 쿼리에서 수천 개의 맞춤 지역을 효율적으로 분석합니다.
  • 성능: BigQuery의 최적화된 지리정보 조인을 활용하여 대규모 데이터 세트의 속도를 크게 높입니다.
  • 확장성: 단일 JSON 매개변수 크기의 제한 없이 많은 수의 입력 지리적 위치를 처리하도록 설계되었습니다.
  • 0개 포함: PLACES_COUNT_V2는 입력 테이블에 제공된 모든 geo_id의 행을 반환합니다. 특정 지역의 기준과 일치하는 장소가 없으면 place_count는 0입니다. 이렇게 하면 각 입력 영역에 결과가 표시되므로 장소가 누락된 위치를 확인할 수 있습니다.