使用英语阅读

通过

h3_longlatash3string 函数

  • 2025/07/18

适用于：勾选“是” Databricks SQL 勾选“是” Databricks Runtime 11.3 LTS 及更高版本

返回对应于指定分辨率下提供的经纬度的 H3 单元格 ID（表示为十六进制 STRING）。

语法

h3_longlatash3string ( longitudeExpr, latitudeExpr, resolutionExpr )

参数

  • longitudeExpr：一个 DOUBLE 表达式，表示我们想要计算其 H3 单元 ID 位置的经度（以度为单位）。
  • latitudeExpr：一个 DOUBLE 表达式，表示我们想要计算其 H3 单元 ID 位置的纬度（以度为单位）。
  • resolutionExpr：一个 INT 表达式，其值应介于 0 和 15 之间，用于确定 H3 单元格 ID 的分辨率。

返回

STRING 类型的值，以十六进制字符串表示输入位置在指定分辨率下的 H3 单元 ID。

如果三个输入表达式中的任何一个为 NULL，则函数返回 NULL 。 [-180, 180]（对于经度表达式）和 [-90, 90]（对于纬度表达式）以外的值映射到它们在这些范围内的等效值。 经度和纬度值应在 WGS84 坐标参考系统中。

错误条件

示例

-- Simple example.
> SELECT h3_longlatash3string(100, 45, 6)
  86240610fffffff

-- The H3 cell ID for the Golden Gate Bridge at resolution 13.
> SELECT h3_longlatash3string(-122.4783, 37.8199, 13)
  8d283087022a93f

-- Resolution is out of range.
> SELECT h3_longlatash3string(-122.4783, 37.8199, 16)
  [H3_INVALID_RESOLUTION_VALUE] H3 resolution 16 must be between 0 and 15, inclusive