Categorias:

Funções geospaciais

H3_COMPACT_CELLS_STRINGS

Retorna uma matriz de valores VARIANT que contêm os IDs hexadecimais VARCHAR de células H3 maiores e em menor número que cobrem a mesma área que as células H3 na entrada. Para obter informações sobre células compactadas, consulte Indexação.

Sintaxe

H3_COMPACT_CELLS_STRINGS( <array_of_cell_ids> )
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).

Retornos

Retorna um valor de tipo de dados ARRAY ou NULL.

  • Se a entrada for uma matriz de valores VARCHAR hexadecimais, retorna uma matriz que consiste em valores VARIANT que representam um conjunto compactado de células H3. Os valores VARIANT contêm valores VARCHAR hexadecimais que representam IDs da célula H3.

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

  • Todas as células H3 na entrada devem ter a mesma resolução.

  • As células H3 na entrada devem cobrir áreas exclusivas sem sobreposição. Células H3 duplicadas não são permitidas.

Exemplos

O exemplo a seguir compacta um conjunto de células H3, retornando células em uma resolução mais baixa que representam a mesma área.

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