카테고리:

지리 공간 함수

H3_POINT_TO_CELL

주어진 해상도에서 (GEOGRAPHY 오브젝트로 지정된) 점에 대한 H3 셀 ID의 INTEGER 값을 반환합니다.

참고 항목:

H3_POINT_TO_CELL_STRING , H3_CELL_TO_POINT

구문

H3_POINT_TO_CELL( <geography_point> , <target_resolution> )
Copy

인자

geography_point

점을 나타내는 GEOGRAPHY 오브젝트입니다.

target_resolution

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

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

반환

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

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

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

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

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