Categorias:: Funções geoespaciais

H3_GRID_PATH¶

Retorna um ARRAY de IDs das células H3 que representam a linha entre duas células. Os IDs no ARRAY retornado são valores INTEGER (se os valores INTEGER foram fornecidos como IDs da entrada) ou valores VARCHAR contendo IDs hexadecimais (se os IDs hexadecimais forem fornecidos como IDs de entrada).

Sintaxe¶

H3_GRID_PATH( <cell_id_1> , <cell_id_2> )

Copy

Argumentos¶

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

Retornos¶

Retorna um ARRAY de IDs de células H3 que representam a linha entre as células especificadas por cell_id_1 e cell_id_2. Os IDs estão em um dos seguintes formatos:

Se cell_id_1 e cell_id_2 forem valores INTEGER, a função retornará IDs como valores INTEGER.
Se cell_id_1 e cell_id_2 forem valores VARCHAR contendo IDs hexadecimais, a função retornará IDs hexadecimais como valores VARCHAR.

Notas de uso¶

Os dois IDs de célula de entrada devem usar a mesma resolução.

Exemplos¶

O exemplo a seguir retorna um ARRAY de IDs de células H3 que representam a linha entre as células com os valores IDs 617540519103561727 e 617540519052967935 (ambos especificados como valores INTEGER).

SELECT H3_GRID_PATH(617540519103561727, 617540519052967935);

Copy

+------------------------------------------------------+
| H3_GRID_PATH(617540519103561727, 617540519052967935) |
|------------------------------------------------------|
| [                                                    |
|   617540519103561727,                                |
|   617540519046414335,                                |
|   617540519047462911,                                |
|   617540519044055039,                                |
|   617540519045103615,                                |
|   617540519052967935                                 |
| ]                                                    |
+------------------------------------------------------+

O exemplo a seguir retorna um ARRAY de IDs de células H3 que representam a linha entre as células com os valores IDs 891f1d48b93ffff e 891f1d4888fffff (ambos especificados como valores VARCHAR).

SELECT H3_GRID_PATH('891f1d48b93ffff', '891f1d4888fffff');

Copy

+----------------------------------------------------+
| H3_GRID_PATH('891F1D48B93FFFF', '891F1D4888FFFFF') |
|----------------------------------------------------|
| [                                                  |
|   "891f1d48b93ffff",                               |
|   "891f1d4882bffff",                               |
|   "891f1d4883bffff",                               |
|   "891f1d48807ffff",                               |
|   "891f1d48817ffff",                               |
|   "891f1d4888fffff"                                |
| ]                                                  |
+----------------------------------------------------+