Partager via

geo_h3cell_parent()

  • Article

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

Calcule le parent de cellule H3.

En savoir plus sur la cellule H3.

Syntaxe

geo_h3cell_parent(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 [0, 14]. S’il n’est pas spécifié, un jeton enfant immédiat est calculé.

Retours

Jeton stringparent de cellule H3 . Si la cellule H3 n’est pas valide ou si la résolution parente est supérieure à la cellule donnée, la requête produit un résultat vide.

Exemples

print parent_cell = geo_h3cell_parent('862a1072fffffff')

Sortie

parent_cell
852a1073fffffff

L’exemple suivant calcule le parent de cellule au niveau 1.

print parent_cell = geo_h3cell_parent('862a1072fffffff', 1)

Sortie

parent_cell
812a3ffff 
print parent_res = geo_h3cell_level(geo_h3cell_parent((geo_point_to_h3cell(1,1,10))))

Sortie

parent_res
9 
print parent_res = geo_h3cell_level(geo_h3cell_parent(geo_point_to_h3cell(1,1,10), 3))

Sortie

parent_res
3

L’exemple suivant génère un résultat vide en raison de l’entrée de cellule non valide.

print invalid = isempty(geo_h3cell_parent('123'))

Sortie

non valide
1

L’exemple suivant génère un résultat vide en raison de la résolution parente non valide.

print invalid = isempty(geo_h3cell_parent('862a1072fffffff', 100))

Sortie

non valide
1

L’exemple suivant génère un résultat vide, car le parent ne peut pas être d’une résolution supérieure à celle de l’enfant.

print invalid = isempty(geo_h3cell_parent('862a1072fffffff', 15))

Sortie

non valide
1