h3_pointash3函數

返回H3細胞ID(作為一個長整型數字)提供對應點指定的決議。

適用於:檢查標記是的磚SQL的預覽檢查標記是的磚運行時11.3及以上

語法

h3_pointash3(geographyExpr,resolutionExpr)

參數

  • geographyExpr:一個二進製或字符串表達式代表一個點地理位置WKB,WKT,或GeoJSON。地理預計在度經度和緯度坐標參考WGS84坐標參考係統。

  • resolutionExpr預計:INT表達式,其值之間015包容,指定的決議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必須之間的015,包容