h3_longlatash3 函数

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

返回对应于指定分辨率下提供的经纬度的 H3 单元格 ID(表示为 BIGINT)。

语法

h3_longlatash3 ( longitudeExpr, latitudeExpr, resolutionExpr )

参数

  • longitudeExpr:一个 DOUBLE 表达式,表示要计算其 H3 单元格 ID 的位置的经度(以度为单位)。
  • latitudeExpr:一个 DOUBLE 表达式,表示要计算其 H3 单元格 ID 的位置的纬度(以度为单位)。
  • resolutionExpr:一个 INT 表达式,其值应介于 0 到 15 之间(含),它指定 H3 单元格 ID 的分辨率。

返回

BIGINT 类型的值,表示指定分辨率下输入位置的 H3 单元格 ID。

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

错误条件

示例

-- Simple example.
> SELECT h3_longlatash3(100, 45, 6)
  604116085645508607

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

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