ST_ MakeEnvelope

ST_ MakeEnvelope gibt eine Geometrie wie folgt zurück:

• Wenn die Eingabekoordinaten einen Punkt angeben, ist die zurückgegebene Geometrie ein Punkt.

• Wenn die Eingabekoordinaten eine Linie angeben, ist die zurückgegebene Geometrie ein Linestring.

• Andernfalls ist die zurückgegebene Geometrie ein Polygon, bei dem die Eingabekoordinaten die untere linke und obere rechte Ecke eines Quaders angeben.

Sofern angegeben, wird der SRID-Wert (Spatial Reference System Identifier) der zurückgegebenen Geometrie auf den eingegeben SRID-Wert gesetzt.

Syntax

ST_MakeEnvelope(xmin, ymin, xmax, ymax)

ST_MakeEnvelope(xmin, ymin, xmax, ymax, srid)

Argumente

xmin

Ein Wert vom Datentyp DOUBLE PRECISION. Dieser Wert entspricht der ersten Koordinate in der unteren linken Ecke eines Quaders.

ymin

Ein Wert vom Datentyp DOUBLE PRECISION. Dieser Wert entspricht der zweiten Koordinate in der unteren linken Ecke eines Quaders.

xmax

Ein Wert vom Datentyp DOUBLE PRECISION. Dieser Wert entspricht der ersten Koordinate in der oberen rechten Ecke eines Quaders.

ymax

Ein Wert vom Datentyp DOUBLE PRECISION. Dieser Wert entspricht der zweiten Koordinate in der oberen rechten Ecke eines Quaders.

srid

Ein Wert vom Datentyp INTEGER, der einen Spatial Reference System Identifier (SRID) darstellt. Wenn der SRID-Wert nicht angegeben wird, wird er auf null gesetzt.

Rückgabetyp

GEOMETRY des Subtyps POINT, LINESTRING oder POLYGON.

Die SRID der zurückgegebenen Geometrie wird auf srid festgelegt, bzw. null, wenn srid nicht festgelegt wurde.

Wenn xmin, ymin, xmax, ymax oder srid null ist, wird null zurückgegeben.

Wenn srid negativ ist, wird ein Fehler zurückgegeben.

Beispiele

Die folgende SQL-Anweisung gibt ein Polygon zurück, das ein Envelope darstellt, das von den vier eingegebenen Koordinatenwerten definiert wird.

SELECT ST_AsEWKT(ST_MakeEnvelope(2,4,5,7));

 st_astext
---------------
 POLYGON((2 4,2 7,5 7,5 4,2 4))              

Die folgende SQL-Anweisung gibt ein Polygon zurück, das ein Envelope darstellt, das von den vier eingegebenen Koordinatenwerten und einem SRID-Wert definiert wird.

SELECT ST_AsEWKT(ST_MakeEnvelope(2,4,5,7,4326));

 st_astext
----------------------------------
 SRID=4326;POLYGON((2 4,2 7,5 7,5 4,2 4))