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> )

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);

+--------------------------------------------------------------+
| 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.