Kategorien:

Geodatenfunktionen

H3_POLYGON_TO_CELLS

Gibt ein ARRAY von INTEGER-Werten der 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

Syntax

H3_POLYGON_TO_CELLS( <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 INTEGER-Werten der IDs von 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.

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

  • Wenn Sie FLATTEN auf das von der Funktion zurückgegebenen ARRAY anwenden, wandeln Sie jeden Wert explizit in eine Ganzzahl (Integer) um.

Beispiele

Im folgenden Beispiel wird ein ARRAY der IDs von H3-Zellen zurückgegeben, deren Zentroide im angegebenen Polygon enthalten sind.

SELECT H3_POLYGON_TO_CELLS(
  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   |
|-----------------------|
| [                     |
|   617700171176476671, |
|   617700171168874495, |
|   617700171177525247, |
|   617700171167563775, |
|   617700171225497599, |
|   617700171188011007, |
|   617700171168350207, |
|   617700171168612351, |
|   617700171167825919  |
| ]                     |
+-----------------------+
Sprache: Deutsch