h3_tochildren
函數
適用於:磚的SQL磚運行時11.2及以上
返回一個數組輸入H3的孩子H3細胞細胞在指定的決議。
參數
h3CellIdExpr
:一個長整型數字表達式,或十六進製字符串表達式代表一個H3細胞ID。resolutionExpr
預計:INT表達式,其值之間h3_resolution (h3CellIdExpr)
和15
包容,指定的解決孩子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
小於h3_resolution (h3CellIdExpr)
或比15
,該函數返回H3_INVALID_RESOLUTION_VALUE。
例子
——簡單的例子隻要輸入。>選擇h3_tochildren(599686042433355775,6)(604189641121202175,604189641255419903,604189641389637631,604189641523855359,604189641658073087,604189641792290815,604189641926508543]——簡單的例子十六進製字符串作為輸入。>選擇h3_tochildren(“85283473 fffffff”,6)(862834707ffffff,86283470fffffff,862834717ffffff,86283471fffffff,862834727ffffff,86283472fffffff,862834737ffffff]——首先輸入一個無效的H3細胞ID。>選擇h3_tochildren(0,15)(H3_INVALID_CELL_ID]0是不一個有效的H3細胞ID——第二個輸入一個無效的分辨率值。>選擇h3_tochildren(“85283473 fffffff”,0)(H3_INVALID_RESOLUTION_VALUE]H3決議0必須是之間的5和15,包容