h3_try_polyfillash3string函式

適用於：已勾選 Databricks SQL 已勾選 Databricks Runtime 11.3 LTS 以上

行為與 h3_polyfillash3string 相同，但若第一個參數無效，則回傳 該 NULL 參數而非錯誤。 更精確地說，回傳 H3 ARRAY 單元 ID（表示為 STRING），對應於指定解析度的六邊形或五邊形，其重心包含於輸入的區域地理中。

語法

h3_try_polyfillash3string ( geographyExpr, resolutionExpr )

引數

  • geographyExpr： A BINARY 或 STRING 表達式，代表 WKB、 WKT 或 GeoJSON 中的區域地理（多邊形或多邊形）。 地理位置應具有基於 WGS84 座標參考系統的經度和緯度座標。
  • resolutionExpr：一個 INT 表達式，其值預期介於 0 與 15 包容之間，指定H3單元格的解析度。

退貨

一個ARRAYSTRING對應於指定解析度H3格子ID的值，其重心包含於輸入的區域地理中。

如果任何輸入表示式為 NULL，則函式會傳NULL回 。 若第一個輸入參數型為 BINARY，則輸入值預期為多邊形或多邊形的 WKB 描述。 若第一個輸入參數型別為 STRING，輸入值預期為多邊形或多邊形的 WKT 或 GeoJSON 描述。 輸入多邊形或多多邊形的維度可以是 2D、3DZ、3DM 或 4D。 若第一個參數對應無效的 NULL、WKT 或 GeoJSON，或不代表多邊形或多邊形，則該函式會回傳。

錯誤條件

範例

-- Simple example where the input is a triangle in WKT format.
> SELECT h3_try_polyfillash3string('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-122.4194 37.7749))', 2);
  [82268ffffffffff,82269ffffffffff,822987fffffffff,8226e7fffffffff,822997fffffffff,8226f7fffffffff,822657fffffffff,8229affffffffff]

-- Simple example where the input is a triangle in hexadecimal WKB format.
> SELECT h3_try_polyfillash3string(unhex('0103000000010000000400000050fc1873d79a5ec0d0d556ec2fe342404182e2c7988f5dc0f46c567dae064140aaf1d24d628052c05e4bc8073d5b444050fc1873d79a5ec0d0d556ec2fe34240'), 2);
  [82268ffffffffff,82269ffffffffff,822987fffffffff,8226e7fffffffff,822997fffffffff,8226f7fffffffff,822657fffffffff,8229affffffffff]

-- The input is invalid.
> SELECT h3_try_polyfillash3string('Not-a-valid-rep', 2);
  null

-- Resolution is out of range.
> SELECT h3_try_polyfillash3string('POLYGON((-122.4194 37.7749,-118.2437 34.0522,-74.0060 40.7128,-122.4194 37.7749))', 16);
  [H3_INVALID_RESOLUTION_VALUE] H3 resolution 16 must be between 0 and 15, inclusive
  • Last updated on