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

H3_TRY_GRID_DISTANCE¶

H3 の2つのセル間の距離を返すことを試みたときにエラーが発生した場合は NULL を返す、 H3_GRID_DISTANCE の特別バージョン。

構文¶

H3_TRY_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 値。

戻り値¶

INTEGER 値または NULL を返します。

関数が正常に計算を実行できた場合は、2つのH3セル間のグリッドセル単位で距離を表す INTEGER 値を返します。
グリッド距離が計算できない場合（例: 2つのセルが隣接しないベースセルに属する場合）は、エラーを報告せずに NULL を返します。

使用上の注意¶

使用上の注意については、 H3_GRID_DISTANCE をご参照ください。

例¶

以下の例では、2つのセル間の距離を計算しようとしています。セルは隣接しないベースセルに属するため、この関数は距離の計算に失敗し、 NULL を返します。

SELECT H3_TRY_GRID_DISTANCE(582046271372525567, 581883543651614719);

Copy

+--------------------------------------------------------------+
| H3_TRY_GRID_DISTANCE(582046271372525567, 581883543651614719) |
|--------------------------------------------------------------|
|                                                         NULL |
+--------------------------------------------------------------+

2つのH3セル間の距離を正常に計算する例については、 H3_GRID_DISTANCE をご参照ください。