카테고리:

지리 공간 함수

H3_LATLNG_TO_CELL

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

참고 항목:

H3_LATLNG_TO_CELL_STRING

구문

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

인자

latitude

위도를 나타내는 FLOAT입니다.

표준 위도 범위를 벗어나는 값은 [-90, 90]의 범위로 래핑됩니다.

longitude

경도를 나타내는 FLOAT입니다.

표준 경도 범위를 벗어나는 값은 [-180, 180]의 범위로 래핑됩니다.

target_resolution

반환된 H3 셀에 사용하려는 H3 해상도 를 지정하는 0과 15(포함) 사이의 INTEGER입니다.

다른 INTEGER 값을 지정하면 오류가 발생합니다.

반환

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

사용법 노트

  • 입력 인자에 대해 NaN 또는 Inf 값을 지정하면 오류가 발생합니다.

예

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

SELECT H3_LATLNG_TO_CELL(52.516262, 13.377704, 8);
Copy
+--------------------------------------------+
| H3_LATLNG_TO_CELL(52.516262, 13.377704, 8) |
|--------------------------------------------|
|                         613036919424548863 |
+--------------------------------------------+

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

SELECT H3_LATLNG_TO_CELL(52.516262, 373.377704, 8);
Copy
+---------------------------------------------+
| H3_LATLNG_TO_CELL(52.516262, 373.377704, 8) |
|---------------------------------------------|
|                          613036919424548863 |
+---------------------------------------------+

다음 예에서는 0에서 15까지의 범위를 벗어나는 해상도를 지정할 수 없음을 보여줍니다.

SELECT H3_LATLNG_TO_CELL(52.516262, 373.377704, 18);
Copy
100410 (P0000): Invalid H3 resolution value: 18. Resolution must be between 0 (coarsest) and 15 (finest).
언어: 한국어