h3_kring函數

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

返回H3細胞內(網格)的距離k細胞的起源。這些H3細胞稱為集k撕咬的起源細胞。

語法

h3_kring(h3CellIdExpr,kExpr)

參數

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

  • kExpr:一個整數表達式代表網格距離。kExpr必須是非負數。

返回

相同類型的數組的值的類型h3CellIdExpr表情,H3細胞對應相同的id,決議作為輸入H3細胞內網格的距離k輸入H3的細胞,在那裏k的價值嗎kExpr。

函數返回NULL如果任何一個輸入的表達式是NULL。函數部分驗證關於輸入參數是否有效的H3細胞ID,必要但不充分條件之間的有效的H3 ID,它的價值是0 x08001fffffffffff和0 x08ff3b6db6db6db6。函數定義的行為如果輸入細胞ID不是一個有效的細胞ID。如果網格距離的值是零,返回的數組包含一個值等於輸入H3細胞ID。

錯誤條件

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

  • 如果kExpr是負的,函數返回H3_INVALID_GRID_DISTANCE_VALUE。

例子

——簡單的例子,第一個參數是一個長整型數字。>選擇h3_kring(599686042433355775,1)(599686042433355775,599686030622195711,599686044580839423,599686038138388479,599686043507097599,599686015589810175,599686014516068351]——簡單的例子,第一個參數是一個字符串。>選擇h3_kring(“85283473 fffffff”,1)(85283473fffffff,85283447fffffff,8528347bfffffff,85283463fffffff,85283477fffffff,8528340ffffffff,8528340bfffffff]——首先輸入一個無效的H3細胞ID。>選擇h3_kring(0,0)(H3_INVALID_CELL_ID]0是不一個有效的H3細胞ID——第二個輸入是一個無效的網格距離值。>選擇h3_kring(“85283473 fffffff”,- - - - - -1)(H3_INVALID_GRID_DISTANCE_VALUE]H3網格距離- - - - - -1必須是非- - - - - -負