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
の値。この値は、ボックスの左下隅の 2 番目の座標です。 - xmax
-
データ型
DOUBLE PRECISION
の値。この値は、ボックスの右上隅の最初の座標です。 - ymax
-
データ型
DOUBLE PRECISION
の値。この値は、ボックスの右上隅の 2 番目の座標です。 - srid
-
空間リファレンス識別子 (SRID) を表すデータ型
INTEGER
の値。SRID 値が指定されていない場合、0 に設定されます。
戻り型
サブタイプ POINT
、LINESTRING
、または POLYGON
の GEOMETRY
。
返されたジオメトリの SRID は、srid
に設定され、srid
が設定されていない場合は 0 に設定されます。
xmin、ymin、xmax、ymax、または srid が null の場合は、null が返されます。
srid が負数の場合、エラーが返されます。
例
次の SQL は、4 つの入力座標値によって定義されたエンベロープを表すポリゴンを返します。
SELECT ST_AsEWKT(ST_MakeEnvelope(2,4,5,7));
st_astext
---------------
POLYGON((2 4,2 7,5 7,5 4,2 4))
次の SQL は、4 つの入力座標値と 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))