カテゴリ：: 地理空間関数

H3_CELL_TO_PARENT¶

特定の解像度の H3 セルの親の ID を返します。ID は INTEGER 値として（入力 ID として INTEGER 値が提供された場合）、または16進数 ID を含む VARCHAR として（入力 ID として16進数 ID が提供された場合）返されます。

こちらもご参照ください。: H3_CELL_TO_CHILDREN , H3_CELL_TO_CHILDREN_STRING

構文¶

H3_CELL_TO_PARENT( <cell_id> , <target_resolution> )

Copy

引数¶

cell_id

H3セル ID （インデックス）を表す INTEGER、またはセル ID を16進数形式で表す VARCHAR。

target_resolution

0と15（0と15を含む）の間の INTEGER は、返されるH3セルに使用するH3 解像度を指定します。

それ以外の INTEGER 値を指定するとエラーになります。

戻り値¶

指定されたターゲット解像度で、H3の親セルの ID を返します。この ID は次のいずれかの形式です。

cell_id が INTEGER の場合、この関数は ID を INTEGER 値として返します。
cell_id が16進数 ID を含む VARCHAR 値である場合、この関数は16進数 ID を VARCHAR 値として返します。

例¶

次の例は、H3セル ID を ID 613036919424548863 （ INTEGER 値として指定）を持つH3セルの親として返します。

SELECT H3_CELL_TO_PARENT(613036919424548863, 7);

Copy

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

次の例は、H3セル ID を ID 881F1D4887FFFFF （ VARCHAR 値として指定）を持つH3セルの親として返します。

SELECT H3_CELL_TO_PARENT('881F1D4887FFFFF', 7);

Copy

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