Categorias:

Funções geoespaciais

H3_POINT_TO_CELL_STRING

Retorna o valor hexadecimal 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 , H3_CELL_TO_POINT

Sintaxe

H3_POINT_TO_CELL_STRING( <geography_point> , <target_resolution> )
Copy

Argumentos

geography_point

Um objeto GEOGRAPHY que representa um ponto.

target_resolution

Um INTEGER entre 0 e 15 (inclusive) especificando 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 VARCHAR correspondente ao ID hexadecimal da célula H3 para o local e resolução fornecidos.

Exemplos

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

SELECT H3_POINT_TO_CELL_STRING(ST_POINT(13.377704, 52.516262), 8);
Copy
+------------------------------------------------------------+
| H3_POINT_TO_CELL_STRING(ST_POINT(13.377704, 52.516262), 8) |
|------------------------------------------------------------|
|  881F1D4887FFFFF                                           |
+------------------------------------------------------------+

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

SELECT H3_POINT_TO_CELL_STRING(ST_POINT(13.377704, 52.516262), 18);
Copy
100410 (P0000): Invalid H3 resolution value: 18. Resolution must be between 0 (coarsest) and 15 (finest).