Compartir a través de


Función h3_longlatash3string

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

Valor del tipo STRING, el cual representa, como una cadena hexadecimal, el identificador de celda H3 de la ubicación de entrada, con la resolución especificada.

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