Catégories :

Fonctions géospatiales

H3_GRID_DISK

Renvoie un ARRAY des IDs des cellules H3 qui se trouvent à la distance k de la cellule spécifiée. Les IDs dans l’ARRAY renvoyé sont des valeurs INTEGER (si une valeur INTEGER a été fournie comme ID d’entrée) ou des valeurs VARCHAR contenant les IDs hexadécimaux (si un ID hexadécimal a été fourni comme ID d’entrée).

Syntaxe

H3_GRID_DISK( <cell_id> , <k_value> )
Copy

Arguments

cell_id

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

k_value

Un INTEGER qui représente la distance de la grille. Vous devez spécifier une valeur non négative.

Renvoie

Renvoie un ARRAY des IDs des cellules H3 qui se trouvent à la distance k_value de la cellule spécifiée par cell_id. Les IDs sont dans l’un des formats suivants :

  • Si cell_id est une valeur INTEGER, la fonction renvoie les IDs sous forme de valeurs INTEGER.

  • Si cell_id est une valeur VARCHAR contenant l’ID hexadécimal, la fonction renvoie les IDs hexadécimaux sous forme de valeurs VARCHAR.

Exemples

L’exemple suivant renvoie un ARRAY des IDs des cellules H3 situées dans la distance de grille de 1 de la cellule avec l’ID 617540519050084351 (spécifié comme une valeur INTEGER).

SELECT H3_GRID_DISK(617540519050084351, 1);
Copy
+-------------------------------------+
| H3_GRID_DISK(617540519050084351, 1) |
|-------------------------------------|
| [                                   |
|   617540519050084351,               |
|   617540519051657215,               |
|   617540519050608639,               |
|   617540519050870783,               |
|   617540519050346495,               |
|   617540519051395071,               |
|   617540519051132927                |
| ]                                   |
+-------------------------------------+

L’exemple suivant renvoie un ARRAY des IDs des cellules H3 situées dans la distance de grille de 1 de la cellule avec l’ID 891f1d48863ffff (spécifié comme une valeur VARCHAR).

SELECT H3_GRID_DISK('891f1d48863ffff', 1);
Copy
+------------------------------------+
| H3_GRID_DISK('891F1D48863FFFF', 1) |
|------------------------------------|
| [                                  |
|   "891f1d48863ffff",               |
|   "891f1d4887bffff",               |
|   "891f1d4886bffff",               |
|   "891f1d4886fffff",               |
|   "891f1d48867ffff",               |
|   "891f1d48877ffff",               |
|   "891f1d48873ffff"                |
| ]                                  |
+------------------------------------+
Langage: Français