H3_LATLNG_TO_CELL¶

Sintaxe¶

H3_LATLNG_TO_CELL( <latitude> , <longitude> , <target_resolution> )

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

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

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

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