H3_TRY_POLYGON_TO_CELLS_STRINGS
H3_TRY_POLYGON_TO_CELLS_STRINGS
중심점(centroid)이 Polygon(GEOGRAPHY 객체로 지정)에 포함된 H3 셀의 16진수 ID의 VARCHAR 값 배열을 반환하려는 시도에서 오류가 발생하면 NULL을 반환하는 H3_POLYGON_TO_CELLS_STRINGS의 특수 버전이에요.
출처: Snowflake SQL Reference - H3_TRY_POLYGON_TO_CELLS_STRINGS
본문
구문
H3_TRY_POLYGON_TO_CELLS_STRINGS( <geography_polygon> , <target_resolution> )
인자
- Polygon을 나타내는 GEOGRAPHY 객체예요.
- 반환되는 H3 셀에 사용할 H3 해상도를 지정하는 0과 15(포함) 사이의 INTEGER예요. 다른 INTEGER 값을 지정하면 오류가 발생해요.
반환 값
VARCHAR 값의 배열 또는 NULL을 반환해요.
- 함수가 성공적인 계산을 수행할 수 있으면 지정한 입력 Polygon에 포함된 중심점을 가진 H3 셀의 16진수 ID에 대한 VARCHAR 값 배열을 반환해요.
- 함수가 성공적인 계산을 수행할 수 없으면 오류를 보고하지 않고 NULL을 반환해요.
사용상 주의사항
사용상 주의사항은 H3_POLYGON_TO_CELLS_STRINGS를 참고해요.
예시
다음 예시는 중심점이 Polygon(GEOGRAPHY 객체로 지정)에 포함된 H3 셀의 16진수 ID의 VARCHAR 값 배열을 반환하려고 시도해요. 주어진 해상도에서 주어진 육각형을 덮는 셀이 있는 배열이 허용된 크기 제한을 초과하기 때문에 함수는 NULL을 반환해요.
SELECT H3_TRY_POLYGON_TO_CELLS_STRINGS(
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_STRINGS를 참고해요.