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

H3_POLYGON_TO_CELLS¶

ポリゴンに含まれる重心を持つ（ GEOGRAPHY オブジェクトで指定された） H3 セルの IDs の INTEGER 値の ARRAY を返します。

こちらもご参照ください。: H3_POLYGON_TO_CELLS_STRINGS , H3_COVERAGE

構文¶

H3_POLYGON_TO_CELLS( <geography_polygon> , <target_resolution> )

Copy

引数¶

geography_polygon

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

target_resolution

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

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

戻り値¶

指定された入力ポリゴンに含まれる重心を持つH3セルの IDs の INTEGER 値の ARRAY を返します。

使用上の注意¶

この関数は平面近似を使用しており、地表上の点を曲線の円弧ではなく直線で結ばれているかのように扱います。球面近似が必要な場合は、代わりに H3_COVERAGE を使用します。
セルの重心がポリゴンに含まれる場合、そのセルはポリゴン内にあるとみなされます。
関数が返す ARRAY に FLATTEN を適用すると、各値が明示的に整数にキャストされます。

例¶

次の例は、指定されたポリゴンに含まれる重心を持つH3セルの IDs の ARRAY を返します。

SELECT H3_POLYGON_TO_CELLS(
  TO_GEOGRAPHY(
    'POLYGON((-122.481889 37.826683,-122.479487 37.808548,-122.474150 37.808904,-122.476510 37.826935,-122.481889 37.826683))'
  ),
  9) AS h3_cells_in_polygon;

Copy

+-----------------------+
| H3_CELLS_IN_POLYGON   |
|-----------------------|
| [                     |
|   617700171176476671, |
|   617700171168874495, |
|   617700171177525247, |
|   617700171167563775, |
|   617700171225497599, |
|   617700171188011007, |
|   617700171168350207, |
|   617700171168612351, |
|   617700171167825919  |
| ]                     |
+-----------------------+