h3_polyfillash3
函數
適用於:磚的SQL磚運行時11.2及以上
返回一個數組H3細胞id(表示為BIGINT)相應的六邊形或五角大樓,指定的決議,所包含的輸入區域地理。
返回
數組的BIGINT值對應H3細胞id指定的決議,所包含的輸入區域地理。
函數返回NULL如果任何一個輸入的表達式是NULL。如果第一個輸入參數的類型是二進製,輸入值有望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_polyfillash3(“多邊形((-122.4194 - 37.7749,-118.2437 - 34.0522,-74.0060 - 40.7128,-122.4194 - 37.7749))”,2)(586146350232502271,586147449744130047,586198577034821631,586152397546455039,586199676546449407,586153497058082815,586142501941805055,586201325813891071]——簡單的例子,十六進製WKB格式的輸入是一個三角形。>選擇h3_polyfillash3(unhex(“0103000000010000000400000050 fc1873d79a5ec0d0d556ec2fe342404182e2c7988f5dc0f46c567dae064140aaf1d24d628052c05e4bc8073d5b444050fc1873d79a5ec0d0d556ec2fe34240”),2)(586146350232502271,586147449744130047,586198577034821631,586152397546455039,586199676546449407,586153497058082815,586142501941805055,586201325813891071]——喂空linestring GeoJSON格式(而不是一個多邊形或多個多邊形)。>選擇h3_polyfillash3({“類型”:“LineString”、“坐標”:[]}”,2)(GEOJSON_PARSE_ERROR]錯誤解析GeoJSON:無效的或不支持的類型“LineString”在位置9——喂一個無效的WKB(無效的字節順序值)>選擇h3_polyfillash3(unhex(“020700000000”),2)(WKB_PARSE_ERROR]錯誤解析WKB:無效的字節訂單2在位置1——給一個無效的WKT多邊形(多邊形不關閉)>選擇h3_polyfillash3(“多邊形((-122.4194 - 37.7749,-118.2437 - 34.0522,-74.0060 - 40.7128,-74.0060 - 40.7128))”,2)(WKT_PARSE_ERROR]錯誤解析WKT:發現非- - - - - -關閉環在位置80年——解決範圍。>選擇h3_polyfillash3(“多邊形((-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,包容