Catégories :

Fonctions géospatiales

H3_TRY_GRID_PATH

Version spéciale de H3_GRID_PATH qui renvoie NULL en cas d’erreur lorsqu’elle tente de renvoyer un tableau de valeurs VARIANT contenant les IDs des cellules H3 qui représentent la ligne entre deux cellules.

Syntaxe

H3_TRY_GRID_PATH( <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 du type de données ARRAY ou NULL.

  • Si la fonction effectue un calcul correct, renvoie un tableau de valeurs VARIANT contenant les IDs de cellules H3 qui représentent la ligne entre les cellules spécifiées par cell_id_1 et par cell_id_2. Pour des informations sur le format des IDs, voir H3_GRID_PATH.

  • Si la ligne 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_PATH.

Exemples

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

SELECT H3_TRY_GRID_PATH('813d7ffffffffff', '81343ffffffffff');
Copy
+--------------------------------------------------------+
| H3_TRY_GRID_PATH('813D7FFFFFFFFFF', '81343FFFFFFFFFF') |
|--------------------------------------------------------|
| NULL                                                   |
+--------------------------------------------------------+

Pour des exemples qui renvoient correctement le chemin entre deux cellules H3, voir H3_GRID_PATH.

Langage: Français