h3_tochildren
函数
适用于:砖的SQL砖运行时11.2及以上
返回一个数组输入H3的孩子H3细胞细胞在指定的决议。
参数
h3CellIdExpr
:一个长整型数字表达式,或十六进制字符串表达式代表一个H3细胞ID。resolutionExpr
预计:INT表达式,其值之间h3_resolution (h3CellIdExpr)
和15
包容,指定的解决孩子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
小于h3_resolution (h3CellIdExpr)
或比15
,该函数返回H3_INVALID_RESOLUTION_VALUE。
例子
——简单的例子只要输入。>选择h3_tochildren(599686042433355775,6)(604189641121202175,604189641255419903,604189641389637631,604189641523855359,604189641658073087,604189641792290815,604189641926508543]——简单的例子十六进制字符串作为输入。>选择h3_tochildren(“85283473 fffffff”,6)(862834707ffffff,86283470fffffff,862834717ffffff,86283471fffffff,862834727ffffff,86283472fffffff,862834737ffffff]——首先输入一个无效的H3细胞ID。>选择h3_tochildren(0,15)(H3_INVALID_CELL_ID]0是不一个有效的H3细胞ID——第二个输入一个无效的分辨率值。>选择h3_tochildren(“85283473 fffffff”,0)(H3_INVALID_RESOLUTION_VALUE]H3决议0必须是之间的5和15,包容