名称

ST_Extent — 聚合函数,用于返回几何的边界框。

语法

box2d ST_Extent(几何集 geomfield);

说明

一个聚合函数,用于返回一个 box2d 边界框,该边界框包围一组几何。

边界框坐标位于输入几何的空间参考系中。

ST_Extent 在概念上类似于 Oracle Spatial/Locator 的 SDO_AGGR_MBR。

[Note]

即使是 3D 几何,ST_Extent 也只返回具有 X 和 Y 坐标的框。要返回 XYZ 坐标,请使用 ST_3DExtent

[Note]

返回的 box3d 值不包含 SRID。使用 ST_SetSRID 将其转换为具有 SRID 元数据的几何。SRID 与输入几何相同。

增强: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))
		

另请参见

ST_EstimatedExtentST_3DExtentST_SetSRID