PLACES_COUNT_PER_H3 함수

PLACES_COUNT_PER_H3 함수는 검색할 지리적 영역을 가져와 검색 영역의 H3 셀당 장소 수 테이블을 반환합니다.

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

• 입력 매개변수:

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

    뷰포트, 선과 같은 다양한 유형의 검색 지리를 사용하는 예는 PLACES_COUNT 함수를 참고하세요.

  • 필수: 각 H3 셀의 장소 수를 집계하는 데 사용되는 H3 해상도를 지정하는 h3_resolution 필터 매개변수입니다. 지원되는 값은 0~11입니다.

  • 선택 사항: 검색을 구체화하는 추가 필터 매개변수입니다.

• 반환:

  • H3 셀당 하나의 행이 있는 테이블입니다. 테이블에는 H3 셀을 나타내는 다각형을 정의하는 h3_cell_index (STRING), geography (GEOGRAPHY), count (INT64), place_ids (ARRAY<STRING>) 열이 포함됩니다. 여기서 place_ids에는 각 H3 셀의 장소 ID가 최대 250개 포함됩니다.

예: H3 셀당 휠체어 접근이 가능한 편의점 및 식료품점 수 계산

아래 예에서는 뉴욕시의 H3 셀당 운영 중이며 휠체어 접근이 가능한 편의점 및 식료품점 수를 계산합니다. H3 셀은 해상도 수준 8을 사용합니다.

이 예에서는 Overture Maps Data BigQuery 공개 데이터 세트를 사용하여 뉴욕시의 지리를 가져옵니다.

DECLARE geo GEOGRAPHY;

-- Get the geography for New York City.
SET geo = (SELECT geometry FROM `bigquery-public-data.overture_maps.division_area`
  WHERE country = 'US' AND subtype = 'locality' AND names.primary = 'New York'  LIMIT 1);

SELECT * FROM `PROJECT_NAME.places_insights___us.PLACES_COUNT_PER_H3`(
  JSON_OBJECT(
      'geography', geo,
      'types', ["convenience_store","grocery_store"],
      'wheelchair_accessible_entrance', true,
      'business_status', ['OPERATIONAL'],
      'h3_resolution', 8
    )
);

함수의 응답:

결과 시각화

다음 이미지는 Looker Studio에서 채워진 지도로 표시된 이 데이터를 보여줍니다. H3 셀이 어두울수록 결과의 집중도가 높습니다.

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

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

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

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

   

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

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

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

   

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

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