Função h3_longlatash3

Aplica-se a: Databricks SQL Databricks Runtime 11.3 LTS e superior

Devolve o ID da célula H3 (como um BIGINT) correspondente à longitude e latitude fornecidas na resolução especificada.

Sintaxe

h3_longlatash3 ( longitudeExpr, latitudeExpr, resolutionExpr )

Argumentos

• longitudeExpr: Uma expressão DOUBLE que representa a longitude (em graus) do local cujo ID de célula H3 queremos calcular.
• latitudeExpr: Uma expressão DOUBLE que representa a latitude (em graus) do local cujo ID de célula H3 queremos calcular.
• resolutionExpr: Uma expressão INT, cujo valor deverá estar entre 0 e 15 inclusive, especificando a resolução para o ID da célula H3.

Devoluções

Um valor do tipo de BIGINT que representa o ID da célula H3 do local de entrada na resolução especificada.

A função retorna NULL se qualquer uma das três expressões de entrada for NULL. Os valores externos [-180, 180] para a expressão de longitude e [-90, 90] para a expressão de latitude são mapeados para seus equivalentes dentro desses intervalos. Espera-se que os valores de longitude e latitude estejam no sistema de referência de coordenadas WGS84.

Condições de erro

• Se resolutionExpr for menor 0 ou maior que 15, a função retornará H3_INVALID_RESOLUTION_VALUE.

Exemplos

-- Simple example.
> SELECT h3_longlatash3(100, 45, 6)
  604116085645508607

-- The H3 cell ID for the Golden Gate Bridge at resolution 13.
> SELECT h3_longlatash3(-122.4783, 37.8199, 13)
  635714569676958015

-- Resolution is out of range.
> SELECT h3_longlatash3(-122.4783, 37.8199, 16)
  [H3_INVALID_RESOLUTION_VALUE] H3 resolution 16 must be between 0 and 15, inclusive

Funções relacionadas

• h3_longlatash3string função
• h3_pointash3 função
• h3_pointash3string função