共用方式為


geo_h3cell_children()

適用於:✅Microsoft網狀架構Azure 數據✅總管 Azure 監視器✅Microsoft Sentinel

計算 H3 儲存格子系。

深入瞭解 H3 單元格

語法

geo_h3cell_children(h3cell,解析度)

深入瞭解 語法慣例

參數

姓名 類型​​ 必要 描述
h3cell string ✔️ H3 儲存格標記值,因為它是由 geo_point_to_h3cell() 計算。
解析度 int 定義要求的子數據格解析。 支援的值範圍 [1, 15]。 如果未指定,則會計算立即子令牌。

傳回

H3 儲存格子標記的陣列。 如果 H3 儲存格無效或子解析低於指定的儲存格,則查詢會產生 Null 結果。

注意

單元格解析度與其子系之間的差異不能超過 5。 5 個層級的差異將產生最多16807個子令牌。

範例

print children = geo_h3cell_children('862a1072fffffff')

輸出

children
[ “872a10728ffffff”, “872a10729ffffff”、“872a1072affffff”、“872a1072bff”、“872a1072cff”、“872a1072dff”、“872a1072effffff” ]

下列範例會計算指定儲存格下方 3 個層級的子系。

let h3_cell = '862a1072fffffff'; 
print children_count = array_length(geo_h3cell_children(h3_cell, geo_h3cell_level(h3_cell) + 3))

輸出

children_count
343

下列範例會組合 H3 Cell 子多邊形的 GeoJSON 幾何集合。

print children = geo_h3cell_children('862a1072fffffff')
| mv-expand children to typeof(string)
| project child = geo_h3cell_to_polygon(children)
| summarize h3_hash_polygon_lst = make_list(child)
| project geojson = bag_pack(
    "type", "Feature",
    "geometry", bag_pack("type", "GeometryCollection", "geometries", h3_hash_polygon_lst),
    "properties", bag_pack("name", "H3 polygons collection"))

輸出

geojson
{ “type”: “Feature”, “geometry”: { “type”: “GeometryCollection”, “geometries”: [ ... ... ] }, “properties”: { “name”: “H3 polygons collection” }}

下列範例會傳回 true,因為單元格無效。

print is_null = isnull(geo_h3cell_children('abc'))

輸出

is_null
1

下列範例會傳回 true,因為單元格與其子系之間的層級差異超過 5。

print is_null = isnull(geo_h3cell_children(geo_point_to_h3cell(1, 1, 9), 15))

輸出

is_null
1