h3_pointash3函数

返回H3细胞ID(作为一个长整型数字)提供对应点指定的决议。

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

语法

h3_pointash3(geographyExpr,resolutionExpr)

参数

  • geographyExpr:一个二进制或字符串表达式代表一个点地理位置WKB,WKT,或GeoJSON。地理预计在度经度和纬度坐标参考WGS84坐标参考系统。

  • resolutionExpr预计:INT表达式,其值之间0和15包容,指定的决议H3细胞ID。

返回

返回H3细胞ID(作为一个长整型数字)提供对应点指定的决议。

函数返回NULL如果任何一个输入的表达式是NULL。如果第一个输入参数的类型是二进制,输入值有望WKB] (https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry # Well-known_binary)描述一个点。如果第一个输入参数的类型是字符串,输入值将WKT或者是GeoJSON描述一个点。输入点的维数可以2 d, 3 dz, 3 dm,或4 d。经度和纬度的值WKB,WKT,或GeoJSON预计将在描述WGS84坐标参考系统。该函数返回NULL如果第一个输入对应于空点。

错误条件

  • 如果geographyExpr的类型是二进制和值是无效的WKB或者不代表一个点,函数返回WKB_PARSE_ERROR。

  • 如果geographyExpr是字符串类型的值是无效的WKT或不代表一个点,函数返回WKT_PARSE_ERROR。

  • 如果geographyExpr是字符串类型的值是无效的GeoJSON或不代表一个点,函数返回GEOJSON_PARSE_ERROR。

  • 如果resolutionExpr小于0或比15,该函数返回H3_INVALID_RESOLUTION_VALUE。

例子

——简单的例子。>选择h3_pointash3(“点45 (100)”,6)604116085645508607——金门大桥的H3细胞ID在决议13。>选择h3_pointash3(的点(-122.4783 - 37.8199),13)635714569676958015——函数返回NULL如果输入是空点。>选择h3_pointash3({“类型”:“点”,“坐标”:[]}”,15)零——喂养一个多点WKT格式而不是一个点。>选择h3_pointash3(“多点45 (100)”,6)(WKT_PARSE_ERROR]错误解析WKT:无效的或不支持的类型“多点”在位置1——给一个无效的GeoJSON字符串(“类型”值是不正确的)。>选择h3_pointash3({“类型”:“点”,“坐标”:[]}”,15)(GEOJSON_PARSE_ERROR]错误解析GeoJSON:无效的或不支持的类型“点”的在位置9——喂一个无效的WKB(无效的字节顺序值)>选择h3_pointash3(unhex(“0201000000516 b9a779c9e5ec0c5feb27bf2e84240”),2)(WKB_PARSE_ERROR]错误解析WKB:无效的字节订单2在位置1——解决范围。>选择h3_pointash3(的点(-122.4783 - 37.8199),16)(H3_INVALID_RESOLUTION_VALUE]H3决议16必须是之间的0和15,包容