カテゴリ:

地理空間関数

H3_GRID_DISTANCE

2つの H3 セルの IDs で指定されたセル間の距離を返します。

構文

H3_GRID_DISTANCE( <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。

戻り値

2つのH3セル間のグリッドセル単位での距離を表す INTEGER 値を返します。

使用上の注意

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

次の例は、2つのH3セル間の距離を(グリッドセル数で)返します。この例では、H3セル IDs を INTEGER 値として指定しています。

SELECT H3_GRID_DISTANCE(617540519103561727, 617540519052967935);
Copy
+----------------------------------------------------------+
| H3_GRID_DISTANCE(617540519103561727, 617540519052967935) |
|----------------------------------------------------------|
|                                                        5 |
+----------------------------------------------------------+

次の例では、H3セル IDs の16進値を VARCHAR 値として指定しています。

SELECT H3_GRID_DISTANCE('891f1d48b93ffff', '891f1d4888fffff');
Copy
+--------------------------------------------------------+
| H3_GRID_DISTANCE('891F1D48B93FFFF', '891F1D4888FFFFF') |
|--------------------------------------------------------|
|                                                      5 |
+--------------------------------------------------------+