ST_ MakeEnvelope

ST_ MakeEnvelope 會傳回幾何圖形，如下所示：

• 如果輸入座標指定了一個點，則傳回的幾何為一個點。

• 如果輸入座標指定了直線，則傳回的幾何為 linestring。

• 否則，傳回的幾何為多邊形，其中輸入座標會指定方塊的左下角和右上角。

如果提供，則傳回幾何的空間參考系統識別碼 (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))