h3_hexring函數

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

返回一個數組的H3細胞形成一個中空的六角環為中心在原點H3細胞和在電網距離k從原點H3細胞。

語法

h3_hexring(h3CellIdExpr,kExpr)

參數

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

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

返回

相同類型的數組的值的類型h3CellIdExpr表情,H3細胞對應相同的id,決議作為輸入H3細胞,形成一個中空的環為中心在原點H3細胞在距離k,在那裏k的值是kExpr

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

錯誤條件

例子

——簡單的例子,第一個參數是一個長整型數字。>選擇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