Compartir a través de

Función h3_longlatash3

Se aplica acasilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 11.3 LTS y versiones posteriores

Esta función se usa para obtener el id. de celda H3 (en forma de expresión BIGINT) que se corresponda con la longitud y la latitud que se proporcionan en la resolución que se especifique.

Sintaxis

h3_longlatash3 ( longitudeExpr, latitudeExpr, resolutionExpr )

Argumentos

  • longitudeExpr DOUBLE: expresión que representa la longitud (en grados) de la ubicación cuyo identificador de celda H3 queremos calcular.
  • latitudeExpr DOUBLE: expresión que representa la latitud (en grados) de la ubicación cuyo identificador de celda H3 queremos calcular.
  • resolutionExpr: expresión INT cuyo valor se espera que esté comprendido entre 0 y 15 inclusive, especificando la resolución para el identificador de celda H3.

Devoluciones

Un valor del tipo BIGINT que representa el ID de celda H3 de la ubicación de entrada, en la resolución especificada.

La función devuelve NULL si alguna de las tres expresiones de entrada es NULL. Los valores fuera de [-180, 180] para la expresión de longitud y [-90, 90] para la expresión de latitud se asignan a sus equivalentes dentro de estos intervalos. Se espera que los valores de longitud y latitud estén en el sistema de referencia de coordenadas WGS84.

Condiciones de error

Ejemplos

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