h3_boundaryaswkt 機能

適用対象:チェックマーク:はい Databricks SQL チェック はい Databricks Runtime 11.3 LTS 以上 はい チェックマーク Lakehouse//RT

入力 H3 セルの多角形境界を WKT 形式で返します。

構文

h3_boundaryaswkt ( h3CellIdExpr )

引数

  • h3CellIdExpr: BIGINT式、またはH3セルIDを表す16進数STRING式。

戻り値

入力 H3 セルの多角形境界を WKT 形式で表す STRING 型の値。

入力式が NULL の場合、この関数は NULL を返します。 この関数は、入力引数が有効な H3 セル ID であるかどうかに関する部分的な検証を行います。 有効な H3 ID の必要条件 (ただし、十分条件ではない) は、その値が 0x08001fffffffffff と 0x08ff3b6db6db6db6 の間にあることです。 入力セル ID が有効なセル ID でない場合、関数の動作は未定義です。

エラー条件

  • h3CellIdExpr が BIGINT に変換できない STRING の場合、または、0x08001fffffffffff より小さいか 0x08ff3b6db6db6db6 より大きい BIGINT 値に対応する STRING の場合、関数は H3_INVALID_CELL_ID を返します。

例

-- Input a BIGINT representing a hexagonal cell.
> SELECT h3_boundaryaswkt(599686042433355775);
  POLYGON((-121.91508032706 37.271355866732,-121.86222328902 37.353926450852,-121.9235499963 37.428341186094,-122.03773496427 37.420128677678,-122.09042892904 37.337556084353,-122.02910130919 37.263197974618,-121.91508032706 37.271355866732))

-- Input a STRING representing a pentagonal cell.
> SELECT h3_boundaryaswkt('8009fffffffffff');
  POLYGON((-10.444977544778 63.095054077525,5.5236465492903 55.706768465152,25.082722326708 58.401544870353,31.831280499087 68.92995788194,0.32561035194326 73.310223685444,-10.444977544778 63.095054077525))

-- Input is an invalid H3 cell ID.
> SELECT h3_boundaryaswkt(0);
  [H3_INVALID_CELL_ID] 0 is not a valid H3 cell ID