Catégories :

Fonctions géospatiales

H3_GRID_PATH

Renvoie un ARRAY des IDs des cellules H3 qui représentent la ligne entre deux cellules. Les IDs dans l’ARRAY renvoyé sont des valeurs INTEGER (si des valeurs INTEGER ont été fournies comme IDs d’entrée) ou des valeurs VARCHAR contenant des IDs hexadécimaux (si des IDs hexadécimaux ont été fournis comme IDs d’entrée).

Syntaxe

H3_GRID_PATH( <cell_id_1> , <cell_id_2> )
Copy

Arguments

cell_id_1

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.

cell_id_2

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.

Renvoie

Renvoie un ARRAY des IDs des cellules H3 qui représentent la ligne entre les cellules spécifiées par cell_id_1 et cell_id_2. Les IDs sont dans l’un des formats suivants :

  • Si cell_id_1 et cell_id_2 sont des valeurs INTEGER, la fonction renvoie les IDs sous forme de valeurs INTEGER.

  • Si cell_id_1 et cell_id_2 sont des valeurs VARCHAR contenant des IDs hexadécimaux, la fonction renvoie des IDs hexadécimaux sous forme de valeurs VARCHAR.

Notes sur l’utilisation

Les deux IDs de cellules d’entrée doivent utiliser la même résolution.

Exemples

L’exemple suivant renvoie un ARRAY des IDs des cellules H3 qui représentent la ligne entre les cellules avec les IDs 617540519103561727 et 617540519052967935 (toutes deux spécifiées comme valeurs INTEGER).

SELECT H3_GRID_PATH(617540519103561727, 617540519052967935);
Copy
+------------------------------------------------------+
| H3_GRID_PATH(617540519103561727, 617540519052967935) |
|------------------------------------------------------|
| [                                                    |
|   617540519103561727,                                |
|   617540519046414335,                                |
|   617540519047462911,                                |
|   617540519044055039,                                |
|   617540519045103615,                                |
|   617540519052967935                                 |
| ]                                                    |
+------------------------------------------------------+

L’exemple suivant renvoie un ARRAY des IDs des cellules H3 qui représentent la ligne entre les cellules avec les IDs 891f1d48b93ffff et 891f1d4888fffff (toutes deux spécifiées comme valeurs VARCHAR).

SELECT H3_GRID_PATH('891f1d48b93ffff', '891f1d4888fffff');
Copy
+----------------------------------------------------+
| H3_GRID_PATH('891F1D48B93FFFF', '891F1D4888FFFFF') |
|----------------------------------------------------|
| [                                                  |
|   "891f1d48b93ffff",                               |
|   "891f1d4882bffff",                               |
|   "891f1d4883bffff",                               |
|   "891f1d48807ffff",                               |
|   "891f1d48817ffff",                               |
|   "891f1d4888fffff"                                |
| ]                                                  |
+----------------------------------------------------+