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