Kategorien:

Geodatenfunktionen

H3_COMPACT_CELLS_STRINGS

Gibt ein Array von VARIANT-Werten zurück, die die hexadezimalen VARCHAR-IDs von weniger, größeren H3-Zellen enthalten, die denselben Bereich abdecken wie die H3-Zellen in der Eingabe. Informationen zu komprimierten Zellen finden Sie unter Indizierung.

Syntax

H3_COMPACT_CELLS_STRINGS( <array_of_cell_ids> )
Copy

Argumente

array_of_cell_ids

Ein Array mit VARIANT-Werten, die die hexadezimalen VARCHAR-Werte enthalten, die die H3-Zellen-IDs repräsentieren (Indizes).

Rückgabewerte

Gibt einen Wert vom Datentyp ARRAY oder NULL zurück.

  • Wenn die Eingabe ein Array mit hexadezimalen VARCHAR-Werten ist, wird ein Array zurückgegeben, das aus VARIANT-Werten besteht, die eine komprimierte Menge von H3-Zellen darstellen. Die VARIANT-Werte enthalten die hexadezimalen VARCHAR-Werte, die die H3-Zellen-IDs 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.

  • Alle H3-Zellen in der Eingabe müssen die gleiche Auflösung haben.

  • Die H3-Zellen in der Eingabe müssen eindeutige Bereiche abdecken, ohne sich zu überschneiden. Doppelte H3-Zellen sind nicht zulässig.

Beispiele

Das folgende Beispiel komprimiert eine Menge von H3-Zellen und gibt Zellen mit einer geringeren Auflösung zurück, die denselben Bereich repräsentieren.

SELECT H3_COMPACT_CELLS_STRINGS(
  [
    '8a2a10705507fff',
    '8a2a1070550ffff',
    '8a2a10705517fff',
    '8a2a1070551ffff',
    '8a2a10705527fff',
    '8a2a1070552ffff',
    '8a2a10705537fff',
    '8a2a10705cdffff'
    ]
  ) AS compacted;
Copy
+----------------------+
| COMPACTED            |
|----------------------|
| [                    |
|   "8a2a10705cdffff", |
|   "892a1070553ffff"  |
| ]                    |
+----------------------+