类别：: 地理空间函数

H3_TRY_GRID_DISTANCE¶

H3_GRID_DISTANCE 的一个特殊版本，如果在尝试返回两个 H3 单元格之间的距离时出错，则返回 NULL。

语法¶

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

返回¶

返回一个 INTEGER 值或 NULL。

如果函数可以执行一次成功的计算，则返回 INTEGER 值，该值表示两个 H3 单元格之间的网格单元格距离。
如果无法计算格网距离（例如，当两个单元格属于非相邻基础单元格 (https://h3geo.org/docs/library/index/cell/) 时），返回 NULL 而不报告错误。

使用说明¶

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

示例¶

以下示例尝试计算两个单元格之间的距离。由于单元格属于非相邻的基本单元格，因此该函数无法计算距离并返回 NULL。

SELECT H3_TRY_GRID_DISTANCE(582046271372525567, 581883543651614719);

Copy

+--------------------------------------------------------------+
| H3_TRY_GRID_DISTANCE(582046271372525567, 581883543651614719) |
|--------------------------------------------------------------|
|                                                         NULL |
+--------------------------------------------------------------+

对于成功计算两个 H3 单元格之间距离的示例，请参阅 H3_GRID_DISTANCE。