- Categorias:
H3_GRID_DISK¶
Retorna um ARRAY 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" |
| ] |
+------------------------------------+