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

H3_TRY_COVERAGE¶

形状（GEOGRAPHY オブジェクトで指定）を完全にカバーする H3 セルの最小集合を特定する IDs の配列を（INTEGER 値として）返すことを試みたときにエラーが発生する場合は NULL を返す、 H3_COVERAGE の特別バージョン。

構文¶

H3_TRY_COVERAGE( <geography_expression> , <target_resolution> )

引数¶

geography_expression

GEOGRAPHY オブジェクトです。

target_resolution

0と15（0と15を含む）の間の INTEGER は、返されるH3セルに使用するH3 解像度を指定します。

それ以外の INTEGER 値を指定するとエラーになります。

戻り値¶

INTEGER 値の配列、または NULL を返します。

関数が正常に計算を実行できる場合は、指定された入力形状を完全にカバーするH3セルの最小集合の IDs に対する INTEGER 値の配列を返します。
この関数が正常に計算できない場合は、エラーを報告せずに NULL を返します。

使用上の注意¶

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

例¶

次の例は、形状（GEOGRAPHY オブジェクトで指定）を完全にカバーする H3 セルの最小集合を識別する IDs の配列を返そうとします。指定された解像度で指定された六角形をカバーするセルを含む配列は、許容されるサイズ制限を超えるため、この関数は NULL を返します。

SELECT H3_TRY_COVERAGE(
  TO_GEOGRAPHY('POLYGON((-108.959 40.948,
                         -109.015 37.077,
                         -102.117 36.956,
                         -102.134 40.953,
                         -108.959 40.948))'
              ), 15) AS set_of_h3_cells_covering_polygon;

+----------------------------------+
| SET_OF_H3_CELLS_COVERING_POLYGON |
|----------------------------------|
| NULL                             |
+----------------------------------+

IDs の配列を正常に返す例については、 H3_COVERAGE をご参照ください。