H3_POINT_TO_CELL_STRING

H3_POINT_TO_CELL_STRING

H3_POINT_TO_CELL_STRING 함수는 점(Point, GEOGRAPHY 객체로 지정)에 대해 주어진 해상도에서 H3 셀 ID의 16진수 값을 반환해요.

출처: H3_POINT_TO_CELL_STRING

본문

H3_POINT_TO_CELL_STRING 함수는 점에 대해 주어진 해상도에서 H3 셀 ID의 16진수 값을 반환해요.

함께 보기: H3_POINT_TO_CELL, H3_CELL_TO_POINT

구문 (Syntax)

H3_POINT_TO_CELL_STRING( <geography_point> , <target_resolution> )

인자 (Arguments)

  • geography_point — 점(Point)을 나타내는 GEOGRAPHY 객체예요.
  • target_resolution — 반환되는 H3 셀에 사용할 H3 해상도를 지정하는 0~15(포함) 사이의 INTEGER예요. 다른 정수 값을 지정하면 오류가 발생해요.

반환 (Returns)

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

예제 (Examples)

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

SELECT H3_POINT_TO_CELL_STRING(ST_POINT(13.377704, 52.516262), 8);

+------------------------------------------------------------+
| H3_POINT_TO_CELL_STRING(ST_POINT(13.377704, 52.516262), 8) |
|------------------------------------------------------------|
|  881F1D4887FFFFF                                           |
+------------------------------------------------------------+

다음 예제는 0~15 범위 밖의 해상도를 지정할 수 없음을 보여줘요:

SELECT H3_POINT_TO_CELL_STRING(ST_POINT(13.377704, 52.516262), 18);

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

더 알아보기 (Learn more)

  • H3_POINT_TO_CELL
  • H3_CELL_TO_POINT
  • 지리공간 함수 (Geospatial functions)
  • H3 함수 (H3 functions)