ST_Envelope - Amazon Redshift

ST_Envelope

ST_Envelope は、次のように、入力ジオメトリの最小の境界ボックスを返します。

  • 入力ジオメトリが空の場合、返されるジオメトリは入力ジオメトリのコピーです。

  • 入力ジオメトリの最小の境界ボックスに含まれるのが 1 つのポイントのみの場合、返されるジオメトリは 1 つのポイントです。

  • 入力ジオメトリの最小の境界ボックスが 1 次元である場合、2 つのポイントのラインストリングが返されます。

  • 上記のいずれにも該当しない場合、この関数は、その頂点を最小の境界ボックスの角とする時計回りのポリゴンを返します。

返されるジオメトリの空間参照系識別子 (SRID) の値は、入力ジオメトリのものと同じです。

空でないすべての入力に対して、この関数は入力ジオメトリの 2D 射影を処理します。

構文

ST_Envelope(geom)

引数

geom

データ型 GEOMETRY の値または GEOMETRY 型と評価される式の値。

戻り型

GEOMETRY

geom が null の場合、null が返されます。

次の SQL は、GEOMETRY オブジェクトの 4 つのポイントを持つ LINESTRING の WKT (Well-known text) 表現を変換し、その頂点を最小の境界ボックスの角とするポリゴンを返します。

SELECT ST_AsText(ST_Envelope(ST_GeomFromText('GEOMETRYCOLLECTION(POLYGON((0 0,10 0,0 10,0 0)),LINESTRING(20 10,20 0,10 0))')));
st_astext ------------------------------------ POLYGON((0 0,0 10,20 10,20 0,0 0))