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

H3_COVERAGE¶

形状（ GEOGRAPHY オブジェクトで指定された）を完全にカバーする H3 セルの最小集合を特定する IDs の ARRAY を返します（ INTEGER 値として）。

こちらもご参照ください。: H3_COVERAGE_STRINGS , H3_POLYGON_TO_CELLS

構文¶

H3_COVERAGE( <geography_expression> , <target_resolution> )

Copy

引数¶

geography_expression

GEOGRAPHY オブジェクトです。

target_resolution

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

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

戻り値¶

指定された入力形状を完全にカバーするH3セルの最小集合の IDs の INTEGER 値の ARRAY を返します。

使用上の注意¶

この関数は球面近似を使用しており、地表上の点を直線ではなく円弧で結ばれているかのように扱います。平面近似が必要な場合は、代わりに H3_POLYGON_TO_CELLS を使用します。
セルは、その境界が入力形状と交差していれば、結果セットに含まれます。
関数が返す ARRAY に FLATTEN を適用すると、各値が明示的に整数にキャストされます。

例¶

次の例は、指定されたポリゴンを完全にカバーするH3セルの最小集合を特定する IDs の ARRAY を返します。

SELECT H3_COVERAGE(
  TO_GEOGRAPHY(
    'POLYGON((-122.481889 37.826683,-122.479487 37.808548,-122.474150 37.808904,-122.476510 37.826935,-122.481889 37.826683))'),
  8) AS set_of_h3_cells_covering_polygon;

Copy

+----------------------------------+
| SET_OF_H3_CELLS_COVERING_POLYGON |
|----------------------------------|
| [                                |
|   613196571542028287,            |
|   613196571548319743,            |
|   613196571598651391,            |
|   613196571539931135,            |
|   613196571560902655,            |
|   613196571550416895             |
| ]                                |
+----------------------------------+