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

H3_TRY_GRID_PATH¶

2つのセル間の線を表す H3 セルの IDs を含む VARIANT 値の配列を返すことを試みたときにエラーが発生した場合は NULL を返す、 H3_GRID_PATH の特別バージョン。

構文¶

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

戻り値¶

ARRAY データ型または NULL の値を返します。

この関数が正常に計算を実行できる場合は、 cell_id_1 と cell_id_2 で指定されたセル間の線を表すH3セルの IDs を含む VARIANT 値の配列を返します。IDs の形式については、 H3_GRID_PATH をご参照ください。
線が計算できない場合（例: 2つのセルが隣接しないベースセルに属する場合）は、エラーを報告せずに NULL を返します。

使用上の注意¶

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

例¶

以下の例では、2つのセル間の線を返そうとしています。セルは隣接しないベースセルに属するため、この関数は線を返すことができず、 NULL を返します。

SELECT H3_TRY_GRID_PATH('813d7ffffffffff', '81343ffffffffff');

Copy

+--------------------------------------------------------+
| H3_TRY_GRID_PATH('813D7FFFFFFFFFF', '81343FFFFFFFFFF') |
|--------------------------------------------------------|
| NULL                                                   |
+--------------------------------------------------------+

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