Kategorien:

Geodatenfunktionen

ST_SIMPLIFY

Gibt bei einem GEOGRAPHY-Eingabeobjekt, das eine Linie oder ein Polygon darstellt, eine vereinfachte Approximation des Objekts zurück. Die Funktion identifiziert und entfernt ausgewählte Punkte, wodurch ein ähnliches Objekt mit weniger Punkten entsteht.

Wenn das Eingabeobjekt beispielsweise ein Polygon mit 50 Punkten ist, kann ST_SIMPLIFY ein vereinfachtes Polygon mit nur 20 Punkten zurückgeben.

Bei der Vereinfachung eines Objekts entfernt die Funktion einen Punkt nur dann, wenn der Abstand zwischen diesem Punkt und der Verbindungslinie, die bei Entfernen dieses Punktes entsteht, innerhalb der angegebenen Toleranz liegt.

Syntax

ST_SIMPLIFY( <geography_expression>, <tolerance> [ , <preserve_collapsed> ] )

Argumente

Erforderlich:

geography_expression

Das zu vereinfachende GEOGRAPHY-Objekt.

Abhängig vom Typ des GEOGRAPHY-Objekts hat ST_SIMPLIFY folgende Auswirkung:

Objekttyp

Auswirkung von ST_SIMPLIFY

LineString, MultiLineString, Polygon oder MultiPolygon

ST_SIMPLIFY wendet den Vereinfachungsalgorithmus an

Punkt oder MultiPoint

ST_SIMPLIFY hat keine Auswirkung.

GeometryCollection oder FeatureCollection

ST_SIMPLIFY wendet den Vereinfachungsalgorithmus auf jedes Objekt in der Collection an.

tolerance

Der maximale Abstand in Metern zwischen einem Punkt und der Verbindungslinie, die durch Entfernen des Punkts entsteht. Wenn der Abstand den Toleranzwert für einen Punkt überschreitet, behält ST_SIMPLIFY diesen Punkt im vereinfachten Objekt bei.

Optional:

preserve_collapsed

Wenn TRUE, werden Objekte beibehalten, die angesichts der Toleranz sonst zu klein wären.

Wenn beispielsweise preserve_collapsed auf FALSE gesetzt ist und tolerance den Wert 10 (Meter) hat, wird eine 1 m lange Linie im vereinfachten Objekt auf einen Punkt reduziert. Wenn preserve_collapsed auf TRUE gesetzt ist, bleibt die Linie im vereinfachten Objekt erhalten.

Standard: FALSE.

Rückgabewerte

Gibt einen Wert vom Typ GEOGRAPHY zurück.

Beispiele

In den Beispielen in diesem Abschnitt wird die Ausgabe im WKT-Format angezeigt:

alter session set GEOGRAPHY_OUTPUT_FORMAT='WKT';

Das folgende Beispiel gibt ein vereinfachtes LineString-Objekt zurück, das weniger Punkte als das ursprüngliche LineString-Objekt hat. In dem vereinfachten Objekt wird ein Punkt weggelassen, wenn der Abstand zwischen dem Punkt und der Verbindungslinie, die bei Entfernen des Punktes entsteht, weniger als 1.000 Meter beträgt.

SELECT ST_SIMPLIFY(
    TO_GEOGRAPHY('LINESTRING(-122.306067 37.55412, -122.32328 37.561801, -122.325879 37.586852)'),
    1000);
+----------------------------------------------------------------------------------------------------+
| ST_SIMPLIFY(                                                                                       |
|     TO_GEOGRAPHY('LINESTRING(-122.306067 37.55412, -122.32328 37.561801, -122.325879 37.586852)'), |
|     1000)                                                                                          |
|----------------------------------------------------------------------------------------------------|
| LINESTRING(-122.306067 37.55412,-122.325879 37.586852)                                             |
+----------------------------------------------------------------------------------------------------+
Zurück zum Anfang