PLACES_COUNT_PER_GEO 함수

PLACES_COUNT_PER_GEO 함수는 검색할 지리적 영역의 배열을 가져와 영역당 장소 수 표를 반환합니다. 예를 들어 우편번호 배열을 검색 영역으로 지정하면 응답에는 각 우편번호에 대한 별도의 행이 있는 표가 포함됩니다.

PLACES_COUNT_PER_GEO 함수는 테이블을 반환하므로 FROM 절을 사용하여 호출합니다.

• 입력 매개변수:

  • 필수: 검색 영역을 지정하는 geographies 필터 매개변수입니다. geographies 매개변수는 점, 선 문자열, 다각형을 지원하는 BigQuery GEOGRAPHY 데이터 유형으로 정의된 값 배열을 사용합니다.

  • 선택사항: 검색을 상세검색하기 위한 추가 필터 매개변수입니다.

• 반환:

  • 지리적 영역당 하나의 행이 있는 표입니다. 테이블에는 geography (GEOGRAPHY), count (INT64), place_ids(ARRAY<STRING>) 열이 포함되어 있으며, 여기서 place_ids에는 각 지리적 영역에 대해 최대 250개의 장소 ID가 포함됩니다.

예시: 뉴욕시의 각 카운티에 있는 음식점 수 계산

이 예시에서는 뉴욕시의 카운티별 영업 중인 음식점 수를 집계한 테이블을 생성합니다.

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

그런 다음 이 예시에서는 BigQuery ST_SIMPLIFY 함수를 사용하여 간소화된 버전의 county_geom를 반환합니다. ST_SIMPLIFY 함수는 직선에 가까운 모서리 체인을 단일 긴 모서리로 대체합니다.

DECLARE geos ARRAY<GEOGRAPHY>;

SET geos = (SELECT ARRAY_AGG(ST_SIMPLIFY(county_geom, 100))
            FROM `bigquery-public-data.geo_us_boundaries.counties`
            WHERE county_name IN ("Queens","Kings", "New York") AND state_fips_code = "36");

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_GEO`(
  JSON_OBJECT(
      'geographies', geos,
      'types', ["restaurant"],
      'business_status', ["OPERATIONAL"]
      )
);

예시: 브랜드별로 필터링된 카운티별 개수 계산

다음 예에서는 brand_ids 필터를 사용하여 특정 브랜드(예: 스타벅스 "1413758728321880760")의 장소 수와 샘플 장소 ID를 검색합니다.

DECLARE geos ARRAY<GEOGRAPHY>;

SET geos = (SELECT ARRAY_AGG(ST_SIMPLIFY(county_geom, 100))
            FROM `bigquery-public-data.geo_us_boundaries.counties`
            WHERE county_name IN ("Queens","Kings", "New York") AND state_fips_code = "36");

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_GEO`(
  JSON_OBJECT(
      'geographies', geos,
      'brand_ids', ["1413758728321880760"], -- Filter for Starbucks
      'business_status', ["OPERATIONAL"]
      )
);

결과 시각화

다음 이미지는 이 데이터가 Looker Studio에서 각 카운티의 윤곽선을 포함한 등치 지역도로 표시되는 것을 보여줍니다.

데이터를 Looker Studio로 가져오려면 다음 단계를 따르세요.

1. 위의 함수를 실행하여 결과를 생성합니다.

2. BigQuery 결과에서 다음에서 열기 -> Looker Studio를 클릭합니다. 결과는 Looker Studio로 자동으로 가져옵니다.

3. Looker Studio는 기본 보고서 페이지를 만들고 결과의 제목, 표, 막대 그래프로 초기화합니다.

   

4. 페이지의 모든 항목을 선택하고 삭제합니다.

5. 삽입 -> 음영 지도를 클릭하여 보고서에 음영 지도를 추가합니다.

6. 차트 유형 -> 설정에서 아래와 같이 필드를 구성합니다.

   

7. 채워진 지도가 위와 같이 표시됩니다. 원하는 경우 차트 유형 -> 스타일을 선택하여 지도의 모양을 추가로 구성할 수 있습니다.

장소 통계 결과를 시각화하는 방법에 관한 자세한 내용과 예시는 쿼리 결과 시각화를 참고하세요.