名称

ST_SymDifference — 计算表示几何 A 和 B 中不重叠部分的几何。

语法

geometry ST_SymDifference(geometry geomA, geometry geomB, float8 gridSize = -1);

描述

返回表示几何 A 和 B 中不重叠部分的几何。这等同于 ST_Union(A,B) - ST_Intersection(A,B)。之所以称为对称差,是因为 ST_SymDifference(A,B) = ST_SymDifference(B,A)

如果提供了可选的 gridSize 参数,则会将输入捕捉到指定大小的网格,并在同一网格上计算结果折点。(需要 GEOS-3.9.0 或更高版本)

由 GEOS 模块执行

增强:3.1.0 接受 gridSize 参数。

需要 GEOS >= 3.9.0 才能使用 gridSize 参数

此方法实现了 OGC SQL 1.1 简单要素实施规范。

s2.1.1.3

此方法实现了 SQL/MM 规范。

SQL-MM 3: 5.1.21

此函数支持 3d,并且不会丢弃 z 索引。

但是,结果仅使用 XY 计算。结果 Z 值会被复制、平均或插值。

示例

一起显示的原始线串

两条线串的对称差

--Safe for 2d - symmetric difference of 2 linestrings
SELECT ST_AsText(
    ST_SymDifference(
        ST_GeomFromText('LINESTRING(50 100, 50 200)'),
        ST_GeomFromText('LINESTRING(50 50, 50 150)')
    )
);

st_astext
---------
MULTILINESTRING((50 150,50 200),(50 50,50 100))
--When used in 3d doesn't quite do the right thing
SELECT ST_AsEWKT(ST_SymDifference(ST_GeomFromEWKT('LINESTRING(1 2 1, 1 4 2)'),
    ST_GeomFromEWKT('LINESTRING(1 1 3, 1 3 4)')))

st_astext
------------
MULTILINESTRING((1 3 2.75,1 4 2),(1 1 3,1 2 2.25))
        

另请参阅

ST_DifferenceST_IntersectionST_Union