Kategorien:: Geodatenfunktionen

H3_POINT_TO_CELL¶

Gibt den INTEGER-Wert der ID der H3-Zelle für einen Punkt (durch ein GEOGRAPHY-Objekt angegeben) in einer bestimmten Auflösung zurück.

Siehe auch:: H3_POINT_TO_CELL_STRING, H3_CELL_TO_POINT

Syntax¶

H3_POINT_TO_CELL( <geography_point> , <target_resolution> )

Copy

Argumente¶

geography_point

Ein GEOGRAPHY-Objekt, das einen Punkt repräsentiert.

target_resolution

Ein INTEGER-Wert zwischen 0 und 15 (einschließlich), der die H3-Auflösung angibt, die Sie für die zurückgegebene H3-Zelle verwenden möchten.

Die Angabe eines beliebigen anderen INTEGER-Werts führt zu einem Fehler.

Rückgabewerte¶

Gibt einen INTEGER-Wert zurück, der der ID der H3-Zelle für den angegebenen Standort und die angegebene Auflösung entspricht.

Beispiele¶

Im folgenden Beispiel wird die ID der H3-Zelle für das Brandenburger Tor bei Auflösung 8 zurückgegeben.

SELECT H3_POINT_TO_CELL(ST_POINT(13.377704, 52.516262), 8);

Copy

+-----------------------------------------------------+
| H3_POINT_TO_CELL(ST_POINT(13.377704, 52.516262), 8) |
|-----------------------------------------------------|
|                                  613036919424548863 |
+-----------------------------------------------------+

Das folgende Beispiel zeigt, dass Sie für die Auflösung keinen Wert außerhalb von 0 bis 15 angeben können.

SELECT H3_POINT_TO_CELL(ST_POINT(13.377704, 52.516262), 18);

Copy

100410 (P0000): Invalid H3 resolution value: 18. Resolution must be between 0 (coarsest) and 15 (finest).