geo_h3cell_children()

Calcola i figli della cella H3.

Altre informazioni sulla cella H3.

Sintassi

geo_h3cell_children(h3cell,Risoluzione)

Altre informazioni sulle convenzioni di sintassi.

Parametri

Nome	Tipo	Obbligatoria	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 si trovano nell'intervallo [1, 15]. Se non specificato, verrà calcolato un token figlio immediato.

Restituisce

Matrice di token figlio di celle H3. Se la cella H3 non è valida o la risoluzione figlio è inferiore a quella 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 risulterà fino a 16807 token figlio.

Esempio

Eseguire la query

print children = geo_h3cell_children('862a1072fffffff')

Output

figli
[ "872a10728ff", "872a10729ff", "872a1072affff", "872a1072bff", "872a1072cff", "872a1072dff", "872a1072effff" ]

Nell'esempio seguente vengono conteggiato 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 l'insieme 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" }}

L'esempio seguente restituisce 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 la cella e i relativi elementi figlio è 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