適用対象:
Databricks SQL
Databricks Runtime 11.3 LTS 以降
指定した解像度で指定された経度と緯度に対応する H3 セル ID (16 進数の STRING) を返します。
構文
h3_longlatash3string ( longitudeExpr, latitudeExpr, resolutionExpr )
引数
-
longitudeExpr: H3 セル ID を計算する場所の経度 (度単位) を表すDOUBLE式。 -
latitudeExpr: H3 セル ID を計算する場所の緯度 (度単位) を表すDOUBLE式。 -
resolutionExpr:INT式。値は 0 ~ 15 の範囲で、H3 セル ID の解像度を指定します。
戻り値
指定した解像度での入力位置の H3 セル ID を 16 進数の文字列として表す STRING の型の値。
この関数は、3 つの入力式のいずれかが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