Kategorien:

Geodatenfunktionen

H3_TRY_POLYGON_TO_CELLS

Eine spezielle Version von H3_POLYGON_TO_CELLS, die NULL zurückgibt, wenn ein Fehler bei dem Versuch auftritt, ein Array von INTEGER-Werten der IDs von H3-Zellen zurückzugeben, deren Zentroide in einem Polygon (angegeben durch ein GEOGRAPHY-Objekt) enthalten sind.

Syntax

H3_TRY_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 oder NULL zurück.

  • Wenn die Funktion eine erfolgreiche Berechnung ausführen kann, wird ein Array von INTEGER-Werten für die IDs der H3-Zellen zurückgegeben, deren Zentroide im angegebenen Eingabepolygon enthalten sind.

  • Wenn die Funktion keine erfolgreiche Berechnung ausführen kann, gibt sie NULL zurück, ohne einen Fehler zu melden.

Nutzungshinweise

Nutzungshinweise finden Sie unter H3_POLYGON_TO_CELLS.

Beispiele

Im folgenden Beispiel wird versucht, ein Array von INTEGER-Werten der IDs der H3-Zellen zurückzugeben, deren Zentroide in einem Polygon (angegeben durch ein GEOGRAPHY-Objekt) enthalten sind. Da das Array mit den Zellen, die das angegebene Sechseck bei der gegebenen Auflösung abdecken, die zulässige Größenbeschränkung überschreitet, gibt die Funktion NULL zurück.

SELECT H3_TRY_POLYGON_TO_CELLS(
  TO_GEOGRAPHY('POLYGON((-108.959 40.948,
                         -109.015 37.077,
                         -102.117 36.956,
                         -102.134 40.953,
                         -108.959 40.948))'
              ), 15) AS h3_cells_in_polygon;
Copy
+---------------------+
| H3_CELLS_IN_POLYGON |
|---------------------|
| NULL                |
+---------------------+

Beispiele für die erfolgreiche Rückgabe eines Arrays von IDs finden Sie unter H3_POLYGON_TO_CELLS.

Sprache: Deutsch