Partager via

geo_point_to_h3cell()

  • Article

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

Calcule la valeur de chaîne de jeton de cellule H3 d’un emplacement géographique.

En savoir plus sur la cellule H3.

Syntaxe

geo_point_to_h3cell(latitude, longitude, [ résolution ])

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom Type Requise Description
longitude real ✔️ Coordonnée géospatiale, valeur de longitude en degrés. La valeur valide est un nombre réel et dans la plage [-180, +180].
latitude real ✔️ Coordonnée géospatiale, valeur de latitude en degrés. La valeur valide est un nombre réel et dans la plage [-90, +90].
résolution int Définit la résolution de cellule demandée. Les valeurs prises en charge se trouvent dans la plage [0, 15]. Si la valeur n’est pas spécifiée, la valeur par défaut 6 est utilisée.

Retours

Valeur de chaîne de jeton de cellule H3 d’un emplacement géographique donné. Si les coordonnées ou les niveaux ne sont pas valides, la requête produit un résultat vide.

Remarque

  • H3 Cell peut être un outil de clustering géospatial utile.
  • H3 Cell a 16 niveaux de hiérarchie avec couverture de zone comprise entre 4 250 547km² au plus haut niveau 0 à 0,9m² au niveau le plus bas 15.
  • H3 Cell a une forme hexagonale unique et cela conduit à certaines propriétés uniques :
  • Les hexagones ont 6 voisins
  • Les hexagones nous permettent de rayons approximatifs facilement et tous les voisins sont équidistants
  • Les hexagones sont visuellement agréables
  • Dans certains cas rares, la forme est pentagonee.
  • H3 Cell a une zone rectangulaire sur une surface de plan.
  • L’appel de la fonction geo_h3cell_to_central_point() sur une chaîne de jeton de cellule H3 qui a été calculée sur longitude x et latitude y ne retourne pas nécessairement x et y.
  • Il est possible que deux emplacements géographiques soient très proches les uns des autres, mais ont des jetons de cellule H3 différents.

Couverture approximative de la zone de cellule H3 par valeur de résolution

Niveau Longueur moyenne de l’arête hexagonale
0 1108 km
1 419 km
2 158 km
3 60 km
4 23 km
5 8 km
6 3 km
7 1 km
8 460 m
9 174 m
10 66 m
11 25 m
12 9 m
13 3 m
14 1 m
15 0,5 m

La source de la table se trouve dans cette ressource statistique de cellule H3.

Voir également geo_point_to_s2cell(), geo_point_to_geohash().

Pour la comparaison avec d’autres systèmes de grille disponibles. consultez le clustering géospatial avec Langage de requête Kusto.

Exemples

print h3cell = geo_point_to_h3cell(-74.04450446039874, 40.689250859314974, 6)

Sortie

h3cell
862a1072fffffff

L’exemple suivant recherche des groupes de coordonnées. Chaque paire de coordonnées du groupe réside dans la cellule H3 avec une zone hexagonale moyenne de 253 km².

datatable(location_id:string, longitude:real, latitude:real)
[
    "A", -73.956683, 40.807907,
    "B", -73.916869, 40.818314,
    "C", -73.989148, 40.743273,
]
| summarize count = count(),                                         // Items per group count
            locations = make_list(location_id)                       // Items in the group
            by h3cell = geo_point_to_h3cell(longitude, latitude, 5)  // H3 Cell of the group

Sortie

h3cell count locations
852a100bfffffff 2 [
« A »,
« B »
]
852a1073fffffff 1 [
« C »
]

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

print h3cell = geo_point_to_h3cell(300,1,8)

Sortie

h3cell

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

print h3cell = geo_point_to_h3cell(1,1,16)

Sortie

h3cell

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

print h3cell = geo_point_to_h3cell(1,1,int(null))

Sortie

h3cell