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

H3_GRID_DISTANCE¶

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

構文¶

H3_GRID_DISTANCE( <cell_id_1> , <cell_id_2> )

引数¶

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

+----------------------------------------------------------+
| H3_GRID_DISTANCE(617540519103561727, 617540519052967935) |
|----------------------------------------------------------|
|                                                        5 |
+----------------------------------------------------------+

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

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

+--------------------------------------------------------+
| H3_GRID_DISTANCE('891F1D48B93FFFF', '891F1D4888FFFFF') |
|--------------------------------------------------------|
|                                                      5 |
+--------------------------------------------------------+