类型 ST_Geometry 的 ST_SnapToGrid(ST_Point,DOUBLE,DOUBLE,DOUBLE,DOUBLE) 方法

返回所有点都已被捕捉到指定网格的几何的副本。

语法

geometry-expression.ST_SnapToGrid(origin,cell-size-x,cell-size-y,cell-size-z,cell-size-m)

参数

名称	类型	说明
origin	ST_Point	网格的原点。
cell-size-x	DOUBLE	X 维度上的网格的单元格大小。
cell-size-y	DOUBLE	Y 维度上的网格的单元格大小。
cell-size-z	DOUBLE	Z 维度上的网格的单元格大小。
cell-size-m	DOUBLE	M 维度上的网格的单元格大小。

返回值

ST_Geometry 返回所有点都已被捕捉到网格的几何。
结果的空间参照系标识符与 geometry-expression 的空间参照系标识符相同。

注释

ST_SnapToGrid 方法可用于降低数据的精度，其作用方式为将几何中的所有点都捕捉到由原点和单元格大小定义的网格上。

可为各维度指定不同的单元格大小。如果不希望捕捉一维的点，可以使用大小为零的单元格。

注意

降低精度可能会造成得到的几何具有不同的属性。例如，可能会造成简单的线串自相交，或者导致生成无效几何。

注意

每个空间参照系都定义了一个网格，所有几何都将被自动捕捉到该网格上。您无法存储精度超过此预定义网格的精度值。

注意

缺省情况下，如果几何的原始格式可用，ST_SnapToGrid 将使用该格式。否则使用内部格式。有关内部和原始格式的详细信息，请参见STORAGE FORMAT 子句，CREATE SPATIAL REFERENCE SYSTEM 语句。

以下示例返回结果 [LineString(1.010101 20.20202, 1.015625 20.203125, 1.01 20.2)]。线串的第一个点是捕捉到为 SRID 0 定义的网格的点 ST_Point( 1.010101, 20.202020 )。线串的第二个点与捕捉到其原点 ( 0.0 0.0 ) 所定义网格的点相同，其中单元格大小 x 为 POWER( 2, -6 )，单元格大小 y 为 POWER( 2, -7 )。线串的第三个点与捕捉到其原点 ( 1.01, 20.2 ) 所定义网格的点相同，其中单元格大小 x 为 POWER( 2, -6 )，单元格大小 y 为 POWER( 2, -7 )。另请参见：对齐网格和公差如何影响空间计算

SELECT NEW ST_LineString( 
   NEW ST_Point( 1.010101, 20.202020 ),
   TREAT( NEW ST_Point( 1.010101, 20.202020 ).ST_SnapToGrid( NEW ST_Point( 0.0, 0.0 ), POWER( 2, -6 ), POWER( 2, -7 ), 0.0, 0.0 ) AS ST_Point ),
   TREAT( NEW ST_Point( 1.010101, 20.202020 ).ST_SnapToGrid( NEW ST_Point( 1.01, 20.2 ), POWER( 2, -6 ), POWER( 2, -7 ), 0.0, 0.0 ) AS ST_Point ) )

使用DocCommentXchange 讨论此页。

类型 ST_Geometry 的 ST_SnapToGrid(ST_Point,DOUBLE,DOUBLE,DOUBLE,DOUBLE) 方法

语法

参数

返回值

注释

注意

注意

注意

标准和兼容性

示例