Funzione h3_longlatash3string

Si applica a: Databricks SQL Databricks Runtime 11.3 LTS e versioni successive

Restituisce l'ID cella H3 (come stringa esadecimale) corrispondente alla longitudine e alla latitudine fornite alla risoluzione specificata.

Sintassi

h3_longlatash3string ( longitudeExpr, latitudeExpr, resolutionExpr )

Argomenti

• longitudeExpr DOUBLE: espressione che rappresenta la longitudine (in gradi) della posizione di cui si vuole calcolare l'ID cella H3.
• latitudeExpr DOUBLE: espressione che rappresenta la latitudine (in gradi) della posizione di cui si vuole calcolare l'ID cella H3.
• resolutionExpr INT: espressione, il cui valore deve essere compreso tra 0 e 15 inclusi, specificando la risoluzione per l'ID cella H3.

Valori restituiti

Un valore del tipo di STRING che rappresenta, come stringa esadecimale, l'ID della cella H3 della posizione di input alla risoluzione specificata.

La funzione restituisce NULL se una delle tre espressioni di input è NULL. I valori esterni [-180, 180] all'espressione di longitudine e [-90, 90] per l'espressione di latitudine vengono mappati ai relativi equivalenti all'interno di questi intervalli. I valori di longitudine e latitudine devono trovarsi nel sistema di riferimento delle coordinate WGS84.

Condizioni di errore

• Se resolutionExpr è minore o maggiore di 015, la funzione restituisce H3_INVALID_RESOLUTION_VALUE.

Esempi

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

Funzioni correlate

• h3_longlatash3 Funzione
• h3_pointash3 Funzione
• h3_pointash3string Funzione