カテゴリ：

地理空間関数

H3_POLYGON_TO_CELLS_STRINGS

ポリゴンに含まれる重心を持つ（GEOGRAPHY オブジェクトで指定） H3 セルの16進数 IDs の VARCHAR 値の 配列 を返します。

こちらもご参照ください。

H3_POLYGON_TO_CELLS_STRINGS , H3_COVERAGE_STRINGS

構文

H3_POLYGON_TO_CELLS_STRINGS( <geography_polygon> , <target_resolution> )

引数

geography_polygon

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

target_resolution

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

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

戻り値

指定された入力ポリゴンに含まれる重心を持つH3セルの16進数 IDs に対する VARCHAR 値の配列を返します。

使用上の注意

  • この関数は平面近似を使用しており、地表上の点を曲線の円弧ではなく直線で結ばれているかのように扱います。球面近似が必要な場合は、代わりに H3_COVERAGE_STRINGS を使用します。

  • セルの重心がポリゴンに含まれる場合、そのセルはポリゴン内にあるとみなされます。

例

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

SELECT H3_POLYGON_TO_CELLS_STRINGS(
  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;

+----------------------+
| H3_CELLS_IN_POLYGON  |
|----------------------|
| [                    |
|   "8928308715bffff", |
|   "89283087397ffff", |
|   "89283087023ffff", |
|   "892830870abffff", |
|   "89283087027ffff", |
|   "89283087033ffff", |
|   "8928308702fffff", |
|   "892830870bbffff", |
|   "89283087037ffff"  |
| ]                    |
+----------------------+