h3_toparent函數

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

返回父H3細胞輸入H3的細胞在指定的決議。

語法

h3_toparent(h3cellIdExpr,resolutionExpr)

參數

  • h3CellIdExpr:一個長整型數字表達式,或十六進製字符串表達式代表一個H3細胞ID。

  • resolutionExpr預計:INT表達式,其值之間0和h3_resolution (h3CellIdExpr)包容,指定父H3細胞ID的解決。

返回

相同類型的值的類型h3CellIdExpr表情,對應於輸入的父H3細胞ID H3細胞在指定的決議。

該函數返回NULL如果任何兩個輸入表達式是NULL。函數部分驗證關於輸入參數是否有效的H3細胞ID,必要但不充分條件之間的有效的H3 ID,它的價值是0 x08001fffffffffff和0 x08ff3b6db6db6db6。函數定義的行為如果輸入細胞ID不是一個有效的細胞ID。如果的價值resolutionExpr等於輸入的決議H3細胞ID、輸入H3細胞返回ID。

錯誤條件

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

  • 如果resolutionExpr小於0或比h3_resolution (h3CellIdExpr),該函數返回H3_INVALID_RESOLUTION_VALUE。

例子

——簡單的例子隻要輸入。>選擇h3_toparent(599686042433355775,0)577199624117288959——簡單的例子有效的十六進製字符串作為輸入。>選擇h3_toparent(“85283473 fffffff”,0)8029年fffffffffff——首先輸入一個無效的H3細胞ID。>選擇h3_toparent(0,0)(H3_INVALID_CELL_ID]0是不一個有效的H3細胞ID——第二個輸入一個無效的分辨率值。>選擇h3_toparent(“85283473 fffffff”,- - - - - -1)(H3_INVALID_RESOLUTION_VALUE]H3決議- - - - - -1必須是之間的0和5,包容