カテゴリ:

地理空間関数

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> ) 
Copy

引数

cell_id_1

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

cell_id_2

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

戻り値

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

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

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

使用上の注意

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

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

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

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

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