Kategorien:

Geodatenfunktionen

H3_UNCOMPACT_CELLS_STRINGS

Gibt ein Array von VARIANT-Werten zurück, die die hexadezimalen VARCHAR-IDs von H3-Zellen mit der angegebenen Auflösung enthalten, die denselben Bereich wie die H3-Zellen in der Eingabe abdecken.

Syntax

H3_UNCOMPACT_CELLS_STRINGS( <array_of_cell_ids> , <target_resolution> )
Copy

Argumente

array_of_cell_ids

Ein Array von VARIANT-Werten, die hexadezimale VARCHAR-Werte enthalten, die H3-Zellen-IDs repräsentieren (indiziert).

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 einen Wert vom Datentyp ARRAY oder NULL zurück.

  • Wenn die Eingabe ein Array von VARIANT-Werten ist, die hexadezimale VARCHAR-Werte enthalten, wird ein Array von VARIANT-Werten zurückgegeben, die die hexadezimale VARCHAR-Werte enthalten, die die Menge von H3-Zellen in der angegebenen Auflösung repräsentieren.

  • Wenn die Eingabe NULL ist, wird NULL ohne Meldung eines Fehlers zurückgegeben.

Nutzungshinweise

  • Alle hexadezimalen VARCHAR-Werte in der Eingabe müssen gültige H3-Zellen repräsentieren.

  • Die Eingabezellen können keine höhere Auflösung haben als die im Argument target_resolution angegebene Auflösung.

Beispiele

Im folgenden Beispiel wird eine nicht komprimierte Menge von H3-Zellen zurückgegeben, die gültige H3-Zellen-IDs mit einer Zielauflösung von 10 repräsentieren.

SELECT H3_UNCOMPACT_CELLS_STRINGS(
  [
    '8a2a1072339ffff',
    '892a1072377ffff'
  ],
  10
) AS uncompacted;
Copy
+----------------------+
| UNCOMPACTED          |
|----------------------|
| [                    |
|   "8a2a1072339ffff", |
|   "8a2a10723747fff", |
|   "8a2a1072374ffff", |
|   "8a2a10723757fff", |
|   "8a2a1072375ffff", |
|   "8a2a10723767fff", |
|   "8a2a1072376ffff", |
|   "8a2a10723777fff"  |
| ]                    |
+----------------------+