H3_POLYGON_TO_CELLS_STRINGS

H3_POLYGON_TO_CELLS_STRINGS

중심점(centroid)이 Polygon(GEOGRAPHY 객체로 지정) 안에 포함되는 H3 셀들의 16진수 ID를 담은 VARCHAR 값 배열을 반환해요.

출처: Snowflake SQL Reference - H3_POLYGON_TO_CELLS_STRINGS

본문

구문

H3_POLYGON_TO_CELLS_STRINGS( <geography_polygon> , <target_resolution> )

인자

geography_polygon

  • Polygon을 나타내는 GEOGRAPHY 객체예요.

target_resolution

  • 반환할 H3 셀에 사용할 H3 해상도를 지정하는 0 이상 15 이하의 INTEGER예요. 이 범위 밖의 다른 INTEGER 값을 지정하면 오류가 발생해요.

반환 값

중심점이 지정한 입력 Polygon 안에 포함되는 H3 셀들의 16진수 ID를 담은 VARCHAR 값 배열을 반환해요.

사용 시 참고 사항

  • 이 함수는 평면 근사(planar approximation)를 사용하며, 지구 표면의 점들을 곡선 호가 아닌 직선으로 연결된 것처럼 다뤄요. 구면 근사가 필요하면 H3_COVERAGE_STRINGS를 대신 사용하세요.
  • 셀의 중심점이 Polygon 안에 포함되면 해당 셀은 Polygon 안에 있는 것으로 간주돼요.

예시

다음 예시는 중심점이 지정한 Polygon 안에 포함되는 H3 셀들의 16진수 ID를 나타내는 VARCHAR 값 배열(ARRAY)을 반환해요.

SELECT H3_POLYGON_TO_CELLS_STRINGS(
  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  |
|----------------------|
| [                    |
|   "8928308715bffff", |
|   "89283087397ffff", |
|   "89283087023ffff", |
|   "892830870abffff", |
|   "89283087027ffff", |
|   "89283087033ffff", |
|   "8928308702fffff", |
|   "892830870bbffff", |
|   "89283087037ffff"  |
| ]                    |
+----------------------+

더 알아보기