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

H3_GRID_PATH¶

2つのセル間の線を表す H3 セルの IDs の配列を返します。返される ARRAY の IDs は、 INTEGER 値（ INTEGER 値が入力 IDs として提供された場合）、または16進数 IDs を含む VARCHAR 値（16進数 IDs が入力 IDs として提供された場合）です。

構文¶

H3_GRID_PATH( <cell_id_1> , <cell_id_2> )

引数¶

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

戻り値¶

cell_id_1 と cell_id_2 で指定されたセル間の線を表すH3セルの IDs の ARRAY を返します。IDs は次のいずれかの形式です。

cell_id_1 と cell_id_2 が INTEGER 値である場合、この関数は IDs を INTEGER の値として返します。
cell_id_1 と cell_id_2 が16進数 IDs を含む VARCHAR 値である場合、この関数は16進数 IDs を VARCHAR 値として返します。

使用上の注意¶

2つの入力セル IDs は同じ解像度を使用する必要があります。

例¶

次の例は、 IDs 617540519103561727 と 617540519052967935 （両方とも INTEGER 値として指定される）のセル間の線を表すH3セルの IDs の ARRAY を返します。

SELECT H3_GRID_PATH(617540519103561727, 617540519052967935);

+------------------------------------------------------+
| H3_GRID_PATH(617540519103561727, 617540519052967935) |
|------------------------------------------------------|
| [                                                    |
|   617540519103561727,                                |
|   617540519046414335,                                |
|   617540519047462911,                                |
|   617540519044055039,                                |
|   617540519045103615,                                |
|   617540519052967935                                 |
| ]                                                    |
+------------------------------------------------------+

次の例は、 IDs 891f1d48b93ffff と 891f1d4888fffff （両方とも VARCHAR 値として指定される）のセル間の線を表すH3セルの IDs の ARRAY を返します。

SELECT H3_GRID_PATH('891f1d48b93ffff', '891f1d4888fffff');

+----------------------------------------------------+
| H3_GRID_PATH('891F1D48B93FFFF', '891F1D4888FFFFF') |
|----------------------------------------------------|
| [                                                  |
|   "891f1d48b93ffff",                               |
|   "891f1d4882bffff",                               |
|   "891f1d4883bffff",                               |
|   "891f1d48807ffff",                               |
|   "891f1d48817ffff",                               |
|   "891f1d4888fffff"                                |
| ]                                                  |
+----------------------------------------------------+