Categorias:

Funções geospaciais

H3_UNCOMPACT_CELLS_STRINGS

Retorna uma matriz de valores VARIANT que contêm IDs hexadecimais VARCHAR de células H3 na resolução especificada que cobrem a mesma área que as células H3 na entrada.

Sintaxe

H3_UNCOMPACT_CELLS_STRINGS( <array_of_cell_ids> , <target_resolution> )
Copy

Argumentos

array_of_cell_ids

Uma matriz de valores VARIANT que contém valores VARCHAR hexadecimais que representam IDs da célula H3 (índices).

target_resolution

Um valor INTEGER entre 0 e 15 (inclusive) especificando resolução H3 que você deseja usar para as células H3 retornadas.

Especificar qualquer outro valor INTEGER resulta em erro.

Retornos

Retorna um valor de tipo de dados ARRAY ou NULL.

  • Se a entrada for uma matriz de valores VARIANT que contêm valores hexadecimais VARCHAR, retorna uma matriz de valores VARIANT que contêm valores hexadecimais VARCHAR que representam o conjunto de células H3 na resolução especificada.

  • Se a entrada for NULL, retorna NULL sem relatar um erro.

Notas de uso

  • Todos os valores VARCHAR hexadecimais na entrada devem representar células H3 válidas.

  • As células de entrada não podem ter uma resolução maior que a resolução especificada no argumento target_resolution.

Exemplos

O exemplo a seguir retorna um conjunto não compactado de células H3 que representam IDs de células H3 válidas e uma resolução alvo de 10.

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