ST_DumpAsPolygons
Prev  11.15. 栅格处理：栅格到几何  Next

Name

ST_DumpAsPolygons — 从给定的栅格带中返回一组 geomval (geom,val) 行。 如果未指定波段 编号，则波段编号默认为 1。

Synopsis

setof geomval ST_DumpAsPolygons(raster rast, integer band_num=1, boolean exclude_nodata_value=TRUE);

描述

这是一个集合返回函数（SRF）。 它返回一组 geomval 行，由几何图形 (geom) 和像素带值 (val) 组成。 每个多边形是该带的所有像素的并集，这些像素具有由 val 表示的相同像素值。

ST_DumpAsPolygon 对于多边形化栅格很有用。 它与 GROUP BY 相反，它创建新行。 例如，它可用于将单个栅格扩展为多个 POLYGONS/MULTIPOLYGONS。

改变 3.3.0，禁用验证和修复以提高性能。 可能会导致无效的几何图形。

可用性：需要 GDAL 1.7 或更高版本。

[Note]

如果没有为波段设置数据值，则不会返回具有该值的像素，除非 except_nodata_value=false。
[Note]

如果您只关心栅格中具有给定值的像素计数，则使用 ST_ValueCount 速度更快。
[Note]

这与 ST_PixelAsPolygons 不同，在 ST_PixelAsPolygons 中，无论像素值如何，都会为每个像素返回一个几何图形。

示例

-- this syntax requires PostgreSQL 9.3+
SELECT val, ST_AsText(geom) As geomwkt
FROM (
SELECT dp.*
FROM dummy_rast, LATERAL ST_DumpAsPolygons(rast) AS dp
WHERE rid = 2
) As foo
WHERE val BETWEEN 249 and 251
ORDER BY val;

 val |                                                       geomwkt
-----+--------------------------------------------------------------------------
 249 | POLYGON((3427927.95 5793243.95,3427927.95 5793243.85,3427928 5793243.85,
        3427928 5793243.95,3427927.95 5793243.95))
 250 | POLYGON((3427927.75 5793243.9,3427927.75 5793243.85,3427927.8 5793243.85,
        3427927.8 5793243.9,3427927.75 5793243.9))
 250 | POLYGON((3427927.8 5793243.8,3427927.8 5793243.75,3427927.85 5793243.75,
        3427927.85 5793243.8, 3427927.8 5793243.8))
 251 | POLYGON((3427927.75 5793243.85,3427927.75 5793243.8,3427927.8 5793243.8,
        3427927.8 5793243.85,3427927.75 5793243.85))