Kategorien:

Geodatenfunktionen

H3_POINT_TO_CELL_STRING

Gibt den hexadezimalen 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, H3_CELL_TO_POINT

Syntax

H3_POINT_TO_CELL_STRING( <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 VARCHAR-Wert zurück, der der hexadezimalen ID der H3-Zelle für den angegebenen Standort und die angegebene Auflösung entspricht.

Beispiele

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

SELECT H3_POINT_TO_CELL_STRING(ST_POINT(13.377704, 52.516262), 8);
Copy
+------------------------------------------------------------+
| H3_POINT_TO_CELL_STRING(ST_POINT(13.377704, 52.516262), 8) |
|------------------------------------------------------------|
|  881F1D4887FFFFF                                           |
+------------------------------------------------------------+

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_STRING(ST_POINT(13.377704, 52.516262), 18);
Copy
100410 (P0000): Invalid H3 resolution value: 18. Resolution must be between 0 (coarsest) and 15 (finest).