H3_LATLNG_TO_CELL

H3_LATLNG_TO_CELL

위도·경도·해상도(resolution)가 주어졌을 때 해당 위치의 H3 셀 ID를 INTEGER 값으로 돌려주는 공간 함수예요.

출처: 공식 문서

본문

주어진 위도, 경도, 해상도에 대한 H3 셀 ID의 INTEGER 값을 반환합니다.

참고 (See also): H3_LATLNG_TO_CELL_STRING

구문 (Syntax)

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

인자 (Arguments)

latitude

위도를 나타내는 FLOAT입니다. 표준 위도 범위를 벗어나는 값은 [-90, 90] 범위로 감싸집니다(wrap).

longitude

경도를 나타내는 FLOAT입니다. 표준 경도 범위를 벗어나는 값은 [-180, 180] 범위로 감싸집니다.

target_resolution

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

반환값 (Returns)

주어진 위치와 해상도에 대한 H3 셀 ID에 해당하는 INTEGER 값을 반환합니다.

사용 참고 (Usage notes)

  • 입력 인자 중 하나라도 NaN 또는 Inf 값을 지정하면 오류가 발생합니다.

예제 (Examples)

다음 예제는 해상도 8에서 브란덴부르크 문(Brandenburg Gate)의 H3 셀 ID를 반환합니다.

SELECT H3_LATLNG_TO_CELL(52.516262, 13.377704, 8);

+--------------------------------------------+
| H3_LATLNG_TO_CELL(52.516262, 13.377704, 8) |
|--------------------------------------------|
|                         613036919424548863 |
+--------------------------------------------+

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

SELECT H3_LATLNG_TO_CELL(52.516262, 373.377704, 8);

+---------------------------------------------+
| H3_LATLNG_TO_CELL(52.516262, 373.377704, 8) |
|---------------------------------------------|
|                          613036919424548863 |
+---------------------------------------------+

다음 예제는 0에서 15 밖의 해상도를 지정할 수 없음을 보여줍니다.

SELECT H3_LATLNG_TO_CELL(52.516262, 373.377704, 18);

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

더 알아보기 (Learn more)