カテゴリ：

地理空間関数

H3_COVERAGE_STRINGS

形状（GEOGRAPHY オブジェクトで指定）を完全にカバーする H3 セルの最小集合を特定する16進数 IDs の 配列 を（VARCHAR 値として）返します。

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

H3_COVERAGE , H3_POLYGON_TO_CELLS_STRINGS

構文

H3_COVERAGE_STRINGS( <geography_expression> , <target_resolution> )

引数

geography_expression

GEOGRAPHY オブジェクトです。

target_resolution

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

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

戻り値

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

使用上の注意

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

  • セルは、その境界が入力形状と交差していれば、結果セットに含まれます。

例

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

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

+----------------------------------+
| SET_OF_H3_CELLS_COVERING_POLYGON |
|----------------------------------|
| [                                |
|   "882830870bfffff",             |
|   "8828308703fffff",             |
|   "8828308739fffff",             |
|   "8828308709fffff",             |
|   "8828308701fffff",             |
|   "8828308715fffff"              |
| ]                                |
|----------------------------------|