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 坐标参考系统中。
错误条件
- 如果
resolutionExpr
小于0
或大于15
,则该函数返回 H3_INVALID_RESOLUTION_VALUE。
示例
-- 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