Categorias:

Funções geospaciais

H3_GRID_DISK

Retorna uma matriz de IDs das células H3 que estão dentro da distância k da célula especificada. Os IDs no ARRAY retornado são valores INTEGER (se um valor INTEGER foi fornecido como o ID de entrada) ou valores VARCHAR contendo IDs hexadecimais (se um ID hexadecimal foi fornecido como ID de entrada).

Sintaxe

H3_GRID_DISK( <cell_id> , <k_value> )

Argumentos

cell_id

Um INTEGER que representa o ID da célula H3 (índice) ou um VARCHAR que representa o ID da célula em formato hexadecimal.

k_value

Um INTEGER que representa a distância da grade. Você deve especificar um valor não negativo.

Retornos

Retorna um ARRAY de IDs de células H3 que estão dentro da distância k_value da célula especificada por cell_id. Os IDs estão em um dos seguintes formatos:

  • Se cell_id for um valor INTEGER, a função retornará IDs como valores INTEGER.

  • Se cell_id for um valor VARCHAR contendo o ID hexadecimal, a função retornará IDs hexadecimais como valores VARCHAR.

Exemplos

O exemplo a seguir retorna um ARRAY de IDs de células H3 dentro da distância da grade de 1 da célula com o ID 617540519050084351 (especificado como um valor INTEGER).

SELECT H3_GRID_DISK(617540519050084351, 1);

+-------------------------------------+
| H3_GRID_DISK(617540519050084351, 1) |
|-------------------------------------|
| [                                   |
|   617540519050084351,               |
|   617540519051657215,               |
|   617540519050608639,               |
|   617540519050870783,               |
|   617540519050346495,               |
|   617540519051395071,               |
|   617540519051132927                |
| ]                                   |
+-------------------------------------+

O exemplo a seguir retorna um ARRAY de IDs de células H3 dentro da distância da grade de 1 da célula com o ID 891f1d48863ffff (especificado como um valor VARCHAR).

SELECT H3_GRID_DISK('891f1d48863ffff', 1);

+------------------------------------+
| H3_GRID_DISK('891F1D48863FFFF', 1) |
|------------------------------------|
| [                                  |
|   "891f1d48863ffff",               |
|   "891f1d4887bffff",               |
|   "891f1d4886bffff",               |
|   "891f1d4886fffff",               |
|   "891f1d48867ffff",               |
|   "891f1d48877ffff",               |
|   "891f1d48873ffff"                |
| ]                                  |
+------------------------------------+