カテゴリ:

地理空間関数

H3_UNCOMPACT_CELLS_STRINGS

入力で、H3セルと同じ領域をカバーする、指定された解像度の H3 セルの VARCHAR 16進数 IDs を含む VARIANT 値の 配列 を返します。

構文

H3_UNCOMPACT_CELLS_STRINGS( <array_of_cell_ids> , <target_resolution> )
Copy

引数

array_of_cell_ids

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

target_resolution

0と15(0と15を含む)の間の INTEGER 値は、返されるH3セルに使用するH3 解像度 を指定します。

それ以外の INTEGER 値を指定するとエラーになります。

戻り値

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

  • 入力が VARCHAR 16進値を含む VARIANT 値の配列である場合は、指定された解像度でH3セルのセットを表す VARCHAR 16進値を含む VARIANT 値の配列を返します。

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

使用上の注意

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

  • 入力セルは、 target_resolution 引数で指定された解像度よりも高い解像度を持つことはできません。

以下の例では、有効なH3セル IDs と、 10 のターゲット解像度を表すH3セルの非圧縮セットを返します。

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