H3_POLYGON_TO_CELLS

H3_POLYGON_TO_CELLS

H3_POLYGON_TO_CELLS() 함수는 중심(centroid)이 Polygon(GEOGRAPHY 객체로 지정)에 포함되는 H3 셀 ID의 INTEGER 값 배열을 반환해요.

출처: Snowflake SQL Reference

본문

문법

H3_POLYGON_TO_CELLS( <geography_polygon> , <target_resolution> )

인자

  • geography_polygon — 중심 기준으로 셀을 포함할 Polygon GEOGRAPHY 객체예요.
  • target_resolution — 대상 해상도예요.

반환

중심이 지정된 입력 Polygon에 포함되는 H3 셀의 ID에 대한 INTEGER 값 배열을 반환해요.

사용 메모

  • 이 함수는 지표면의 점이 곡선 호(arc)가 아닌 직선으로 연결된 것처럼 취급하는 평면 근사(planar approximation)를 사용해요. 구면 근사가 필요하면 H3_COVERAGE를 대신 사용하세요.
  • 셀의 중심이 Polygon에 포함되면 그 셀은 Polygon 안에 있는 것으로 간주돼요.
  • 함수가 반환한 배열에 FLATTEN을 적용할 때는 각 값을 명시적으로 정수로 캐스팅하세요.

예제

다음 예제는 중심이 지정된 Polygon에 포함되는 H3 셀 ID의 ARRAY를 반환해요.

SELECT H3_POLYGON_TO_CELLS(
  TO_GEOGRAPHY(
    'POLYGON((-122.481889 37.826683,-122.479487 37.808548,-122.474150 37.808904,-122.476510 37.826935,-122.481889 37.826683))'
  ),
  9) AS h3_cells_in_polygon;
+-----------------------+
| H3_CELLS_IN_POLYGON   |
|-----------------------|
| [                     |
|   617700171176476671, |
|   617700171168874495, |
|   617700171177525247, |
|   617700171167563775, |
|   617700171225497599, |
|   617700171188011007, |
|   617700171168350207, |
|   617700171168612351, |
|   617700171167825919  |
| ]                     |
+-----------------------+

더 알아보기