geo_h3cell_parent()

适用于:✅Azure 数据资源管理器Azure MonitorMicrosoft Sentinel

计算 H3 父单元格。

详细了解 H3 单元格

语法

geo_h3cell_parent(h3cell,resolution)

详细了解语法约定

参数

客户 类型​​ 必需 说明
h3cell string ✔️ geo_point_to_h3cell() 算出的 H3 单元格令牌值。
resolution int 定义所请求的子单元格分辨率。 支持的值范围为 [0, 14]。 如果未指定,将计算一个直系子令牌。

返回

H3 父单元格标记 string。 如果 H3 单元格无效或父级分辨率高于给定单元格,则查询将生成空结果。

示例

print parent_cell = geo_h3cell_parent('862a1072fffffff')

输出

parent_cell
852a1073fffffff

以下示例计算处于级别 1 的父单元格。

print parent_cell = geo_h3cell_parent('862a1072fffffff', 1)

输出

parent_cell
812a3ffffffffff
print parent_res = geo_h3cell_level(geo_h3cell_parent((geo_point_to_h3cell(1,1,10))))

输出

parent_res
9
print parent_res = geo_h3cell_level(geo_h3cell_parent(geo_point_to_h3cell(1,1,10), 3))

输出

parent_res
3

由于单元格输入无效,以下示例生成空结果。

print invalid = isempty(geo_h3cell_parent('123'))

输出

无效
1

由于父级分辨率无效,以下示例生成空结果。

print invalid = isempty(geo_h3cell_parent('862a1072fffffff', 100))

输出

无效
1

下面的示例生成一个空结果,因为父级的分辨率不能高于子级。

print invalid = isempty(geo_h3cell_parent('862a1072fffffff', 15))

输出

无效
1