类别：: 地理空间函数

H3_GRID_PATH¶

返回表示两个单元格之间线条的 H3 单元格 IDs 的数组。返回的 ARRAY 中的 IDs 是 INTEGER 值（如果 INTEGER 值作为输入 IDs 提供）或者包含十六进制 IDs 的 VARCHAR 值（如果十六进制 IDs 作为输入 IDs 提供）。

语法¶

H3_GRID_PATH( <cell_id_1> , <cell_id_2> )

实参¶

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

返回¶

返回 H3 单元格 IDs 的 ARRAY，表示 cell_id_1 和 cell_id_2 指定的单元格之间的线。IDs 采用以下格式之一：

如果 cell_id_1 和 cell_id_2 是 INTEGER 值，则函数以 INTEGER 值返回 IDs。
如果 cell_id_1 和 cell_id_2 是包含十六进制 IDs 的 VARCHAR 值，则函数以 VARCHAR 值返回十六进制 IDs。

使用说明¶

两个输入单元格 IDs 必须使用相同的分辨率。

示例¶

以下示例返回 H3 单元格 IDs 的 ARRAY，表示采用 IDs 617540519103561727 和 617540519052967935 （均以 INTEGER 值指定）的单元格之间的线。

SELECT H3_GRID_PATH(617540519103561727, 617540519052967935);

+------------------------------------------------------+
| H3_GRID_PATH(617540519103561727, 617540519052967935) |
|------------------------------------------------------|
| [                                                    |
|   617540519103561727,                                |
|   617540519046414335,                                |
|   617540519047462911,                                |
|   617540519044055039,                                |
|   617540519045103615,                                |
|   617540519052967935                                 |
| ]                                                    |
+------------------------------------------------------+

以下示例返回 H3 单元格 IDs 的 ARRAY，表示采用 IDs 891f1d48b93ffff 和 891f1d4888fffff （均以 VARCHAR 值指定）的单元格之间的线。

SELECT H3_GRID_PATH('891f1d48b93ffff', '891f1d4888fffff');

+----------------------------------------------------+
| H3_GRID_PATH('891F1D48B93FFFF', '891F1D4888FFFFF') |
|----------------------------------------------------|
| [                                                  |
|   "891f1d48b93ffff",                               |
|   "891f1d4882bffff",                               |
|   "891f1d4883bffff",                               |
|   "891f1d48807ffff",                               |
|   "891f1d48817ffff",                               |
|   "891f1d4888fffff"                                |
| ]                                                  |
+----------------------------------------------------+