H3_FromPoint

H3_FromPoint gibt die entsprechende H3-Zellen-ID aus einem eingegebenen Längengrad, Breitengrad und der Auflösung zurück. Weitere Informationen zur H3-Indizierung finden Sie in H3.

Syntax

H3_FromPoint(geom, resolution)

Argumente

geom

Ein Wert vom Datentyp GEOMETRY oder ein Ausdruck, der zu einem GEOMETRY-Typ ausgewertet wird. geom muss ein POINT sein.

Auflösung

Ein Wert vom Datentyp INTEGER oder ein Ausdruck, der zu einem INTEGER-Typ ausgewertet wird. Der Wert steht für die Auflösung des H3-Rastersystems. Der Wert muss eine ganze Zahl zwischen 0 und einschließlich 15 sein. Dabei ist 0 die größte und 15 die feinste Auflösung.

Rückgabetyp

BIGINT – steht für die H3-Zellen-ID.

Wenn geom kein POINT ist, wird ein Fehler zurückgegeben.

Wenn die Auflösung außerhalb des Bereichs liegt, wird ein Fehler zurückgegeben.

Wenn geom leer ist, wird NULL zurückgegeben.

Beispiele

Das folgende SQL gibt die H3-Zellen-ID von Punkt 0,0 und Auflösung 10 zurück.

SELECT H3_FromPoint(ST_GeomFromText('POINT(0 0)'), 10);

 h3_frompoint
-------------------
 623560421467684863