Name

ST_BuildArea — Erzeugt eine polygonale Geometrie, die aus dem Linienwerk einer Geometrie gebildet wird.

Synopsis

geometry ST_BuildArea(geometry geom);

Beschreibung

Erzeugt eine flächige Geometrie, die aus den konstituierenden Linienzügen der Eingabegeometrie gebildet wird. Die Eingabe kann ein LineString, MultiLineString, Polygon, MultiPolygon oder eine GeometryCollection sein. Das Ergebnis ist ein Polygon oder MultiPolygon, je nach Eingabe. Wenn das eingegebene Liniengerüst keine Polygone bildet, wird NULL zurückgegeben.

Im Gegensatz zu ST_MakePolygon akzeptiert diese Funktion Ringe, die aus mehreren Linien bestehen, und kann eine beliebige Anzahl von Polygonen bilden.

Diese Funktion wandelt innere Ringe in Löcher um. Um auch innere Ringe in Polygone zu verwandeln, verwenden Sie ST_Polygonize.

[Note]

Damit diese Funktion ordnungsgemäß funktioniert, muss das eingegebene Linienwerk korrekt genodet sein. ST_Node kann zum Knoten von Linien verwendet werden.

Wenn sich das eingegebene Linienwerk kreuzt, erzeugt diese Funktion ungültige Polygone. ST_MakeValid kann verwendet werden, um sicherzustellen, dass die Ausgabe gültig ist.

Verfügbarkeit: 1.1.0

Beispiele

Eingabezeilen

Bereich Ergebnis

WITH data(geom) AS (VALUES
   ('LINESTRING (180 40, 30 20, 20 90)'::geometry)
  ,('LINESTRING (180 40, 160 160)'::geometry)
  ,('LINESTRING (160 160, 80 190, 80 120, 20 90)'::geometry)
  ,('LINESTRING (80 60, 120 130, 150 80)'::geometry)
  ,('LINESTRING (80 60, 150 80)'::geometry)
)
SELECT ST_AsText( ST_BuildArea( ST_Collect( geom )))
    FROM data;

------------------------------------------------------------------------------------------
POLYGON((180 40,30 20,20 90,80 120,80 190,160 160,180 40),(150 80,120 130,80 60,150 80))

Erstellen eines Donuts aus zwei kreisförmigen Polygonen

SELECT ST_BuildArea(ST_Collect(inring,outring))
FROM (SELECT
    ST_Buffer('POINT(100 90)', 25) As inring,
    ST_Buffer('POINT(100 90)', 50) As outring) As t;

Siehe auch

ST_Collect, ST_MakePolygon, ST_MakeValid, ST_Node, ST_Polygonize, ST_BdPolyFromText, ST_BdMPolyFromText (Wrapper zu dieser Funktion mit Standard OGC Schnittstelle)