Compartilhar via


Função h3_longlatash3string

Aplica-se a:verificação marcada como sim Databricks SQL verificação marcada como sim Databricks Runtime 11.3 LTS e versões superiores

Retorna a ID da célula H3 (como uma série hexadecimal) correspondente à longitude e latitude fornecidas na resolução especificada.

Sintaxe

h3_longlatash3string ( longitudeExpr, latitudeExpr, resolutionExpr )

Argumentos

  • longitudeExpr: uma expressão DOUBLE que representa a longitude (em graus) do local cuja ID de célula H3 desejamos fazer a computação.
  • latitudeExpr: uma expressão DOUBLE que representa a latitude (em graus) do local cuja ID de célula H3 desejamos fazer a computação.
  • resolutionExpr: uma expressão INT, cujo valor deve ser entre 0 e 15 inclusive, especificando a resolução da ID da célula H3.

Retornos

Um valor do tipo de STRING que representa, como uma cadeia de caracteres hexadecimal, a ID da célula H3 do local de entrada na resolução especificada.

A função retornará NULL se uma das expressões de entrada for NULL. Valores além de [-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

Exemplos

-- Simple example.
> SELECT h3_longlatash3string(100, 45, 6)
  86240610fffffff

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

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