h3_longlatash3
-Funktion
Gilt für: Databricks SQL Databricks Runtime 11.3 LTS und höher
Gibt die H3-Zellen-ID (als BIGINT) zurück, die dem bereitgestellten Längen- und Breitengrad bei der angegebenen Auflösung entspricht.
Syntax
h3_longlatash3 ( 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 BIGINT, der die H3-Zellen-ID des Eingabestandorts 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 als0
oder größer als15
ist, gibt die Funktion H3_INVALID_RESOLUTION_VALUE zurück.
Beispiele
-- 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