Catégories :

Fonctions géospatiales

H3_COMPACT_CELLS_STRINGS

Renvoie un tableau de valeurs VARIANT qui contiennent les IDs hexadécimaux VARCHAR de cellules H3 moins nombreuses et plus grandes qui couvrent la même surface que les cellules H3 de l’entrée. Pour des informations sur les cellules compactées, voir Indexation.

Syntaxe

H3_COMPACT_CELLS_STRINGS( <array_of_cell_ids> )
Copy

Arguments

array_of_cell_ids

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

Renvoie

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

  • Si l’entrée est un tableau de valeurs hexadécimales VARCHAR, renvoie un tableau composé de valeurs VARIANT qui représentent un ensemble compacté de cellules H3. Les valeurs VARIANT contiennent les valeurs hexadécimales VARCHAR qui représentent les IDs des cellules H3.

  • 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.

  • Toutes les cellules H3 de l’entrée doivent avoir la même résolution.

  • Les cellules H3 de l’entrée doivent couvrir des zones uniques sans se chevaucher. Les cellules H3 en double ne sont pas autorisées.

Exemples

L’exemple suivant compacte un ensemble de cellules H3, en renvoyant des cellules de résolution inférieure représentant la même zone.

SELECT H3_COMPACT_CELLS_STRINGS(
  [
    '8a2a10705507fff',
    '8a2a1070550ffff',
    '8a2a10705517fff',
    '8a2a1070551ffff',
    '8a2a10705527fff',
    '8a2a1070552ffff',
    '8a2a10705537fff',
    '8a2a10705cdffff'
    ]
  ) AS compacted;
Copy
+----------------------+
| COMPACTED            |
|----------------------|
| [                    |
|   "8a2a10705cdffff", |
|   "892a1070553ffff"  |
| ]                    |
+----------------------+