Categorias:: Funções geospaciais

H3_POINT_TO_CELL¶

Retorna o valor INTEGER de um ID de célula H3 para um ponto (especificado por um objeto GEOGRAPHY) em uma determinada resolução.

Consulte também:: H3_POINT_TO_CELL_STRING , H3_CELL_TO_POINT

Sintaxe¶

H3_POINT_TO_CELL( <geography_point> , <target_resolution> )

Argumentos¶

geography_point

Um objeto GEOGRAPHY que representa um ponto.

target_resolution

Um INTEGER entre 0 e 15 (inclusive) que especifica a resolução H3 que você deseja usar para a célula H3 retornada.

Especificar qualquer outro valor INTEGER resulta em erro.

Retornos¶

Retorna um valor INTEGER que corresponde ao ID da célula H3 para o local e resolução fornecidos.

Exemplos¶

O exemplo a seguir retorna o ID da célula H3 para o Portão de Brandemburgo na resolução 8.

SELECT H3_POINT_TO_CELL(ST_POINT(13.377704, 52.516262), 8);

+-----------------------------------------------------+
| H3_POINT_TO_CELL(ST_POINT(13.377704, 52.516262), 8) |
|-----------------------------------------------------|
|                                  613036919424548863 |
+-----------------------------------------------------+

O exemplo a seguir demonstra que não é possível especificar uma resolução fora de 0 a 15.

SELECT H3_POINT_TO_CELL(ST_POINT(13.377704, 52.516262), 18);

100410 (P0000): Invalid H3 resolution value: 18. Resolution must be between 0 (coarsest) and 15 (finest).