Kategorien:

Geodatenfunktionen

H3_POLYGON_TO_CELLS_STRINGS

Gibt ein ARRAY von VARCHAR-Werten der hexadezimalen IDs von H3-Zellen zurück, deren Zentroide in einem Polygon (angegeben durch ein GEOGRAPHY-Objekt) enthalten sind.

Siehe auch:

H3_POLYGON_TO_CELLS_STRINGS, H3_COVERAGE_STRINGS

Syntax

H3_POLYGON_TO_CELLS_STRINGS( <geography_polygon> , <target_resolution> )
Copy

Argumente

geography_polygon

Ein GEOGRAPHY-Objekt, das ein Polygon 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ückgegebenen H3-Zellen verwenden möchten.

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

Rückgabewerte

Gibt ein ARRAY von VARCHAR-Werten für die hexadezimalen IDs der H3-Zellen zurück, deren Zentroide im angegebenen Eingabepolygon enthalten sind.

Nutzungshinweise

  • Die Funktion verwendet eine planare Approximation, bei der Punkte auf der Erdoberfläche so behandelt werden, als ob sie durch gerade Linien und nicht durch gekrümmte Bögen verbunden wären. Wenn Sie eine sphärische Approximation benötigen, verwenden Sie stattdessen H3_COVERAGE_STRINGS.

  • Eine Zelle gilt als innerhalb des Polygons liegend, wenn ihr Zentroid im Polygon enthalten ist.

Beispiele

Im folgenden Beispiel wird ein ARRAY von VARCHAR-Werten zurückgegeben, die die hexadezimalen IDs von H3-Zellen repräsentieren, deren Zentroide im angegebenen Polygon enthalten sind.

SELECT H3_POLYGON_TO_CELLS_STRINGS(
  TO_GEOGRAPHY(
    'POLYGON((-122.481889 37.826683,-122.479487 37.808548,-122.474150 37.808904,-122.476510 37.826935,-122.481889 37.826683))'),
  9) AS h3_cells_in_polygon;
Copy
+----------------------+
| H3_CELLS_IN_POLYGON  |
|----------------------|
| [                    |
|   "8928308715bffff", |
|   "89283087397ffff", |
|   "89283087023ffff", |
|   "892830870abffff", |
|   "89283087027ffff", |
|   "89283087033ffff", |
|   "8928308702fffff", |
|   "892830870bbffff", |
|   "89283087037ffff"  |
| ]                    |
+----------------------+
Sprache: Deutsch