Categorias:

Funções geoespaciais

H3_LATLNG_TO_CELL_STRING

Retorna o ID de célula H3 em formato hexadecimal (como um valor VARCHAR) para uma determinada latitude, longitude e resolução.

Consulte também:

H3_LATLNG_TO_CELL

Sintaxe

H3_LATLNG_TO_CELL_STRING( <latitude> , <longitude> , <target_resolution> )
Copy

Argumentos

latitude

Um FLOAT que representa a latitude.

Valores fora do intervalo de latitude padrão são agrupados no intervalo [-90, 90].

longitude

Um FLOAT que representa a longitude.

Valores fora do intervalo de longitude padrão são agrupados no intervalo [-180, 180].

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.

Notas de uso

  • Especificar valores NaN ou Inf para qualquer argumento de entrada resulta em erro.

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_LATLNG_TO_CELL_STRING(52.516262, 13.377704, 8);
Copy
+---------------------------------------------------+
| H3_LATLNG_TO_CELL_STRING(52.516262, 13.377704, 8) |
|---------------------------------------------------|
|  881F1D4887FFFFF                                  |
+---------------------------------------------------+

O exemplo a seguir especifica um valor longitude (373.377704) que está fora do intervalo de longitude tradicional (-180 a 180). A função interpreta esse valor como 13.377704 (373.377704 módulo 180).

SELECT H3_LATLNG_TO_CELL_STRING(52.516262, 373.377704, 8);
Copy
+---------------------------------------------------+
| H3_LATLNG_TO_CELL_STRING(52.516262, 13.377704, 8) |
|---------------------------------------------------|
|  881F1D4887FFFFF                                  |
+---------------------------------------------------+

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

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