h3_pointash3string函數

返回H3細胞ID(一個字符串)提供對應點指定的決議。

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

語法

h3_pointash3string(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_pointash3string(“點45 (100)”,6)86240610fffffff——金門大橋的H3細胞ID在決議13。>選擇h3_pointash3string(的點(-122.4783 - 37.8199),13)8d283087022a93f——函數返回NULL如果輸入是空點。>選擇h3_pointash3string({“類型”:“點”,“坐標”:[]}”,15)零——喂養一個多點WKT格式而不是一個點。>選擇h3_pointash3string(“多點45 (100)”,6)(WKT_PARSE_ERROR]錯誤解析WKT:無效的或不支持的類型“多點”在位置1——給一個無效的GeoJSON字符串(“類型”值是不正確的)。>選擇h3_pointash3string({“類型”:“點”,“坐標”:[]}”,15)(GEOJSON_PARSE_ERROR]錯誤解析GeoJSON:無效的或不支持的類型“點”的在位置9——喂一個無效的WKB(無效的字節順序值)>選擇h3_pointash3string(unhex(“0201000000516 b9a779c9e5ec0c5feb27bf2e84240”),2)(WKB_PARSE_ERROR]錯誤解析WKB:無效的字節訂單2在位置1——解決範圍。>選擇h3_pointash3string(的點(-122.4783 - 37.8199),16)(H3_INVALID_RESOLUTION_VALUE]H3決議16必須是之間的0和15,包容