h3_longlatash3string Función

Se aplica a:marcado sí Databricks SQL marcado sí Databricks Runtime 11.3 LTS y superior marcado sí Lakehouse//RT

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 DOUBLE expresión que representa la longitud (en grados) de la ubicación cuyo ID de celda H3 queremos calcular.
  • latitudeExpr: Una DOUBLE expresión que representa la latitud (en grados) de la ubicación cuyo ID de celda H3 queremos calcular.
  • resolutionExpr: Una INT expresión cuyo valor se espera que esté entre 0 y 15 inclusive, que especifica la resolución para el ID 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