- カテゴリ:
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
と 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" | | ] | +----------------------------------------------------+