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"                                |
| ]                                                  |
+----------------------------------------------------+