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