名称

ST_3DExtent — 聚合函数,返回几何图形的 3D 边界框。

语法

box3d ST_3DExtent(几何图形集 geomfield);

说明

聚合函数,返回一个 box3d(包括 Z 坐标)边界框,该边界框对一组几何图形进行限定。

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

[Note]

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

增强:2.0.0 引入了对多面体曲面、三角形和 TIN 的支持。

更改:2.0.0 在之前的版本中,这称为 ST_Extent3D

此函数支持 3D,并且不会删除 z 索引。

此方法支持圆形字符串和曲线。

此函数支持多面体曲面。

此函数支持三角形和三角不规则网格曲面 (TIN)。

示例

SELECT ST_3DExtent(foo.geom) As b3extent
FROM (SELECT ST_MakePoint(x,y,z) As geom
	FROM generate_series(1,3) As x
		CROSS JOIN generate_series(1,2) As y
		CROSS JOIN generate_series(0,2) As Z) As foo;
	  b3extent
--------------------
 BOX3D(1 1 0,3 2 2)

--Get the extent of various elevated circular strings
SELECT ST_3DExtent(foo.geom) As b3extent
FROM (SELECT ST_Translate(ST_Force_3DZ(ST_LineToCurve(ST_Buffer(ST_Point(x,y),1))),0,0,z) As geom
	FROM generate_series(1,3) As x
		CROSS JOIN generate_series(1,2) As y
		CROSS JOIN generate_series(0,2) As Z) As foo;

	b3extent
--------------------
 BOX3D(1 0 0,4 2 2)
		

另请参见

ST_ExtentST_Force3DZST_SetSRID