カテゴリ:

地理空間関数

H3_COMPACT_CELLS

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

構文

H3_COMPACT_CELLS( <array_of_cell_ids> )
Copy

引数

array_of_cell_ids

H3セル IDs (インデックス)を表す INTEGER 値を含む VARIANT 値の配列。

戻り値

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

  • 入力が INTEGER 値の配列の場合は、H3セルの圧縮されたセットを表す VARIANT 値からなる配列を返します。VARIANT 値には、H3セル IDs を表す INTEGER 値が含まれます。

  • 入力が NULL の場合は、エラーを報告せずに NULL を返します。

使用上の注意

  • 入力の INTEGER 値はすべて有効なH3セルを表している必要があります。

  • 入力のH3セルはすべて同じ解像度にする必要があります。

  • 入力のH3セルは、重複することなく一意の領域をカバーする必要があります。H3セルの重複は許可されません。

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

SELECT H3_COMPACT_CELLS(
  [
    622236750562230271,
    622236750562263039,
    622236750562295807,
    622236750562328575,
    622236750562361343,
    622236750562394111,
    622236750562426879,
    622236750558396415
  ]
) AS compacted;
Copy
+-----------------------+
| COMPACTED             |
|-----------------------|
| [                     |
|   622236750558396415, |
|   617733150935089151  |
| ]                     |
+-----------------------+