类别：: 地理空间函数

H3_TRY_COVERAGE_STRINGS¶

H3_COVERAGE_STRINGS 的一个特殊版本，当它试图返回十六进制 IDs 的数组对象指定）的 H3 单元格的最小集合。

语法¶

H3_TRY_COVERAGE_STRINGS( <geography_expression> , <target_resolution> )

实参¶

geography_expression

GEOGRAPHY 对象。

target_resolution

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

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

返回¶

返回 VARCHAR 值或 NULL 的数组。

如果该函数可以成功执行计算，则返回完全覆盖指定输入形状的最小 H3 单元格集的十六进制 IDs 的 VARCHAR 值数组。
如果函数无法执行成功的计算，则返回 NULL 而不报告错误。

使用说明¶

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

示例¶

以下示例尝试返回一个 IDs 数组，该数组标识完全覆盖某个形状（由 GEOGRAPHY 对象指定）的:ref:H3 <label-data_types_geospatial_h3> 单元格的最小集合。由于在给定分辨率下覆盖给定六边形的单元格数组超出了允许的大小限制，函数返回 NULL。

SELECT H3_TRY_COVERAGE_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 set_of_h3_cells_covering_polygon;

+----------------------------------+
| SET_OF_H3_CELLS_COVERING_POLYGON |
|----------------------------------|
| NULL                             |
+----------------------------------+

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