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必须是非- - - - - -负