h3_uncompact函數

適用於:檢查標記是的磚的SQL檢查標記是的磚運行時11.2及以上

Uncompacts H3細胞的輸入設置指定的決議。未壓實的集覆蓋相同的H3細胞與原始使用細胞在指定的決議。

語法

h3_uncompact(h3CellIdsExpr,resolutionExpr)

參數

  • h3CellIdsExpr:長整型數字表達的一個數組或數組的十六進製字符串表達式代表一個H3細胞id數組。

  • resolutionExpr:一個整數表達式,其值是將輸入的最大分辨率H3細胞之間15包容,指定H3細胞IDs的分辨率輸出數組。

返回

相同類型的值的數組作為輸入數組中的值表達式h3cellIdsExpr。H3細胞IDs的分辨率輸出數組的值等於resolutionExpr。

函數返回NULL如果輸入為空。函數部分驗證關於輸入參數是否有效的H3細胞ID,必要但不充分條件之間的有效的H3 ID,它的價值是0 x08001fffffffffff和0 x08ff3b6db6db6db6。函數定義的行為如果任何細胞的ID在輸入數組並不是一個有效的細胞ID。NULL值在輸入數組將被忽略。

錯誤條件

  • 如果h3CellIdExpr是一個字符串,不能轉換為長整型數字或對應於一個長整型數字值小於0 x08001fffffffffff或比0 x08ff3b6db6db6db6,該函數返回H3_INVALID_CELL_ID。

  • 如果resolutionExpr小於最大分辨率的H3細胞在輸入數組,或者比15,該函數返回H3_INVALID_RESOLUTION_VALUE。

例子

——例子輸入是一個長整型數字數組>選擇h3_uncompact(數組(599686030622195711,599686015589810175,599686014516068351,599686034917163007,599686029548453887,599686032769679359,599686198125920255,599686023106002943,599686027400970239,599686013442326527,599686012368584703,599686018811035647,595182446027210751),5);(599686030622195711,599686015589810175,599686014516068351,599686034917163007,599686029548453887,599686032769679359,599686198125920255,599686023106002943,599686027400970239,599686013442326527,599686012368584703,599686018811035647,599686038138388479,599686039212130303,599686040285872127,599686041359613951,599686042433355775,599686043507097599,599686044580839423]——在這個例子中,我們驗證uncompacting壓實的H3的雙環細胞在細胞的決議返回原來的雙環。>選擇數(*)從((選擇爆炸(h3_uncompact(h3_compact(h3_kring(599686042433355775,2)),h3_resolution(599686042433355775))))-(選擇爆炸(h3_kring(599686042433355775,2))))0——第二個輸入一個無效的分辨率值。>選擇h3_uncompact(數組(599686030622195711,599686015589810175,599686014516068351,599686034917163007,599686029548453887,599686032769679359,599686198125920255,599686023106002943,599686027400970239,599686013442326527,599686012368584703,599686018811035647,595182446027210751),2);(H3_INVALID_RESOLUTION_VALUE]H3決議2必須是之間的5和15,包容