カテゴリ：: 地理空間関数

H3_COMPACT_CELLS_STRINGS¶

入力で、H3セルと同じ領域をカバーする、より少数で、より大きな H3 セルの VARCHAR 16進数 IDs を含む VARIANT 値の配列を返します。圧縮されたセルについては、インデックス作成をご参照ください。

構文¶

H3_COMPACT_CELLS_STRINGS( <array_of_cell_ids> )

Copy

引数¶

array_of_cell_ids: H3セル IDs （インデックス）を表す VARCHAR 16進値を含む VARIANT 値の配列。

戻り値¶

ARRAY データ型または NULL の値を返します。

入力が VARCHAR 16進値の配列の場合は、H3セルの圧縮されたセットを表す VARIANT 値からなる配列を返します。VARIANT 値には、H3セル IDs を表す VARCHAR 16進値が含まれています。
入力が NULL の場合は、エラーを報告せずに NULL を返します。

使用上の注意¶

入力の VARCHAR 16進値はすべて有効なH3セルを表している必要があります。
入力のH3セルはすべて同じ解像度にする必要があります。
入力のH3セルは、重複することなく一意の領域をカバーする必要があります。H3セルの重複は許可されません。

例¶

次の例は、H3セルのセットを圧縮し、同じ領域を表す低い解像度のセルを返します。

SELECT H3_COMPACT_CELLS_STRINGS(
  [
    '8a2a10705507fff',
    '8a2a1070550ffff',
    '8a2a10705517fff',
    '8a2a1070551ffff',
    '8a2a10705527fff',
    '8a2a1070552ffff',
    '8a2a10705537fff',
    '8a2a10705cdffff'
    ]
  ) AS compacted;

Copy

+----------------------+
| COMPACTED            |
|----------------------|
| [                    |
|   "8a2a10705cdffff", |
|   "892a1070553ffff"  |
| ]                    |
+----------------------+