Compartir a través de

Función h3_longlatash3string

  • Artículo

Se aplica a: casilla 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 STRING hexadecimal) que se corresponda con la longitud y la latitud que se proporcionan en la resolución que se especifique.

Sintaxis

h3_longlatash3string ( longitudeExpr, latitudeExpr, resolutionExpr )

Argumentos

  • longitudeExpr: una expresión DOUBLE que se usa para representar la longitud (en grados) de la ubicación cuyo id. de celda H3 se quiere calcular.
  • latitudeExpr: una expresión DOUBLE que se usa para representar la latitud (en grados) de la ubicación cuyo id. de celda H3 se quiere calcular.
  • resolutionExpr: una expresión INT cuyo valor se espera que esté entre 0 y 15 (incluidos), que se usa para especificar la resolución del id. de celda H3.

Devoluciones

Se devuelve un valor del tipo STRING que se usa para representar, en forma de cadena hexadecimal, el id. de celda H3 de la ubicación de entrada en la resolución que se especifique.

La función devuelve NULL si alguna de las tres expresiones de entrada es NULL. Los valores que se encuentren fuera de [-180, 180] para la expresión de longitud y de [-90, 90] para la expresión de latitud se asignarán 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_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