Name

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

Übersicht

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.

[Anmerkung]

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.

[Anmerkung]

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

[Anmerkung]

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

Code
SELECT ST_Extent(geom) AS bextent FROM sometable;
Ausgabe von Rastern
BOX(739651.875 2908247.25,794875.8125 2970042.75)

Return extent of each geometry category.

Code
SELECT ST_Extent(geom) as bextent
FROM sometable
GROUP BY category ORDER BY category;
Ausgabe von Rastern
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.

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