h3_coverash3函數

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

返回一個數組的BIGINT值代表H3細胞id。這些值對應於五邊形和六邊形拚成的最小集合,指定的決議,全麵覆蓋輸入區域地理。

語法

h3_coverash3(geographyExpr,resolutionExpr)

參數

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

  • resolutionExpr:INT表達式之間的一個值0和15包容,指定的決議H3細胞id。

返回

數組的BIGINT值對應於H3細胞的最小集合id,指定的決議,全麵覆蓋輸入區域地理。

函數返回零如果任何一個輸入的表達式零。如果第一個輸入參數的類型是二進製,必須輸入值WKB描述一個多邊形或多個多邊形。如果第一個輸入參數的類型是字符串,必須的輸入值WKT或者是GeoJSON描述一個多邊形或多個多邊形。輸入多邊形或多個多邊形的維數可以2 d, 3 dz, 3 dm,或4 d。

錯誤條件

  • 如果geographyExpr的類型是二進製和值是無效的WKB或者不代表一個或多個多邊形,多邊形函數返回WKB_PARSE_ERROR。

  • 如果geographyExpr是字符串類型的值是無效的WKT或不代表一個或多個多邊形,多邊形函數返回WKT_PARSE_ERROR。

  • 如果geographyExpr是字符串類型的值是無效的GeoJSON或不代表一個或多個多邊形,多邊形函數返回GEOJSON_PARSE_ERROR。

  • 如果resolutionExpr小於0或比15,該函數返回H3_INVALID_RESOLUTION_VALUE。

例子

——簡單例子WKT格式的輸入是一個三角形。>選擇h3_coverash3(“多邊形((-122.4194 - 37.7749,-118.2437 - 34.0522,-74.0060 - 40.7128,-122.4194 - 37.7749))”,0)(577164439745200127,577199624117288959,577234808489377791,577762574070710271]——簡單的例子,十六進製WKB格式的輸入是一個三角形。>選擇h3_coverash3(unhex(“0103000000010000000400000050 fc1873d79a5ec0d0d556ec2fe342404182e2c7988f5dc0f46c567dae064140aaf1d24d628052c05e4bc8073d5b444050fc1873d79a5ec0d0d556ec2fe34240”),0)(577164439745200127,577199624117288959,577234808489377791,577762574070710271]——喂空linestring GeoJSON格式(而不是一個多邊形或多個多邊形)。>選擇h3_coverash3({“類型”:“LineString”、“坐標”:[]}”,2)(GEOJSON_PARSE_ERROR]錯誤解析GeoJSON:無效的或不支持的類型“LineString”在位置9——喂一個無效的WKB(無效的字節順序值)>選擇h3_coverash3(unhex(“020700000000”),2)(WKB_PARSE_ERROR]錯誤解析WKB:無效的字節訂單2在位置1——給一個無效的WKT多邊形(多邊形不關閉)>選擇h3_coverash3(“多邊形((-122.4194 - 37.7749,-118.2437 - 34.0522,-74.0060 - 40.7128,-74.0060 - 40.7128))”,2)(WKT_PARSE_ERROR]錯誤解析WKT:發現非- - - - - -關閉環在位置80年——解決範圍。>選擇h3_coverash3(“多邊形((-122.4194 - 37.7749,-118.2437 - 34.0522,-74.0060 - 40.7128,-122.4194 - 37.7749))”,16)(H3_INVALID_RESOLUTION_VALUE]H3決議16必須是之間的0和15,包容