名称
ST_SnapToGrid — 将输入几何的所有点捕捉到规则网格。
概要
geometry ST_SnapToGrid(geometry geomA, float originX, float originY, float sizeX, float sizeY);
geometry ST_SnapToGrid(geometry geomA, float sizeX, float sizeY);
geometry ST_SnapToGrid(geometry geomA, float size);
geometry ST_SnapToGrid(geometry geomA, geometry pointOrigin, float sizeX, float sizeY, float sizeZ, float sizeM);
描述
变体 1,2,3：将输入几何的所有点捕捉到由其原点和单元格大小定义的网格。移除落在同一单元格上的连续点，最终如果输出点不足以定义给定类型的几何，则返回 NULL。集合中的折叠几何将被剥离。对于降低精度很有用。
变体 4：在 1.1.0 中引入 - 将输入几何的所有点捕捉到由其原点（第二个参数，必须是点）和单元格大小定义的网格。对于不想捕捉到网格的任何维度，指定 0 作为大小。
![[Note]](../images/note.png) | |
返回的几何可能会失去其简单性（参见 ST_IsSimple）。 |
| |
在 1.1.0 版本之前，此函数始终返回一个 2d 几何。从 1.1.0 开始，返回的几何将具有与输入相同的维度，更高维度的值保持不变。使用采用第二个几何参数的版本来定义所有网格维度。 |
可用性：1.0.0RC1
可用性：1.1.0 - Z 和 M 支持
此函数支持 3d 并且不会删除 z 索引。
示例
--Snap your geometries to a precision grid of 10^-3
UPDATE mytable
SET geom = ST_SnapToGrid(geom, 0.001);
SELECT ST_AsText(ST_SnapToGrid(
ST_GeomFromText('LINESTRING(1.1115678 2.123, 4.111111 3.2374897, 4.11112 3.23748667)'),
0.001)
);
st_astext
-------------------------------------
LINESTRING(1.112 2.123,4.111 3.237)
--Snap a 4d geometry
SELECT ST_AsEWKT(ST_SnapToGrid(
ST_GeomFromEWKT('LINESTRING(-1.1115678 2.123 2.3456 1.11111,
4.111111 3.2374897 3.1234 1.1111, -1.11111112 2.123 2.3456 1.1111112)'),
ST_GeomFromEWKT('POINT(1.12 2.22 3.2 4.4444)'),
0.1, 0.1, 0.1, 0.01) );
st_asewkt
------------------------------------------------------------------------------
LINESTRING(-1.08 2.12 2.3 1.1144,4.12 3.22 3.1 1.1144,-1.08 2.12 2.3 1.1144)
--With a 4d geometry - the ST_SnapToGrid(geom,size) only touches x and y coords but keeps m and z the same
SELECT ST_AsEWKT(ST_SnapToGrid(ST_GeomFromEWKT('LINESTRING(-1.1115678 2.123 3 2.3456,
4.111111 3.2374897 3.1234 1.1111)'),
0.01) );
st_asewkt
---------------------------------------------------------
LINESTRING(-1.11 2.12 3 2.3456,4.11 3.24 3.1234 1.1111)