类别：

地理空间函数

H3_TRY_GRID_PATH

H3_GRID_PATH 的一个特殊版本，如果在尝试返回一个 VARIANT 值数组（包含代表两个单元格之间的行的 H3 单元格 IDs）时出错，则返回 NULL。

语法

H3_TRY_GRID_PATH( <cell_id_1> , <cell_id_2> )
Copy

实参

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 值。

返回

返回 ARRAY 数据类型的值或 NULL。

  • 如果函数执行了成功的计算，则返回包含 H3 单元格 IDs 的 VARIANT 值数组，这些单元格表示 cell_id_1 和 cell_id_2 指定的单元格之间的行。有关 IDs 格式的信息，请参阅 H3_GRID_PATH。

  • 如果无法计算行（例如，当两个单元格属于非相邻 基础单元格 (https://h3geo.org/docs/library/index/cell/) 时），返回 NULL 而不报告错误。

使用说明

有关使用说明，请参阅 H3_GRID_PATH。

示例

以下示例会尝试返回两个单元格之间的行。由于这些单元格属于非相邻的基单元格，因此函数无法返回行，并且返回 NULL。

SELECT H3_TRY_GRID_PATH('813d7ffffffffff', '81343ffffffffff');
Copy
+--------------------------------------------------------+
| H3_TRY_GRID_PATH('813D7FFFFFFFFFF', '81343FFFFFFFFFF') |
|--------------------------------------------------------|
| NULL                                                   |
+--------------------------------------------------------+

对于成功计算两个 H3 单元格之间路径的示例，请参阅 H3_GRID_PATH。

语言: 中文