Condividi tramite

Funzione h3_longlatash3

  • 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 BIGINT) corrispondente alla longitudine e alla latitudine specificate alla risoluzione specificata.

Sintassi

h3_longlatash3 ( 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 BIGINT che rappresenta l'ID cella H3 della posizione di input nella 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_longlatash3(100, 45, 6)
  604116085645508607

-- The H3 cell ID for the Golden Gate Bridge at resolution 13.
> SELECT h3_longlatash3(-122.4783, 37.8199, 13)
  635714569676958015

-- Resolution is out of range.
> SELECT h3_longlatash3(-122.4783, 37.8199, 16)
  [H3_INVALID_RESOLUTION_VALUE] H3 resolution 16 must be between 0 and 15, inclusive