카테고리:

지리 공간 함수

H3_LATLNG_TO_CELL_STRING

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

참고 항목:

H3_LATLNG_TO_CELL

구문

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

인자

latitude

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

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

longitude

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

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

target_resolution

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

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

반환

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

사용법 노트

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

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

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

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

SELECT H3_LATLNG_TO_CELL_STRING(52.516262, 373.377704, 8);
Copy
+---------------------------------------------------+
| H3_LATLNG_TO_CELL_STRING(52.516262, 13.377704, 8) |
|---------------------------------------------------|
|  881F1D4887FFFFF                                  |
+---------------------------------------------------+

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

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