类别：

地理空间函数

H3_POLYGON_TO_CELLS

返回 H3 单元格 IDs 的 INTEGER 值的 ARRAY，这些单元格的质心包含在 Polygon（由 GEOGRAPHY 对象指定）内。

另请参阅：

H3_POLYGON_TO_CELLS_STRINGS、H3_COVERAGE

语法

H3_POLYGON_TO_CELLS( <geography_polygon> , <target_resolution> )
Copy

实参

geography_polygon

表示多边形的 GEOGRAPHY 对象。

target_resolution

介于 0 和 15 之间（含）的 INTEGER，指定要用于返回的 H3 单元格的 H3 分辨率 (https://h3geo.org/docs/core-library/restable)。

指定其他任何 INTEGER 值都会导致错误。

返回

返回 H3 单元格 IDs 的 INTEGER 值 ARRAY，H3 单元格的质心包含在指定的输入多边形内。

使用说明

  • 该函数使用平面近似法，此方法将地球表面上的点视为由直线连接，而不是弯曲的弧线。如果需要使用球面近似法，请改用 H3_COVERAGE。

  • 如果单元格的质心包含在多边形内，则认为该单元格位于多边形内。

  • 将 FLATTEN 应用于函数返回的 ARRAY 时，将每个值显式 转换 为整数。

示例

以下示例返回 H3 单元格 IDs 的 ARRAY，H3 单元格的质心包含在指定的多边形中。

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  |
| ]                     |
+-----------------------+
语言: 中文