h3_pointash3
函數
返回H3細胞ID(作為一個長整型數字)提供對應點指定的決議。
適用於:磚SQL的預覽磚運行時11.3及以上
返回
返回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,包容