名稱

ST_3DExtent — 聚合函數,返回幾何圖形的 3D 邊界框。

概要

box3d ST_3DExtent(geometry 集合 geomfield);

描述

一個聚合函數,返回一個 box3d (包含 Z 坐標) 邊界框,該邊界框包圍了一組幾何圖形。

邊界框的坐標是以輸入幾何圖形的空間參考系統為準。

[Note]

返回的 box3d 值不包含 SRID。請使用 ST_SetSRID 將其轉換為具有 SRID 元數據的幾何圖形。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