类别：

地理空间函数

H3_TRY_POLYGON_TO_CELLS

H3_POLYGON_TO_CELLS 的一个特殊版本，当它尝试返回 H3 单元格 IDs 的 INTEGER 值的 数组 时，如果出现错误，则返回 NULL，这些单元格的质心包含在 Polygon（由 GEOGRAPHY 对象指定）内。

语法

H3_TRY_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 值都会导致错误。

返回

返回 INTEGER 值或 NULL 的数组。

  • 如果函数能够成功执行计算，返回 H3 单元格的 IDs 的 INTEGER 值数组，H3 单元格的质心包含在指定的输入多边形内。

  • 如果函数无法执行成功的计算，则返回 NULL 而不报告错误。

使用说明

有关使用说明，请参阅 H3_POLYGON_TO_CELLS。

示例

下面的例子尝试返回 H3 单元格的 IDs 的 INTEGER 值数组，H3 单元格的质心包含在指定的输入多边形内（由 GEOGRAPHY 对象指定）。由于在给定分辨率下覆盖给定六边形的单元格数组超出了允许的大小限制，函数返回 NULL。

SELECT H3_TRY_POLYGON_TO_CELLS(
  TO_GEOGRAPHY('POLYGON((-108.959 40.948,
                         -109.015 37.077,
                         -102.117 36.956,
                         -102.134 40.953,
                         -108.959 40.948))'
              ), 15) AS h3_cells_in_polygon;
Copy
+---------------------+
| H3_CELLS_IN_POLYGON |
|---------------------|
| NULL                |
+---------------------+

有关成功返回 IDs 数组的示例，请参阅 H3_POLYGON_TO_CELLS。

语言: 中文