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

Související funkce

• h3_longlatash3string
• h3_pointash3
• h3_pointash3string