H3_LATLNG_TO_CELL_STRING

H3_LATLNG_TO_CELL_STRING

주어진 위도, 경도, 해상도에 대해 H3 셀 ID를 16진수 형식(VARCHAR 값)으로 반환해요.

출처: Snowflake SQL Reference - H3_LATLNG_TO_CELL_STRING

본문

구문

H3_LATLNG_TO_CELL_STRING( <latitude> , <longitude> , <target_resolution> )

인자

latitude

  • 위도를 나타내는 FLOAT예요. 표준 위도 범위 밖의 값은 [-90, 90] 범위로 감싸져요.

longitude

  • 경도를 나타내는 FLOAT예요. 표준 경도 범위 밖의 값은 [-180, 180] 범위로 감싸져요.

target_resolution

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

반환 값

주어진 위치와 해상도에 해당하는 16진수 H3 셀 ID를 나타내는 VARCHAR 값을 반환해요.

사용 시 참고 사항

  • 어떤 입력 인자에 NaN 또는 Inf 값을 지정하면 오류가 발생해요.

예시

다음 예시는 해상도 8에서 브란덴부르크 문(Brandenburg Gate)의 16진수 H3 셀 ID를 반환해요.

SELECT H3_LATLNG_TO_CELL_STRING(52.516262, 13.377704, 8);

+---------------------------------------------------+
| H3_LATLNG_TO_CELL_STRING(52.516262, 13.377704, 8) |
|---------------------------------------------------|
|  881F1D4887FFFFF                                  |
+---------------------------------------------------+

다음 예시는 전통적인 경도 범위(-180 ~ 180)를 벗어난 경도 값(373.377704)을 지정해요. 함수는 이 값을 13.377704(373.377704 modulo 180)로 해석해요.

SELECT H3_LATLNG_TO_CELL_STRING(52.516262, 373.377704, 8);

+---------------------------------------------------+
| H3_LATLNG_TO_CELL_STRING(52.516262, 13.377704, 8) |
|---------------------------------------------------|
|  881F1D4887FFFFF                                  |
+---------------------------------------------------+

다음 예시는 해상도로 0~15 범위 밖의 값을 지정할 수 없음을 보여줘요.

SELECT H3_LATLNG_TO_CELL_STRING(52.516262, 373.377704, 18);

100410 (P0000): Invalid H3 resolution value: 18. Resolution must be between 0 (coarsest) and 15 (finest).

더 알아보기