Kategorien:

Geodatenfunktionen

H3_TRY_COVERAGE

Eine spezielle Version von H3_COVERAGE, die NULL zurückgibt, wenn ein Fehler bei dem Versuch auftritt, ein Array von IDs (als INTEGER-Werte) zurückzugeben, die die minimale Menge von H3-Zellen identifizieren, die eine Form (angegeben durch ein GEOGRAPHY Objekt) vollständig abdecken.

Syntax

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

  • Wenn die Funktion eine erfolgreiche Berechnung ausführen kann, wird ein Array von INTEGER-Werten für die IDs der minimalen Menge von H3-Zellen zurückgegeben, die die angegebenen Eingabeform vollständig abdecken.

  • 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_COVERAGE.

Beispiele

Im folgenden Beispiel wird versucht, ein Array von IDs zurückzugeben, die die minimale Menge von H3-Zellen identifizieren, die eine Form (angegeben durch ein GEOGRAPHY-Objekt) vollständig bedecken. 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_COVERAGE(
  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 set_of_h3_cells_covering_polygon;
Copy
+----------------------------------+
| SET_OF_H3_CELLS_COVERING_POLYGON |
|----------------------------------|
| NULL                             |
+----------------------------------+

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

Sprache: Deutsch