ST_MakeEnvelope

ST_MakeEnvelope 返回一个几何体，如下所示：

• 如果输入坐标指定一个点，则返回的几何体是一个点。

• 如果输入坐标指定一条线，则返回的几何为线串。

• 否则，返回的几何体位面，其中输入坐标指定框的左下角和右上角。

返回的几何体的空间参考系统标识符 (SRID) 值（如有提供）将设置为输入 SRID 值。

语法

ST_MakeEnvelope(xmin, ymin, xmax, ymax)

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

参数

xmin

一个 数据类型的 值DOUBLE PRECISION 此值是框左下角的第一个坐标。

ymin

一个 数据类型的 值DOUBLE PRECISION 此值是框左下角的第二个坐标。

xmax

一个 数据类型的 值DOUBLE PRECISION 此值是框右上角的第一个坐标。

ymax

一个 数据类型的 值DOUBLE PRECISION 此值是框右上角的第二个坐标。

srid

数据类型 INTEGER 的一个值，它表示空间参考系统标识符 (SRID)。如果未提供 SRID 值，则它会设置为零。

返回类型

子类型 POINT、LINESTRING 或 POLYGON 的 GEOMETRY。

返回的几何体的 SRID 将设置为 srid，如果未设置 srid，则设置为零。

如果 xmin、ymin、xmax、ymax 或 srid 为 null，则返回 null。

如果 srid 为负，则返回一个错误。

示例

以下 SQL 会返回一个面，表示由四个输入坐标值定义的信封。

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

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

以下 SQL 会返回一个面，表示由四个输入坐标值和一个 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))