ST_SnapToGrid
Prev  7.5. 도형 편집자(editor)  Next

Name

ST_SnapToGrid — 입력 도형의 모든 포인트를 정규 그리드로 스냅(snap)시킵니다.

Synopsis

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: 입력 도형의 모든 포인트를 원점과 셀(cell) 크기로 정의된 그리드로 스냅(snap)시킵니다. 동일한 셀에 떨어지는 연속된 포인트들을 제거하며, 출력 포인트들이 주어진 유형의 도형을 정의하기에 부족할 경우 결국 NULL을 반환합니다. 도형 집합 안에서 이렇게 붕괴된 도형은 집합에서 제외됩니다. 정확도를 낮추는 데 유용합니다.

변종 4: 1.1.0 버전에서 추가되었습니다. 입력 도형의 모든 포인트를 원점(두 번째 인수, 포인트여야 합니다) 및 셀 크기로 정의된 그리드로 스냅시킵니다. 사용자가 그리드로 스냅시키고 싶지 않은 차원의 경우, 셀 크기를 0으로 설정하십시오.

[Note]

반환되는 도형이 단순성을 잃을 수도 있습니다(ST_IsSimple 참조).
[Note]

1.1.0 버전 배포 전에는 이 함수가 항상 2차원 도형을 반환했습니다. 1.1.0 버전부터 반환되는 도형이, 더 높은 차원값은 건드리지 않은 채, 입력 도형과 동일한 차원수를 가지게 됐습니다. 모든 그리드 차원을 정의하려면 두 번째 도형 인자를 입력받는 버전을 이용하십시오.

1.0.0RC1 버전부터 사용할 수 있습니다.

1.1.0 버전부터 Z 및 M을 지원합니다.

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

예시

--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)