Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
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))