Kategorien:

Geodatenfunktionen

H3_COVERAGE

Gibt eine ARRAY von IDs (als INTEGER-Werte) zurück, die die minimale Menge von H3-Zellen identifiziert, die eine Form (angegeben durch ein GEOGRAPHY-Objekt) vollständig bedecken.

Siehe auch:

H3_COVERAGE_STRINGS, H3_POLYGON_TO_CELLS

Syntax

H3_COVERAGE( <geography_expression> , <target_resolution> )
Copy

Argumente

geography_expression

Ein GEOGRAPHY-Objekt.

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 für die IDs der minimalen Menge von H3-Zellen zurück, die die angegebenen Eingabeform vollständig abdecken.

Nutzungshinweise

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

  • Eine Zelle wird in das Resultset aufgenommen, wenn ihre Begrenzung die Eingabeform schneidet.

  • 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 zurückgegeben, die die minimale Menge von H3-Zellen identifizieren, die das angegebene Polygon vollständig abdecken.

SELECT H3_COVERAGE(
  TO_GEOGRAPHY(
    'POLYGON((-122.481889 37.826683,-122.479487 37.808548,-122.474150 37.808904,-122.476510 37.826935,-122.481889 37.826683))'),
  8) AS set_of_h3_cells_covering_polygon;
Copy
+----------------------------------+
| SET_OF_H3_CELLS_COVERING_POLYGON |
|----------------------------------|
| [                                |
|   613196571542028287,            |
|   613196571548319743,            |
|   613196571598651391,            |
|   613196571539931135,            |
|   613196571560902655,            |
|   613196571550416895             |
| ]                                |
+----------------------------------+
Sprache: Deutsch