ST_SetEffectiveArea
Prev  7.14. 几何处理  Next

Name

ST_SetEffectiveArea — 使用 Visvalingam-Whyatt 算法设置每个顶点的有效区域。

Synopsis

geometry ST_SetEffectiveArea(geometry geom, float threshold = 0, integer set_area = 1);

描述

使用 Visvalingam-Whyatt 算法设置每个顶点的有效区域。 有效区域存储为顶点的 M 值。 如果使用可选的“theshold”参数，则将返回简化的几何图形，仅包含有效区域大于或等于阈值的顶点。

当指定阈值时，此函数可用于服务器端简化。 另一种选择是使用零阈值。 在这种情况下，将返回完整的几何图形，其中有效区域作为 M 值，客户端可以使用它来快速简化。

实际上只会对（多）线和（多）多边形执行某些操作，但您可以使用任何类型的几何体安全地调用它。 由于简化是在逐个对象的基础上进行的，因此您还可以将 GeometryCollection 提供给此函数。

[Note]

请注意，返回的几何图形可能会失去其简单性（请参阅ST_IsSimple）
[Note]

请注意，拓扑可能不会保留，并可能导致无效的几何图形。 使用（请参阅ST_SimplifyPreserveTopology）保留拓扑。
[Note]

输出几何图形将丢失 M 值中的所有先前信息
[Note]

此功能处理 3D，三维度会影响有效区域

可用性：2.2.0

示例

计算 LineString 的有效区域。 因为我们使用阈值为零，所以返回输入几何体中的所有顶点。 

select ST_AsText(ST_SetEffectiveArea(geom)) all_pts, ST_AsText(ST_SetEffectiveArea(geom,30) ) thrshld_30
FROM (SELECT  'LINESTRING(5 2, 3 8, 6 20, 7 25, 10 10)'::geometry geom) As foo;
-result
 all_pts | thrshld_30
-----------+-------------------+
LINESTRING M (5 2 3.40282346638529e+38,3 8 29,6 20 1.5,7 25 49.5,10 10 3.40282346638529e+38) | LINESTRING M (5 2 3.40282346638529e+38,7 25 49.5,10 10 3.40282346638529e+38)

相关信息

ST_SimplifyVW