Categorias:

Funções geospaciais

H3_TRY_GRID_DISTANCE

Uma versão especial do H3_GRID_DISTANCE que retorna NULL se ocorrer um erro ao tentar retornar a distância entre duas células H3.

Sintaxe

H3_TRY_GRID_DISTANCE( <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 INTEGER ou NULL.

  • Se a função puder executar um cálculo bem-sucedido, retorna o valor INTEGER que representa a distância em células da grade entre as duas células H3.

  • Se a distância da grade 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_DISTANCE para as notas de uso.

Exemplos

O exemplo a seguir tenta calcular a distância entre duas células. Como as células pertencem a células base não vizinhas, a função falha ao calcular a distância e retorna NULL.

SELECT H3_TRY_GRID_DISTANCE(582046271372525567, 581883543651614719);
Copy
+--------------------------------------------------------------+
| H3_TRY_GRID_DISTANCE(582046271372525567, 581883543651614719) |
|--------------------------------------------------------------|
|                                                         NULL |
+--------------------------------------------------------------+

Para exemplos que calculam com sucesso a distância entre duas células H3, consulte H3_GRID_DISTANCE.

Linguagem: Português