h3_boundaryaswkt 関数

  • [アーティクル]

適用対象: check marked yes Databricks SQL Databricks Runtime 11.3 LTS 以降

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

構文

h3_boundaryaswkt ( h3CellIdExpr )

引数

  • h3CellIdExpr: H3 セル ID を表す BIGINT 式または 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