h3_longlatash3string
函式
適用於: Databricks SQL Databricks Runtime 11.3 LTS 和更新版本
傳回 H3 儲存格標識碼(以十六進位 STRING 形式,對應至指定解析度的經度和緯度。
語法
h3_longlatash3string ( longitudeExpr, latitudeExpr, resolutionExpr )
引數
longitudeExpr
:D OUBLE 表達式,代表我們想要計算之 H3 單元格標識碼所在位置的經度(以度為單位)。latitudeExpr
:D OUBLE 表達式,代表我們想要計算之 H3 單元格標識碼所在位置的緯度(以度為單位)。resolutionExpr
:INT 運算式,其值必須是介於 0 到 15 之間,並指定 H3 單元格標識碼的解析度。
傳回
STRING 類型的值,以十六進位字串表示指定解析度之輸入位置的 H3 單元格標識碼。
如果三個輸入表達式中的任何一個為 NULL,則此函式會傳回 NULL。
經度表達式以外的 [-180, 180]
值,以及 [-90, 90]
緯度表達式的值會對應至這些範圍內的對等專案。
經度和緯度值應該位於 WGS84 座標參考系統中。
錯誤條件
- 如果
resolutionExpr
小於或大於15
,則函式會傳回H3_INVALID_RESOLUTION_VALUE0
。
範例
-- 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