类别：: 地理空间函数

H3_GRID_DISK¶

返回距指定单元格 k 距离内的 H3 单元格 IDs 的数组。返回的 ARRAY 中的 IDs 是 INTEGER 值（如果提供了 INTEGER 值作为输入 ID）或包含十六进制 IDs（如果提供了十六进制 ID 作为输入 ID）的 VARCHAR 值。

语法¶

H3_GRID_DISK( <cell_id> , <k_value> )

实参¶

cell_id: 表示 H3 单元格 ID（索引 (https://h3geo.org/docs/core-library/h3Indexing)）的 INTEGER，或表示十六进制格式的单元格 ID 的 VARCHAR。
k_value: 表示网格距离的 INTEGER。必须指定非负值。

返回¶

返回与 cell_id 指定的单元格距离 k_value 以内的 H3 单元格 IDs 的 ARRAY。IDs 采用以下格式之一：

如果 cell_id 是一个 INTEGER 值，则该函数将 IDs 作为 INTEGER 值返回。
如果 cell_id 是包含十六进制 ID 的 VARCHAR 值，则函数返回十六进制 IDs 作为 VARCHAR 值。

示例¶

以下示例返回了从 ID 为 617540519050084351 的单元格到网格距离为 1 的 H3 单元格 IDs 的 ARRAY （指定为 INTEGER 值）。

SELECT H3_GRID_DISK(617540519050084351, 1);

+-------------------------------------+
| H3_GRID_DISK(617540519050084351, 1) |
|-------------------------------------|
| [                                   |
|   617540519050084351,               |
|   617540519051657215,               |
|   617540519050608639,               |
|   617540519050870783,               |
|   617540519050346495,               |
|   617540519051395071,               |
|   617540519051132927                |
| ]                                   |
+-------------------------------------+

以下示例返回了从 ID 为 891f1d48863ffff 的单元格到网格距离为 1 的 H3 单元格 IDs 的 ARRAY（指定为 VARCHAR 值）。

SELECT H3_GRID_DISK('891f1d48863ffff', 1);

+------------------------------------+
| H3_GRID_DISK('891F1D48863FFFF', 1) |
|------------------------------------|
| [                                  |
|   "891f1d48863ffff",               |
|   "891f1d4887bffff",               |
|   "891f1d4886bffff",               |
|   "891f1d4886fffff",               |
|   "891f1d48867ffff",               |
|   "891f1d48877ffff",               |
|   "891f1d48873ffff"                |
| ]                                  |
+------------------------------------+