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 x08001fffffffffff和0 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