すべてのプロダクト
Search
ドキュメントセンター

ApsaraDB RDS:ST_Envelope

最終更新日:Mar 29, 2026

ジオメトリオブジェクトの最小バウンディングボックスをポリゴンとして返します。

構文

geometry ST_Envelope(geometry g1);

パラメーター

パラメーター説明
g1ジオメトリオブジェクト。

注意事項

  • バウンディングボックスの座標は FLOAT8 値として返されます。

  • バウンディングボックスは、次の順序で 5 つのコーナーポイントによって定義されるポリゴンとして表現されます:(MINX, MINY)、(MINX, MAXY)、(MAXX, MAXY)、(MAXX, MINY)、(MINX, MINY)。

  • 垂直線やポイントなど、退化した入力の場合、この関数はポリゴンよりも低いディメンションのジオメトリ(LineString またはポイント)を返します。

使用例

標準ケース: 対角線のラインセグメントは、長方形のバウンディングボックスを返します。

SELECT ST_AsText(ST_Envelope('LINESTRING(0 0,2 2)'::geometry));

出力:

           st_astext
--------------------------------
 POLYGON((0 0,0 2,2 2,2 0,0 0))
(1 row)

退化ケース: 垂直線セグメントには幅がないため、バウンディングボックスは LineString に退化します。

SELECT ST_AsText(ST_Envelope('LINESTRING(0 0,0 2)'::geometry));

出力:

      st_astext
---------------------
 LINESTRING(0 0,0 2)
(1 row)