ST_MakeEnvelope
ST_MakeEnvelope devuelve una geometría de la siguiente manera:
Si las coordenadas de entrada especifican un punto, la geometría devuelta es un punto.
Si las coordenadas de entrada especifican una línea, la geometría devuelta es una cadena de línea.
De lo contrario, la geometría devuelta es un polígono, donde las coordenadas de entrada especifican las esquinas inferior izquierda y superior derecha de un cuadro.
Si se proporciona, el valor del identificador de sistema de referencia espacial (SRID) de la geometría devuelta se establece en el valor SRID de entrada.
Sintaxis
ST_MakeEnvelope(xmin, ymin, xmax, ymax)
ST_MakeEnvelope(xmin, ymin, xmax, ymax, srid)
Argumentos
- xmin
-
Un valor de tipo de datos
DOUBLE PRECISION
. Este valor es la primera coordenada de la esquina inferior izquierda de un cuadro. - ymin
-
Un valor de tipo de datos
DOUBLE PRECISION
. Este valor es la segunda coordenada de la esquina inferior izquierda de un cuadro. - xmax
-
Un valor de tipo de datos
DOUBLE PRECISION
. Este valor es la primera coordenada de la esquina superior derecha de un cuadro. - ymax
-
Un valor de tipo de datos
DOUBLE PRECISION
. Este valor es la segunda coordenada de la esquina superior derecha de un cuadro. - srid
-
Un valor de tipo de datos
INTEGER
que representa un identificador de referencia espacial (SRID). Si no se proporciona el valor de SRID, se establece en cero.
Tipo de retorno
GEOMETRY
del subtipo POINT
, LINESTRING
o POLYGON
.
El SRID de la geometría devuelta se establece en srid
o cero si srid
no está configurado.
Si xmin, ymin, xmax, ymax o srid es null, se devolverá un valor nulo.
Si srid es negativo, se devuelve un error.
Ejemplos
El siguiente SQL devuelve un polígono que representa un sobre definido por los cuatro valores de las coordenadas de entrada.
SELECT ST_AsEWKT(ST_MakeEnvelope(2,4,5,7));
st_astext
---------------
POLYGON((2 4,2 7,5 7,5 4,2 4))
El siguiente SQL devuelve un polígono que representa un sobre definido por los cuatro valores de las coordenadas de entrada y un valor SRID.
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))