名称
ST_SetEffectiveArea — 使用 Visvalingam-Whyatt 算法设置每个顶点的有效面积。
概要
geometry ST_SetEffectiveArea(geometry geom, float threshold = 0, integer set_area = 1);
描述
使用 Visvalingam-Whyatt 算法设置每个顶点的有效面积。有效面积存储为顶点的 M 值。如果使用可选的 "threshold" 参数，将返回一个简化的几何图形，其中仅包含有效面积大于或等于阈值的顶点。
当指定阈值时，此函数可用于服务器端简化。另一种选择是使用零的阈值。在这种情况下，将返回具有有效面积作为 M 值的完整几何图形，客户端可以使用这些 M 值非常快速地进行简化。
实际上，此函数仅对（多）线和（多）多边形执行操作，但您可以安全地使用任何类型的几何图形调用它。由于简化是逐对象进行的，您也可以将 GeometryCollection 提供给此函数。
![[Note]](../images/note.png)
|
|
|
请注意，返回的几何图形可能会失去其简单性（请参阅ST_IsSimple） |
|
|
|
|
请注意，拓扑可能不会保留，并可能导致无效的几何图形。使用（请参阅ST_SimplifyPreserveTopology）来保留拓扑。 |
|
|
|
|
输出几何图形将丢失 M 值中的所有先前信息 |
|
|
|
|
此函数处理 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)