Catégories :

Fonctions géospatiales

H3_TRY_GRID_DISTANCE

Version spéciale de H3_GRID_DISTANCE qui renvoie NULL en cas d’erreur lorsqu’elle tente de renvoyer la distance entre deux cellules H3.

Syntaxe

H3_TRY_GRID_DISTANCE( <cell_id_1> , <cell_id_2> )
Copy

Arguments

cell_id_1

Valeur INTEGER qui représente l’ID de cellule H3 (index), ou valeur VARCHAR qui représente l’ID de cellule au format hexadécimal.

cell_id_2

Valeur INTEGER qui représente l’ID de cellule H3 (index), ou valeur VARCHAR qui représente l’ID de cellule au format hexadécimal.

Renvoie

Renvoie une valeur INTEGER ou NULL.

  • Si la fonction peut effectuer un calcul correct, renvoie la valeur INTEGER représentant la distance en cellules de grille entre les deux cellules H3.

  • Si la distance de la grille ne peut pas être calculée (par exemple, lorsque deux cellules appartiennent à des cellules de base non voisines), renvoie NULL sans signaler d’erreur.

Notes sur l’utilisation

Pour les Notes sur l’utilisation, voir H3_GRID_DISTANCE.

Exemples

L’exemple suivant tente de calculer la distance entre deux cellules. Comme les cellules appartiennent à des cellules de base non voisines, la fonction ne parvient pas à calculer la distance et renvoie NULL.

SELECT H3_TRY_GRID_DISTANCE(582046271372525567, 581883543651614719);
Copy
+--------------------------------------------------------------+
| H3_TRY_GRID_DISTANCE(582046271372525567, 581883543651614719) |
|--------------------------------------------------------------|
|                                                         NULL |
+--------------------------------------------------------------+

Pour des exemples qui renvoient correctement la distance entre deux cellules H3, voir H3_GRID_DISTANCE.

Langage: Français