geo_h3cell_children()

Si applica a: ✅Microsoft Fabric✅Azure Esplora dati✅ Azure Monitor✅Microsoft Sentinel

Calcola gli elementi figlio della cella H3.

Altre informazioni sulla cella H3.

Sintassi

geo_h3cell_children(risoluzione h3cell,)

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome	Digita	Obbligatorio	Descrizione
h3cell	string	✔️	Valore del token di cella H3 calcolato da geo_point_to_h3cell().
risoluzione	int		Definisce la risoluzione delle celle figlio richieste. I valori supportati sono compresi nell'intervallo [1, 15]. Se non specificato, verrà calcolato un token figlio immediato.

Valori restituiti

Matrice di token figlio della cella H3. Se la cella H3 non è valida o la risoluzione figlio è inferiore alla cella specificata, la query genererà un risultato Null.

Nota

Una differenza tra la risoluzione delle celle e i relativi figli non può essere maggiore di 5. Una differenza di 5 livelli comporterà fino a 16807 token figlio.

Esempi

Eseguire la query

print children = geo_h3cell_children('862a1072fffffff')

Output

bambini
[ "872a10728ff", "872a10729ffffff", "872a1072affff", "872a1072bffffff", "872a1072cffffff", "872a1072dffffff", "872a1072eff" ]

Nell'esempio seguente vengono conteggiato i figli 3 livelli inferiori a una determinata cella.

Eseguire la query

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

Output

children_count
343

Nell'esempio seguente viene assemblata la raccolta geometry GeoJSON dei poligoni figlio H3 Cell.

Eseguire la query

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

Output

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

Nell'esempio seguente viene restituito true a causa della cella non valida.

Eseguire la query

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

Output

is_null
1

L'esempio seguente restituisce true perché la differenza di livello tra cella e figli è maggiore di 5.

Eseguire la query

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

Output

is_null
1