ST_Extent
Prev  7.18. Bounding Box Functions  Next

Name

ST_Extent — Funzione aggregata che restituisce il rettangolo di selezione delle geometrie.

Synopsis

box2d ST_Extent(geometry set geomfield);

Descrizione

Una funzione aggregata che restituisce un rettangolo di selezione box2d che delimita un insieme di geometrie.

Le coordinate del rettangolo di selezione sono nel sistema di riferimento spaziale delle geometrie in ingresso.

ST_Extent è simile nel concetto a SDO_AGGR_MBR di Oracle Spatial/Locator.

[Note]

ST_Extent restituisce rettangoli con le sole ordinate X e Y anche con le geometrie 3D. Per restituire le ordinate XYZ, utilizzare ST_3DExtent.
[Note]

Il valore box3d restituito non include un SRID. Utilizzare ST_SetSRID per convertirlo in una geometria con metadati SRID. Il SRID è lo stesso delle geometrie di input.

Migliorato: Nella 2.0.0 è stato introdotto il supporto per le superfici poliedriche, i triangoli e i TIN.

Questa funzione supporta le Polyhedral Surface.

Questa funzione supporta i Triangoli e le Triangulated Irregular Network Surfaces (TIN).

Esempi

[Note]

Examples below use Massachusetts State Plane ft (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))