カテゴリ：

地理空間関数

H3_TRY_POLYGON_TO_CELLS_STRINGS

ポリゴンに含まれる重心を持つ（GEOGRAPHY オブジェクトで指定） H3 セルの16進数 IDs の VARCHAR 値の 配列 を返すことを試みたときにエラーが発生した場合は NULL を返す、 H3_POLYGON_TO_CELLS_STRINGS の特別バージョン。

構文

H3_TRY_POLYGON_TO_CELLS_STRINGS( <geography_polygon> , <target_resolution> )
Copy

引数

geography_polygon

ポリゴンを表す GEOGRAPHY オブジェクト。

target_resolution

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

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

戻り値

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

  • 関数が正常に計算を実行できる場合は、指定された入力ポリゴンに含まれる重心を持つH3セルの16進数 IDs に対する VARCHAR 値の配列を返します。

  • この関数が正常に計算できない場合は、エラーを報告せずに NULL を返します。

使用上の注意

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

例

次の例は、ポリゴンに含まれる重心を持つ（GEOGRAPHY オブジェクトで指定） H3 セルの16進数 IDs の VARCHAR 値の配列を返そうとします。指定された解像度で指定された六角形をカバーするセルを含む配列は、許容されるサイズ制限を超えるため、この関数は NULL を返します。

SELECT H3_TRY_POLYGON_TO_CELLS_STRINGS(
  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 h3_cells_in_polygon;
Copy
+---------------------+
| H3_CELLS_IN_POLYGON |
|---------------------|
| NULL                |
+---------------------+

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

言語: 日本語