ST_Snap
上一个 7.5. 几何编辑器 下一个

名称

ST_Snap — 将输入几何图形的线段和顶点捕捉到参考几何图形的顶点。

概要

geometry ST_Snap(geometry input, geometry reference, float tolerance);

描述

将几何图形的顶点和线段捕捉到另一个几何图形的顶点。捕捉距离容差用于控制捕捉执行的位置。结果几何图形是顶点已捕捉的输入几何图形。如果未发生捕捉，则返回未更改的输入几何图形。

将一个几何图形捕捉到另一个几何图形可以提高叠加操作的稳健性，方法是消除几乎重合的边（这些边会导致节点和交点计算出现问题）。

过多的捕捉会导致创建无效的拓扑，因此，捕捉顶点的数量和位置是使用启发式方法确定的，以确定何时可以安全地捕捉。但是，这可能会导致某些潜在的捕捉被省略。

[Note]

返回的几何图形可能会失去其简单性（参见 ST_IsSimple）和有效性（参见 ST_IsValid）。

由 GEOS 模块执行。

可用性：2.0.0

示例

显示了带有线字符串的多边形（在任何捕捉之前）

将多边形捕捉到线字符串，容差为：距离的 1.01。新的多边形与参考线字符串一起显示

SELECT ST_AsText(ST_Snap(poly,line, ST_Distance(poly,line)*1.01)) AS polysnapped
FROM (SELECT
   ST_GeomFromText('MULTIPOLYGON(
     ((26 125, 26 200, 126 200, 126 125, 26 125 ),
      ( 51 150, 101 150, 76 175, 51 150 )),
      (( 151 100, 151 200, 176 175, 151 100 )))') As poly,
       ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As line
	) As foo;

                             polysnapped
---------------------------------------------------------------------
 MULTIPOLYGON(((26 125,26 200,126 200,126 125,101 100,26 125),
 (51 150,101 150,76 175,51 150)),((151 100,151 200,176 175,151 100)))

将多边形捕捉到线字符串，容差为：距离的 1.25。新的多边形与参考线字符串一起显示

SELECT ST_AsText(
    ST_Snap(poly,line, ST_Distance(poly,line)*1.25)
  ) AS polysnapped
FROM (SELECT
  ST_GeomFromText('MULTIPOLYGON(
    (( 26 125, 26 200, 126 200, 126 125, 26 125 ),
      ( 51 150, 101 150, 76 175, 51 150 )),
      (( 151 100, 151 200, 176 175, 151 100 )))') As poly,
       ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As line
	) As foo;

                             polysnapped
---------------------------------------------------------------------
MULTIPOLYGON(((5 107,26 200,126 200,126 125,101 100,54 84,5 107),
(51 150,101 150,76 175,51 150)),((151 100,151 200,176 175,151 100)))

将线字符串捕捉到原始多边形，容差为距离的 1.01。新的线字符串与参考多边形一起显示

SELECT ST_AsText(
   ST_Snap(line, poly, ST_Distance(poly,line)*1.01)
  ) AS linesnapped
FROM (SELECT
  ST_GeomFromText('MULTIPOLYGON(
     ((26 125, 26 200, 126 200, 126 125, 26 125),
      (51 150, 101 150, 76 175, 51 150 )),
      ((151 100, 151 200, 176 175, 151 100)))') As poly,
       ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As line
	) As foo;

              linesnapped
----------------------------------------
 LINESTRING(5 107,26 125,54 84,101 100)

将线字符串捕捉到原始多边形，容差为距离的 1.25。新的线字符串与参考多边形一起显示

SELECT ST_AsText(
 ST_Snap(line, poly, ST_Distance(poly,line)*1.25)
  ) AS linesnapped
FROM (SELECT
  ST_GeomFromText('MULTIPOLYGON(
     (( 26 125, 26 200, 126 200, 126 125, 26 125 ),
      (51 150, 101 150, 76 175, 51 150 )),
      ((151 100, 151 200, 176 175, 151 100 )))') As poly,
       ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As line
	) As foo;
              linesnapped
---------------------------------------
LINESTRING(26 125,54 84,101 100)

另请参见

ST_SnapToGrid

上一个 向上 下一个
ST_SnapToGrid 主页 ST_SwapOrdinates