ST_Extent
Prev  7.18. バウンディングボックス関数  Next

Name

ST_Extent — ジオメトリのバウンディングボックスを返す集約関数です。

Synopsis

box2d ST_Extent(geometry set geomfield);

説明

ジオメトリの集合のbox2dバウンディングボックスを返す集約関数です。

バウンディングボックスの座標は、入力ジオメトリの空間参照系に従います。

ST_ExtentはOracle Spatial/LocatorのSDO_AGGR_MBRと似た発想のものです。

[Note]

ST_Extentは、3次元ジオメトリであってもX値とY値だけを持つボックスを返します。Z値も得たいならST_3DExtentを使います。
[Note]

返されたbox3d値はSRIDを含みません。ST_SetSRIDでSRIDメタデータを持つジオメトリに変換して下さい。SRIDは入力ジオメトリと同じです。

Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。

この関数は多面体サーフェスに対応しています。

この関数は三角形と不規則三角網 (TIN)に対応しています。

例

[Note]

次に示す例では、フィート単位のマサチューセッツ州平面 (SRID=2249)を使っています。

 
SELECT ST_Extent(geom) as bextent FROM sometable;
                                         st_bextent
------------------------------------
BOX(739651.875 2908247.25,794875.8125 2970042.75)


--Return extent of each category of geometries
SELECT ST_Extent(geom) as bextent
FROM sometable
GROUP BY category ORDER BY category;

                                          bextent                       |         name
----------------------------------------------------+----------------
 BOX(778783.5625 2951741.25,794875.8125 2970042.75) | A
 BOX(751315.8125 2919164.75,765202.6875 2935417.25) | B
 BOX(739651.875 2917394.75,756688.375 2935866)      | C

 --Force back into a geometry
 -- and render the extended text representation of that geometry
SELECT ST_SetSRID(ST_Extent(geom),2249) as bextent FROM sometable;

                                bextent
--------------------------------------------------------------------------------
 SRID=2249;POLYGON((739651.875 2908247.25,739651.875 2970042.75,794875.8125 2970042.75,
 794875.8125 2908247.25,739651.875 2908247.25))