Catégories :

Fonctions géospatiales

H3_UNCOMPACT_CELLS_STRINGS

Renvoie un tableau de valeurs VARIANT contenant les IDs hexadécimaux VARCHAR de cellules H3 à la résolution spécifiée qui couvrent la même zone que les cellules H3 de l’entrée.

Syntaxe

H3_UNCOMPACT_CELLS_STRINGS( <array_of_cell_ids> , <target_resolution> )
Copy

Arguments

array_of_cell_ids

Tableau de valeurs VARIANT contenant des valeurs hexadécimales VARCHAR représentant des IDs de cellules H3 (index).

target_resolution

Valeur INTEGER comprise entre 0 et 15 (inclus) spécifiant la résolution H3 que vous souhaitez utiliser pour les cellules H3 renvoyées.

La spécification de toute autre valeur INTEGER entraîne une erreur.

Renvoie

Renvoie une valeur du type de données ARRAY ou NULL.

  • Si l’entrée est un tableau de valeurs VARIANT contenant des valeurs hexadécimales VARCHAR, renvoie un tableau de valeurs VARIANT contenant les valeurs hexadécimales VARCHAR qui représentent l’ensemble de cellules H3 à la résolution spécifiée.

  • Si l’entrée est NULL, renvoie NULL sans signaler d’erreur.

Notes sur l’utilisation

  • Toutes les valeurs hexadécimales VARCHAR de l’entrée doivent représenter des cellules H3 valides.

  • Les cellules d’entrée ne peuvent pas avoir une résolution supérieure à celle spécifiée dans l’argument target_resolution.

Exemples

L’exemple suivant renvoie un ensemble non compacté de cellules H3 représentant des IDs de cellules H3 et une résolution cible de 10.

SELECT H3_UNCOMPACT_CELLS_STRINGS(
  [
    '8a2a1072339ffff',
    '892a1072377ffff'
  ],
  10
) AS uncompacted;
Copy
+----------------------+
| UNCOMPACTED          |
|----------------------|
| [                    |
|   "8a2a1072339ffff", |
|   "8a2a10723747fff", |
|   "8a2a1072374ffff", |
|   "8a2a10723757fff", |
|   "8a2a1072375ffff", |
|   "8a2a10723767fff", |
|   "8a2a1072376ffff", |
|   "8a2a10723777fff"  |
| ]                    |
+----------------------+
Langage: Français