Descrição

Variante1,2,3: Rompe todos os pontos da geometria de entrada para a rede definida por sua origem e tamanho da célula. Remove pontos consecutivos caindo na mesma célula, finalmente retornando NULO se os pontos de saída não são suficientes para definir uma geometria do tipo dado. Geometrias colapsadas em uma coleção são desguarnecidas disso. Útil para reduzi a precisão.

Variante4: Introduzido 1.1.0 - Rompe todos os pontos da geometria de entrada para a rede definida por sua origem (o segundo argumento deve ser um ponto) e tamanhos de células. Especifica 0 como um tamanho para qualquer dimensão que você não quer romper para uma rede.

	A geometria de retorno pode perder sua simplicidade (veja ST_IsSimple).

	Antes de lançar 1.1.0, essa função sempre retornou uma geometria 2d. Começando em 1.1.0 a geometria de retorno terá a mesma dimensionalidade da entrada com maiores valores intocados de dimensão. Use a versão pegando um segundo argumento de geometria para definir todas as dimensões de rede.

Disponibilidade: 1.0.0RC1

Disponibilidade: 1.1.0 - suporte a Z e M

This function supports 3d and will not drop the z-index.

Exemplos

Snap a geometry column to a precision grid of 10^-3.

UPDATE mytable
   SET geom = ST_SnapToGrid(geom, 0.001);

Display how the same grid size rounds a LineString.

SELECT ST_SnapToGrid('LINESTRING(1.1115678 2.123,4.111111 3.2374897,4.11112 3.23748667)'::geometry,
        0.001);

LINESTRING(1.112 2.123,4.111 3.237)

010200000002000000986E1283C0CAF13F96438B6CE7FB00408B6CE7FBA97110404C37894160E50940

Figure

This example snaps a 4D geometry.

SELECT ST_SnapToGrid('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)'::geometry,
        'POINT(1.12 2.22 3.2 4.4444)',
        0.1, 0.1, 0.1, 0.01);

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)

01020000C00300000048E17A14AE47F1BFF6285C8FC2F50040676666666666024030992A1895D4F13F7B14AE47E17A1040C3F5285C8FC20940CDCCCCCCCCCC084030992A1895D4F13F48E17A14AE47F1BFF6285C8FC2F50040676666666666024030992A1895D4F13F

Figure

With a 4D geometry - the ST_SnapToGrid(geom,size) only touches x and y coords but keeps m and z the same.

SELECT ST_SnapToGrid('LINESTRING(-1.1115678 2.123 3 2.3456,
        4.111111 3.2374897 3.1234 1.1111)'::geometry,
       0.01);

LINESTRING(-1.11 2.12 3 2.3456,4.11 3.24 3.1234 1.1111)

01020000C002000000C3F5285C8FC2F1BFF6285C8FC2F50040000000000000084016FBCBEEC9C30240713D0AD7A3701040EC51B81E85EB0940789CA223B9FC08409E5E29CB10C7F13F

Figure

Veja também

ST_Snap, ST_AsEWKT, ST_AsText, ST_GeomFromText, ST_GeomFromEWKT, ST_Simplify