类别:

地理空间函数

H3_CELL_TO_PARENT

返回给定分辨率的 H3 单元格的父单元 ID。ID 以 INTEGER 值(如果提供了 INTEGER 值作为输入 ID)或包含十六进制 ID 的 VARCHAR(如果提供了十六进制 ID 作为输入 ID)的形式返回。

另请参阅:

H3_CELL_TO_CHILDRENH3_CELL_TO_CHILDREN_STRING

语法

H3_CELL_TO_PARENT( <cell_id> , <target_resolution> )
Copy

实参

cell_id

表示 H3 单元格 ID (索引 (https://h3geo.org/docs/core-library/h3Indexing))的 INTEGER,或表示十六进制格式的单元格 ID 的 VARCHAR。

target_resolution

介于 0 和 15(含)之间的 INTEGER,指定要用于返回的 H3 单元格的 H3 分辨率 (https://h3geo.org/docs/core-library/restable)。

指定其他任何 INTEGER 值都会导致错误。

返回

以指定的目标分辨率返回 H3 父单元格的 ID。ID 采用以下格式之一:

  • 如果 cell_id 是一个 INTEGER 值,则该函数将 ID 作为 INTEGER 值返回。

  • 如果 cell_id 是包含十六进制 ID 的 VARCHAR 值,则函数返回十六进制 ID 作为 VARCHAR 值。

示例

以下示例返回 H3 单元格的父级 H3 单元格 ID,ID 为 613036919424548863 (指定为 INTEGER 值):

SELECT H3_CELL_TO_PARENT(613036919424548863, 7);
Copy
+------------------------------------------+
| H3_CELL_TO_PARENT(613036919424548863, 7) |
|------------------------------------------|
|                       608533319805566975 |
+------------------------------------------+

以下示例返回 H3 单元格的父级 H3 单元格 ID,ID 为 881F1D4887FFFFF (指定为 VARCHAR 值):

SELECT H3_CELL_TO_PARENT('881F1D4887FFFFF', 7);
Copy
+-----------------------------------------+
| H3_CELL_TO_PARENT('881F1D4887FFFFF', 7) |
|-----------------------------------------|
|  871F1D488FFFFFF                        |
+-----------------------------------------+
语言: 中文