Funkce h3_longlatash3
Platí pro: Databricks SQL Databricks Runtime 11.3 LTS a vyšší
Vrátí ID buňky H3 (jako BIGINT), které odpovídá zadané délce a zeměpisné šířce v zadaném rozlišení.
Syntaxe
h3_longlatash3 ( longitudeExpr, latitudeExpr, resolutionExpr )
Argumenty
longitudeExpr
: Výraz DOUBLE představující zeměpisnou délku (ve stupních) umístění, jehož ID buňky H3 chceme vypočítat.latitudeExpr
: Výraz DOUBLE představující zeměpisnou šířku (ve stupních) umístění, jehož ID buňky H3 chceme vypočítat.resolutionExpr
: Výraz INT, jehož hodnota má být v rozmezí od 0 do 15 včetně, určuje rozlišení pro ID buňky H3.
Návraty
Hodnota typu BIGINT představující ID buňky H3 vstupního umístění v zadaném rozlišení.
Funkce vrátí hodnotu NULL, pokud některý ze tří vstupních výrazů má hodnotu NULL.
Hodnoty mimo [-180, 180]
výraz délky a [-90, 90]
pro výraz zeměpisné šířky se mapují na jejich ekvivalenty v těchto oblastech.
Očekává se, že hodnoty zeměpisné délky a zeměpisné šířky budou v referenčním systému souřadnic WGS84.
Chybové podmínky
- Pokud
resolutionExpr
je menší než nebo větší15
,0
vrátí funkce H3_INVALID_RESOLUTION_VALUE.
Příklady
-- 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