카테고리:

지리공간 함수

H3_CELL_TO_PARENT

주어진 해상도에 대해 H3 셀의 상위 항목 ID를 반환합니다. ID는 INTEGER 값(INTEGER 값이 입력 ID로 제공된 경우) 또는 16진수 ID를 포함하는 VARCHAR(16진수 ID가 입력 ID로 제공된 경우)로 반환됩니다.

참고 항목:

H3_CELL_TO_CHILDREN , H3_CELL_TO_CHILDREN_STRING

구문

H3_CELL_TO_PARENT( <cell_id> , <target_resolution> )

인자

cell_id

H3 셀 ID(인덱스)를 나타내는 INTEGER 또는 16진수 형식으로 셀 ID을 나타내는 VARCHAR입니다.

target_resolution

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

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

반환

지정된 대상 해상도에서 H3 상위 셀의 ID를 반환합니다. ID는 다음 형식 중 하나로 되어 있습니다.

  • cell_id 가 INTEGER 값인 경우 이 함수는 ID를 INTEGER 값으로 반환합니다.

  • cell_id 가 16진수 ID를 포함한 VARCHAR 값인 경우 이 함수는 16진수 ID를 VARCHAR 값으로 반환합니다.

예

다음 예에서는 (INTEGER 값으로 지정된) ID 613036919424548863 을 사용하여 H3 셀의 상위 항목에 대한 H3 셀 ID를 반환합니다.

SELECT H3_CELL_TO_PARENT(613036919424548863, 7);

+------------------------------------------+
| H3_CELL_TO_PARENT(613036919424548863, 7) |
|------------------------------------------|
|                       608533319805566975 |
+------------------------------------------+

다음 예에서는 (VARCHAR 값으로 지정된) ID 881F1D4887FFFFF 을 사용하여 H3 셀의 상위 항목에 대한 H3 셀 ID를 반환합니다.

SELECT H3_CELL_TO_PARENT('881F1D4887FFFFF', 7);

+-----------------------------------------+
| H3_CELL_TO_PARENT('881F1D4887FFFFF', 7) |
|-----------------------------------------|
|  871F1D488FFFFFF                        |
+-----------------------------------------+