ST_Extent
Prev  7.18. Fonctions des boîtes de délimitation  Next

Name

ST_Extent — Fonction agrégée qui renvoie la boîte de délimitation des géométries.

Synopsis

box2d ST_Extent(geometry set geomfield);

Description

Une fonction agrégée qui renvoie une box2d boîte de délimitation qui délimite un ensemble de géométries.

Les coordonnées de la boîte de délimitation sont dans le système de référence spatiale des géométries d'entrée.

Le concept de ST_Extent est similaire à celui de SDO_AGGR_MBR d'Oracle Spatial/Locator.

[Note]

ST_Extent renvoie des boîtes avec seulement les coordonnées X et Y, même avec des géométries 3D. Pour renvoyer les coordonnées XYZ, utilisez ST_3DExtent.
[Note]

La valeur box3d renvoyée ne contient pas de SRID. Utilisez ST_SetSRID pour la convertir en une géométrie avec des métadonnées SRID. Le SRID est le même que celui des géométries d'entrée.

Amélioration : 2.0.0 introduction du support TIN, Triangles et surfaces polyédriques.

Cette fonction prend en charge les surfaces Polyhedral.

Cette fonction prend en charge les triangles et les réseaux irréguliers triangulés (TIN).

Exemples

[Note]

Les exemples ci-dessous utilisent le plan de l'État du Massachusetts (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))