Categorias:

Funções geoespaciais

H3_LATLNG_TO_CELL

Retorna o valor INTEGER do ID da célula H3 para uma determinada latitude, longitude e resolução.

Consulte também:

H3_LATLNG_TO_CELL_STRING

Sintaxe

H3_LATLNG_TO_CELL( <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 INTEGER correspondente ao ID 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 da célula H3 para o Portão de Brandemburgo na resolução 8.

SELECT H3_LATLNG_TO_CELL(52.516262, 13.377704, 8);
Copy
+--------------------------------------------+
| H3_LATLNG_TO_CELL(52.516262, 13.377704, 8) |
|--------------------------------------------|
|                         613036919424548863 |
+--------------------------------------------+

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(52.516262, 373.377704, 8);
Copy
+---------------------------------------------+
| H3_LATLNG_TO_CELL(52.516262, 373.377704, 8) |
|---------------------------------------------|
|                          613036919424548863 |
+---------------------------------------------+

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

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