Condividi tramite


Funzione h3_longlatash3

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 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 BIGINT che rappresenta 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_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