Share via

Funzione h3_longlatash3string

  • Articolo

Si applica a:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 11.3 LTS e versioni successive

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

Sintassi

h3_longlatash3string ( longitudeExpr, latitudeExpr, resolutionExpr )

Argomenti

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

Valori restituiti

Valore del tipo di stringa che rappresenta, come stringa esadecimale, l'ID 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

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