geo_h3cell_children()

S’applique à : ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Calcule les enfants de cellules H3.

En savoir plus sur la cellule H3.

Syntaxe

geo_h3cell_children(résolution h3cell,)

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom	Type	Requise	Description
h3cell	string	✔️	Valeur de jeton de cellule H3 telle qu’elle a été calculée par geo_point_to_h3cell().
résolution	int		Définit la résolution des cellules enfants demandées. Les valeurs prises en charge se trouvent dans la plage [1, 15]. S’il n’est pas spécifié, un jeton enfant immédiat est calculé.

Retours

Tableau de jetons enfants de cellule H3. Si la cellule H3 n’est pas valide ou si la résolution enfant est inférieure à la cellule donnée, la requête produit un résultat null.

Remarque

Une différence entre la résolution cellulaire et ses enfants ne peut pas être supérieure à 5. Une différence de 5 niveaux se traduit par un maximum de 16807 jetons enfants.

Exemples

Exécuter la requête

print children = geo_h3cell_children('862a1072fffffff')

Sortie

enfants
[ « 872a10728ffffff », « 872a10729ff », « 872a1072affffff », « 872a1072bff », « 872a1072cffffff », « 872a1072dff », « 872a1072effffff » ]

L’exemple suivant compte les enfants 3 niveaux inférieurs à une cellule donnée.

Exécuter la requête

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

Sortie

children_count
343

L’exemple suivant assemble la collection géométrique GeoJSON des polygones enfants de cellule H3.

Exécuter la requête

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

Sortie

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

L’exemple suivant retourne true en raison de la cellule non valide.

Exécuter la requête

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

Sortie

is_null
1

L’exemple suivant retourne true, car la différence de niveau entre la cellule et ses enfants est supérieure à 5.

Exécuter la requête

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

Sortie

is_null
1