Categorias:

Funções geospaciais

H3_TRY_GRID_PATH

Uma versão especial do H3_GRID_PATH que retorna NULL se ocorrer um erro ao tentar retornar uma matriz de valores VARIANT que contêm IDs das células H3 que representam a linha entre duas células.

Sintaxe

H3_TRY_GRID_PATH( <cell_id_1> , <cell_id_2> )
Copy

Argumentos

cell_id_1

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

cell_id_2

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

Retornos

Retorna um valor de tipo de dados ARRAY ou NULL.

  • Se a função executar um cálculo bem-sucedido, retornará uma matriz de valores VARIANT que contêm os IDs de células H3 que representam a linha entre as células especificadas por cell_id_1 e cell_id_2. Para obter informações sobre o formato de IDs, consulte H3_GRID_PATH.

  • Se a linha não puder ser calculada (por exemplo, quando duas células pertencem a células base não vizinhas), retorna NULL sem relatar um erro.

Notas de uso

Consulte H3_GRID_PATH para as notas de uso.

Exemplos

O exemplo a seguir tenta retornar uma linha entre duas células. Como as células pertencem a células base não vizinhas, a função falha ao retornar a linha e retorna NULL.

SELECT H3_TRY_GRID_PATH('813d7ffffffffff', '81343ffffffffff');
Copy
+--------------------------------------------------------+
| H3_TRY_GRID_PATH('813D7FFFFFFFFFF', '81343FFFFFFFFFF') |
|--------------------------------------------------------|
| NULL                                                   |
+--------------------------------------------------------+

Para exemplos que calculam com sucesso o caminho entre duas células H3, consulte H3_GRID_PATH.

Linguagem: Português