类别：

地理空间函数

H3_TRY_POLYGON_TO_CELLS_STRINGS

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

语法

H3_TRY_POLYGON_TO_CELLS_STRINGS( <geography_polygon> , <target_resolution> )
Copy

实参

geography_polygon

表示多边形的 GEOGRAPHY 对象。

target_resolution

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

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

返回

返回 VARCHAR 值或 NULL 的数组。

  • 如果函数计算成功，则返回一个 H3 单元格的十六进制 IDs 的 VARCHAR 值的数组，这些单元格的质点包含在指定的输入多边形中。

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

使用说明

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

示例

以下示例会尝试返回一个数组，其中包含多边形（由 GEOGRAPHY 对象指定）质点的 H3 单元格的十六进制 IDs 的 VARCHAR 值。由于在给定分辨率下覆盖给定六边形的单元格数组超出了允许的大小限制，函数返回 NULL。

SELECT H3_TRY_POLYGON_TO_CELLS_STRINGS(
  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_STRINGS。

语言: 中文