geo_h3cell_children()

적용 대상: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

H3 셀 자식을 계산합니다.

H3 셀에 대해 자세히 알아보세요.

구문

geo_h3cell_children(h3cell,해상도)

구문 규칙에 대해 자세히 알아봅니다.

매개 변수

이름	Type	필수	설명
h3cell	string	✔️	geo_point_to_h3cell()에서 계산한 H3 셀 토큰 값입니다.
해상도	int		요청된 자식 셀 확인을 정의합니다. 지원되는 값은 [1, 15] 범위에 있습니다. 지정되지 않은 경우 직결 자식 토큰이 계산됩니다.

반품

H3 셀 자식 토큰의 배열입니다. H3 셀이 잘못되었거나 자식 해상도가 지정된 셀보다 낮으면 쿼리에서 null 결과를 생성합니다.

참고 항목

셀 해상도와 자식 간의 차이는 5를 초과할 수 없습니다. 5개 수준의 차이로 인해 최대 16807개의 자식 토큰이 생성됩니다.

예제

쿼리 실행

print children = geo_h3cell_children('862a1072fffffff')

출력

children
[ "872a10728ffffffff", "872a10729ffffff", "872a1072affffff", "872a1072bffffff", "872a1072cffffff", "872a1072dffffff", "872a1072effffffff" ]

다음 예제에서는 지정된 셀 아래의 자식 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 셀 자식 다각형의 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

다음 예제에서는 셀과 해당 자식 간의 수준 차이가 5보다 높기 때문에 true를 반환합니다.

쿼리 실행

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

출력

is_null
1