h3_hexring
函數
適用於:磚的SQL磚運行時11.2及以上
返回一個數組的H3細胞形成一個中空的六角環為中心在原點H3細胞和在電網距離k
從原點H3細胞。
返回
相同類型的數組的值的類型h3CellIdExpr
表情,H3細胞對應相同的id,決議作為輸入H3細胞,形成一個中空的環為中心在原點H3細胞在距離k
,在那裏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。如果有一個五角大樓的任何地方
k
撕咬的起源細胞,函數返回H3_PENTAGON_ENCOUNTERED_ERROR。
例子
——簡單的例子,第一個參數是一個長整型數字。>選擇h3_hexring(599686042433355775,1)(599686014516068351,599686030622195711,599686044580839423,599686038138388479,599686043507097599,599686015589810175]——簡單的例子,第一個參數是一個字符串。>選擇h3_hexring(“85283473 fffffff”,1)(8528340bfffffff,85283447fffffff,8528347bfffffff,85283463fffffff,85283477fffffff,8528340ffffffff]——首先輸入一個無效的H3細胞ID。>選擇h3_hexring(0,0)(H3_INVALID_CELL_ID]0是不一個有效的H3細胞ID——第二個輸入是一個無效的網格距離值。>選擇h3_hexring(“85283473 fffffff”,- - - - - -1)(H3_INVALID_GRID_DISTANCE_VALUE]H3網格距離- - - - - -1必須是非- - - - - -負——輸入細胞是一個六角形細胞相鄰五角細胞(雙環的六角形細胞包含五角大樓)。>選擇H3_HexRing(8007 fffffffffff,2)(H3_PENTAGON_ENCOUNTERED_ERROR]一個五角大樓是遇到而計算的十六進製環的8007 fffffffffff與網格距離2