ST_SnapToGrid

ST_SnapToGrid
Zurück	7.5. Geometrische Editoren	Weiter

Name

ST_SnapToGrid — Fängt alle Punkte der Eingabegeometrie auf einem regelmäßigen Gitter.

Übersicht

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

Beschreibung

Variante 1, 2 und 3: Fängt alle Punkte der Eingabegeometrie auf den Gitterpunkten, die durch Ursprung und Gitterkästchengröße festgelegt sind. Aufeinanderfolgende Punkte, die in dasselbe Gitterkästchen fallen, werden gelöscht, wobei NULL zurückgegeben wird, wenn nicht mehr genug Punkte für den jeweiligen geometrischen Datentyp vorhanden sind. Collapsed geometries in a collection are stripped from it. Kollabierte Geometrien einer Kollektion werden von dieser entfernt. Nützlich um die Genauigkeit zu verringern.

Variante 4: wurde mit 1.1.0 eingeführt - Fängt alle Punkte der Eingabegeometrie auf den Gitterpunkten, welche durch den Ursprung des Gitters (der zweite Übergabewert muss ein Punkt sein) und die Gitterkästchengröße bestimmt sind. Geben Sie 0 als Größe für jene Dimension an, die nicht auf den Gitterpunkten gefangen werden soll.


	Die zurückgegebene Geometrie kann ihre Simplizität verlieren (siehe ST_IsSimple).


	Vor Release 1.1.0 gab diese Funktion immer eine 2D-Geometrie zurück. Ab 1.1.0 hat die zurückgegebene Geometrie dieselbe Dimensionalität wie die Eingabegemetrie, wobei höhere Dimensionen unangetastet bleiben. Verwenden Sie die Version, welche einen zweiten geometrischen Übergabewert annimmt, um sämtliche Grid-Dimensionen zu bestimmen.

Verfügbarkeit: 1.0.0RC1

Verfügbarkeit: 1.1.0, Unterstützung für Z und M

Diese Funktion unterstützt 3d und lässt den Z-Index nicht fallen.

Beispiele

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

Code

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

Display how the same grid size rounds a LineString.

Code

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

Ausgabe von Rastern

LINESTRING(1.112 2.123,4.111 3.237)

010200000002000000986E1283C0CAF13F96438B6CE7FB00408B6CE7FBA97110404C37894160E50940

Figure

This example snaps a 4D geometry.

Code

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

Ausgabe von Rastern

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.

Code

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

Ausgabe von Rastern

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

01020000C002000000C3F5285C8FC2F1BFF6285C8FC2F50040000000000000084016FBCBEEC9C30240713D0AD7A3701040EC51B81E85EB0940789CA223B9FC08409E5E29CB10C7F13F

Figure

Siehe auch

ST_Snap, ST_AsEWKT, ST_AsText, ST_GeomFromText, ST_GeomFromEWKT, ST_Simplify