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 객체의 경우 지리 내에 있는 장소 수 (또는 geography_radius가 점이고 반경이 filters에 지정된 경우 내)를 계산합니다. 개수에는 filters JSON 객체에 정의된 모든 조건을 충족하는 장소만 포함됩니다.geo

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

이 예에서는 뉴욕시 3개 카운티의 운영 중인 레스토랑 수를 보여주는 테이블을 생성합니다.

이 예에서는 미국 인구조사국 데이터 BigQuery 공개 데이터 세트를 사용하여 뉴욕시의 3개 카운티('퀸스', '킹스', '뉴욕')의 경계를 가져옵니다. 각 카운티의 경계는 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']
  )
);

응답 테이블에는 각 카운티에 대해 하나씩 세 개의 행이 있으며 운영 중인 레스토랑의 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이 됩니다. 이렇게 하면 각 입력 영역에 대한 결과가 있으므로 장소가 없는 위치를 확인할 수 있습니다.