h3_toparent函数

适用于:检查标记是的砖的SQL检查标记是的砖运行时11.2及以上

返回父H3细胞输入H3的细胞在指定的决议。

语法

h3_toparent(h3cellIdExpr,resolutionExpr)

参数

  • h3CellIdExpr:一个长整型数字表达式,或十六进制字符串表达式代表一个H3细胞ID。

  • resolutionExpr预计:INT表达式,其值之间0和h3_resolution (h3CellIdExpr)包容,指定父H3细胞ID的解决。

返回

相同类型的值的类型h3CellIdExpr表情,对应于输入的父H3细胞ID H3细胞在指定的决议。

该函数返回NULL如果任何两个输入表达式是NULL。函数部分验证关于输入参数是否有效的H3细胞ID,必要但不充分条件之间的有效的H3 ID,它的价值是0 x08001fffffffffff和0 x08ff3b6db6db6db6。函数定义的行为如果输入细胞ID不是一个有效的细胞ID。如果的价值resolutionExpr等于输入的决议H3细胞ID、输入H3细胞返回ID。

错误条件

  • 如果h3CellIdExpr是一个字符串,不能转换为长整型数字或对应于一个长整型数字值小于0 x08001fffffffffff或比0 x08ff3b6db6db6db6,该函数返回H3_INVALID_CELL_ID。

  • 如果resolutionExpr小于0或比h3_resolution (h3CellIdExpr),该函数返回H3_INVALID_RESOLUTION_VALUE。

例子

——简单的例子只要输入。>选择h3_toparent(599686042433355775,0)577199624117288959——简单的例子有效的十六进制字符串作为输入。>选择h3_toparent(“85283473 fffffff”,0)8029年fffffffffff——首先输入一个无效的H3细胞ID。>选择h3_toparent(0,0)(H3_INVALID_CELL_ID]0是不一个有效的H3细胞ID——第二个输入一个无效的分辨率值。>选择h3_toparent(“85283473 fffffff”,- - - - - -1)(H3_INVALID_RESOLUTION_VALUE]H3决议- - - - - -1必须是之间的0和5,包容