类别:

地理空间函数

H3_UNCOMPACT_CELLS_STRINGS

返回 VARIANT 值数组,其中包含指定分辨率下 H3 单元格的 VARCHAR 十六进制 IDs,其覆盖区域与输入中的 H3 单元格相同。

语法

H3_UNCOMPACT_CELLS_STRINGS( <array_of_cell_ids> , <target_resolution> )
Copy

实参

array_of_cell_ids

一个 VARIANT 值数组,包含表示 H3 单元格 IDs (索引 (https://h3geo.org/docs/core-library/h3Indexing)) 的 VARCHAR 十六进制值。

target_resolution

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

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

返回

返回 ARRAY 数据类型的值或 NULL。

  • 如果输入是一个包含 VARCHAR 十六进制值的 VARIANT 值数组,则返回一个包含 VARCHAR 值的 VARIANT 十六进制值数组,该数组表示指定分辨率下的 H3 单元格集合。

  • 如果输入为 NULL,则返回 NULL,不报错。

使用说明

  • 输入中的所有 VARCHAR 十六进制值都必须代表有效的 H3 单元格。

  • 输入单元格的分辨率不能高于 target_resolution 实参中指定的分辨率。

示例

下面的示例将返回一组未压缩的 H3 单元格集合,这些单元格代表有效的 H3 单元格 IDs,目标分辨率为 10

SELECT H3_UNCOMPACT_CELLS_STRINGS(
  [
    '8a2a1072339ffff',
    '892a1072377ffff'
  ],
  10
) AS uncompacted;
Copy
+----------------------+
| UNCOMPACTED          |
|----------------------|
| [                    |
|   "8a2a1072339ffff", |
|   "8a2a10723747fff", |
|   "8a2a1072374ffff", |
|   "8a2a10723757fff", |
|   "8a2a1072375ffff", |
|   "8a2a10723767fff", |
|   "8a2a1072376ffff", |
|   "8a2a10723777fff"  |
| ]                    |
+----------------------+
语言: 中文