geo_h3cell_children()

Calcula los elementos secundarios de celda H3.

Obtenga más información sobre la celda H3.

Syntax

geo_h3cell_children(h3cell,Resolución)

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre	Tipo	Requerido	Descripción
h3cell	string	✔️	Un valor de token de celda H3 tal y como lo calculó geo_point_to_h3cell().
Resolución	int		Define la resolución de celdas secundarias solicitadas. Los valores admitidos están en el intervalo [1, 15]. Si no se especifica, se calculará un token secundario inmediato.

Devoluciones

Matriz de tokens secundarios de celda H3. Si la celda H3 no es válida o la resolución secundaria es inferior a la de la celda dada, la consulta generará un resultado nulo.

Nota

Una diferencia entre la resolución de celdas y sus elementos secundarios no puede ser superior a 5. Una diferencia de 5 niveles se producirá hasta 16807 tokens secundarios.

Ejemplos

Ejecución de la consulta

print children = geo_h3cell_children('862a1072fffffff')

Salida

secundarios
[ "872a10728ffffff", "872a10729ffffff", "872a1072affff", "872a1072bffffff", "872a1072cffffff", "872a1072dffffff", "872a1072effffff" ]

En el ejemplo siguiente se cuentan los tres niveles secundarios por debajo de una celda determinada.

Ejecución de la consulta

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

Salida

children_count
343

En el ejemplo siguiente se ensambla la colección de geometría GeoJSON de polígonos secundarios H3 Cell.

Ejecución de la consulta

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"))

Salida

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

En el ejemplo siguiente se devuelve true debido a la celda no válida.

Ejecución de la consulta

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

Salida

is_null
1

En el ejemplo siguiente se devuelve true porque la diferencia de nivel entre la celda y sus elementos secundarios es superior a 5.

Ejecución de la consulta

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

Salida

is_null
1