H3_TRY_POLYGON_TO_CELLS

H3_TRY_POLYGON_TO_CELLS (다각형 H3 셀 변환 - 오류 처리)

폴리곤(GEOGRAPHY 객체로 지정)에 중심점이 포함된 H3 셀의 ID 배열(INTEGER 값)을 반환하려 할 때 오류가 발생하면 NULL을 반환하는 H3_POLYGON_TO_CELLS의 특수 버전이에요.

출처: Snowflake SQL Reference - H3_TRY_POLYGON_TO_CELLS

본문

구문

H3_TRY_POLYGON_TO_CELLS( <geography_polygon> , <target_resolution> )

인자

geography_polygon

폴리곤을 나타내는 GEOGRAPHY 객체예요.

target_resolution

반환되는 H3 셀에 사용할 H3 해상도를 지정하는 0에서 15(포함) 사이의 INTEGER예요. 다른 INTEGER 값을 지정하면 오류가 발생해요.

반환 값

INTEGER 값의 배열 또는 NULL을 반환해요.

  • 계산을 성공적으로 수행하면 지정한 입력 폴리곤에 중심점이 포함된 H3 셀의 ID에 대한 INTEGER 값 배열을 반환해요.
  • 계산을 성공적으로 수행할 수 없으면 오류를 보고하지 않고 NULL을 반환해요.

사용 참고 사항

사용 참고 사항은 H3_POLYGON_TO_CELLS를 참고해요.

예시

다음 예시는 폴리곤(GEOGRAPHY 객체로 지정)에 중심점이 포함된 H3 셀의 ID에 대한 INTEGER 값 배열을 반환하려 시도해요. 주어진 해상도에서 주어진 육각형을 덮는 셀 배열이 허용 크기 제한을 초과하므로 함수는 NULL을 반환해요.

SELECT H3_TRY_POLYGON_TO_CELLS(
  TO_GEOGRAPHY('POLYGON((-108.959 40.948,
                         -109.015 37.077,
                         -102.117 36.956,
                         -102.134 40.953,
                         -108.959 40.948))'
              ), 15) AS h3_cells_in_polygon;

+---------------------+
| H3_CELLS_IN_POLYGON |
|---------------------|
| NULL                |
+---------------------+

ID 배열을 성공적으로 반환하는 예시는 H3_POLYGON_TO_CELLS를 참고해요.

더 알아보기