h3_longlatash3string-Funktion

Gilt für: Databricks SQL Databricks Runtime 11.3 LTS und höher

Gibt die H3-Zellen-ID (als hexadezimaler STRING) zurück, die dem angegebenen Längen- und Breitengrad bei der angegebenen Auflösung entspricht.

Syntax

h3_longlatash3string ( longitudeExpr, latitudeExpr, resolutionExpr )

Argumente

• longitudeExpr: Ein DOUBLE-Ausdruck, der den Längengrad (in Grad) des Standorts darstellt, dessen H3-Zellen-ID wir berechnen möchten.
• latitudeExpr: Ein DOUBLE-Ausdruck, der den Längengrad (in Grad) des Standorts darstellt, dessen H3-Zellen-ID wir berechnen möchten.
• resolutionExpr: Ein INT-Ausdruck, für den ein Wert zwischen 0 und einschließlich 15 erwartet wird und der die Auflösung für die H3-Zellen-IDs angibt.

Gibt zurück

Ein Wert des Typs von STRING, der als Hexadezimalzeichenfolge die H3-Zell-ID der Eingabeposition bei der angegebenen Auflösung darstellt.

Die Funktion gibt NULL zurück, wenn einer der drei Eingabeausdrücke NULL ist. Werte außerhalb von [-180, 180] für den Längengradausdruck und [-90, 90] für den Breitengradausdruck werden ihren Äquivalenten innerhalb dieser Bereiche zugeordnet. Die Längen- und Breitengradwerte werden im WGS84-Koordinatenreferenzsystem erwartet.

Fehlerbedingungen

• Wenn resolutionExpr kleiner als 0 oder größer als 15 ist, gibt die Funktion H3_INVALID_RESOLUTION_VALUE zurück.

Beispiele

-- 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

Zugehörige Funktionen

• h3_longlatash3-Funktion
• h3_pointash3-Funktion
• h3_pointash3string-Funktion