ST_Extent
Prev  7.18. Bounding Box-Funktionen  Next

Name

ST_Extent — Aggregatfunktion, die den Begrenzungsrahmen von Geometrien zurückgibt.

Synopsis

box2d ST_Extent(geometry set geomfield);

Beschreibung

Eine aggregierte Funktion, die eine box2d Bounding Box zurückgibt, die einen Satz von Geometrien begrenzt.

Die Bounding-Box-Koordinaten sind im räumlichen Bezugssystem der Eingabegeometrien.

ST_Extent ist vom Konzept her ähnlich dem SDO_AGGR_MBR von Oracle Spatial/Locator.

[Note]

ST_Extent gibt auch bei 3D-Geometrien nur Boxen mit X- und Y-Ordinaten zurück. Um XYZ-Ordinaten zurückzugeben, verwenden Sie ST_3DExtent.
[Note]

Der zurückgegebene Wert box3d enthält keinen SRID. Verwenden Sie ST_SetSRID, um ihn in eine Geometrie mit SRID-Metadaten umzuwandeln. Der SRID ist derselbe wie bei den Eingabegeometrien.

Erweiterung: Mit 2.0.0 wurde die Unterstützung für polyedrische Oberflächen, Dreiecke und TIN eingeführt.

Diese Funktion unterstützt polyedrische Flächen.

Diese Funktion unterstützt Dreiecke und dreieckige unregelmäßige Netzoberflächen (TIN).

Beispiele

[Note]

Die folgenden Beispiele verwenden Massachusetts State Plane ft (SRID=2249)

 
SELECT ST_Extent(geom) AS bextent FROM sometable;
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

This example converts the extent back into a geometry and renders its extended text representation.

SELECT ST_SetSRID(ST_Extent(geom),2249) AS bextent FROM sometable;
SRID=2249;POLYGON((739651.875 2908247.25,739651.875 2970042.75,794875.8125 2970042.75,
 794875.8125 2908247.25,739651.875 2908247.25))