Kategorien:

Geodatenfunktionen

H3_COVERAGE_STRINGS

Gibt eine ARRAY von hexadezimalen IDs (als VARCHAR-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, H3_POLYGON_TO_CELLS_STRINGS

Syntax

H3_COVERAGE_STRINGS( <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 VARCHAR-Werten für die hexadezimalen 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_STRINGS.

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

Beispiele

Im folgenden Beispiel wird ein ARRAY der hexadezimalen IDs zurückgegeben, die die minimale Menge von H3-Zellen identifizieren, die das angegebene Polygon vollständig abdecken.

SELECT H3_COVERAGE_STRINGS(
  TO_GEGGRAPHY(
    '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 |
|----------------------------------|
| [                                |
|   "882830870bfffff",             |
|   "8828308703fffff",             |
|   "8828308739fffff",             |
|   "8828308709fffff",             |
|   "8828308701fffff",             |
|   "8828308715fffff"              |
| ]                                |
|----------------------------------|
Sprache: Deutsch