カテゴリ：

地理空間関数

H3_GRID_DISK

指定されたセルからk-distance内にある H3 セルの IDs の 配列 を返します。返される ARRAY の IDs は、 INTEGER 値（入力 ID として INTEGER 値が提供された場合）、または16進数 IDs を含む VARCHAR 値（入力 ID として16進数 ID が提供された場合）です。

構文

H3_GRID_DISK( <cell_id> , <k_value> )

引数

cell_id

H3セル ID （インデックス）を表す INTEGER、またはセル ID を16進数形式で表す VARCHAR。

k_value

グリッド距離を表す INTEGER。負でない値を指定する必要があります。

戻り値

H3セルの ARRAY のうち、 cell_id で指定されたセルから k_value 以内の距離にある IDs を返します。IDs は次のいずれかの形式です。

  • cell_id が INTEGER 値の場合、この関数は IDs を INTEGER 値として返します。

  • cell_id が16進数 ID を含む VARCHAR 値の場合、関数は16進数 IDs を VARCHAR 値として返します。

例

次の例は、 ID 617540519050084351 （ INTEGER 値として指定）を持つセルから1のグリッド距離内にあるH3セルの IDs の ARRAY を返します。

SELECT H3_GRID_DISK(617540519050084351, 1);

+-------------------------------------+
| H3_GRID_DISK(617540519050084351, 1) |
|-------------------------------------|
| [                                   |
|   617540519050084351,               |
|   617540519051657215,               |
|   617540519050608639,               |
|   617540519050870783,               |
|   617540519050346495,               |
|   617540519051395071,               |
|   617540519051132927                |
| ]                                   |
+-------------------------------------+

次の例は、 ID 891f1d48863ffff （ VARCHAR 値として指定）を持つセルから1のグリッド距離内にあるH3セルの IDs の ARRAY を返します。

SELECT H3_GRID_DISK('891f1d48863ffff', 1);

+------------------------------------+
| H3_GRID_DISK('891F1D48863FFFF', 1) |
|------------------------------------|
| [                                  |
|   "891f1d48863ffff",               |
|   "891f1d4887bffff",               |
|   "891f1d4886bffff",               |
|   "891f1d4886fffff",               |
|   "891f1d48867ffff",               |
|   "891f1d48877ffff",               |
|   "891f1d48873ffff"                |
| ]                                  |
+------------------------------------+