类别：: 地理空间函数

H3_POINT_TO_CELL¶

返回给定分辨率下某个点（由 GEOGRAPHY 对象指定）的 H3 单元格 ID 的 INTEGER 值。

另请参阅：: H3_POINT_TO_CELL_STRING、H3_CELL_TO_POINT

语法¶

H3_POINT_TO_CELL( <geography_point> , <target_resolution> )

实参¶

geography_point

表示一个点的 GEOGRAPHY 对象。

target_resolution

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

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

返回¶

返回与给定位置和分辨率的 H3 单元格 ID 相对应的 INTEGER 值。

示例¶

以下示例以分辨率 8 返回勃兰登堡门的 H3 单元格 ID。

SELECT H3_POINT_TO_CELL(ST_POINT(13.377704, 52.516262), 8);

+-----------------------------------------------------+
| H3_POINT_TO_CELL(ST_POINT(13.377704, 52.516262), 8) |
|-----------------------------------------------------|
|                                  613036919424548863 |
+-----------------------------------------------------+

下面的示例演示您不能指定 0 到 15 之外的分辨率。

SELECT H3_POINT_TO_CELL(ST_POINT(13.377704, 52.516262), 18);

100410 (P0000): Invalid H3 resolution value: 18. Resolution must be between 0 (coarsest) and 15 (finest).