H3_POLYGON_TO_CELLS¶

Syntax¶

H3_POLYGON_TO_CELLS( <geography_polygon> , <target_resolution> )

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;

+-----------------------+
| H3_CELLS_IN_POLYGON   |
|-----------------------|
| [                     |
|   617700171176476671, |
|   617700171168874495, |
|   617700171177525247, |
|   617700171167563775, |
|   617700171225497599, |
|   617700171188011007, |
|   617700171168350207, |
|   617700171168612351, |
|   617700171167825919  |
| ]                     |
+-----------------------+