ST_BuildArea

ST_BuildArea
Précédent	7.14. Traitement des géométries	Suivant

Nom

ST_BuildArea — Crée une géométrie polygonale formée par le tracé d'une géométrie.

Synopsis

geometry ST_BuildArea(geometry geom);

Description

Crée une géométrie aréolaire formée par les lignes constitutives de la géométrie d'entrée. L'entrée peut être une LineString, MultiLineString, Polygon, MultiPolygon ou une GeometryCollection. Le résultat est un Polygone ou un MultiPolygone, en fonction de l'entrée. Si la ligne d'entrée ne forme pas de polygone, NULL est renvoyé.

Contrairement à ST_MakePolygon, cette fonction accepte les anneaux formés par plusieurs lignes et peut former un nombre quelconque de polygones.

Cette fonction convertit les anneaux intérieurs en trous. Pour transformer les anneaux intérieurs en polygones, utilisez ST_Polygonize.


Les lignes d'entrée doivent être correctement nouées pour que cette fonction fonctionne correctement. ST_Node peut être utilisé pour nouer des lignes. Si le réseau de lignes d'entrée est croisé, cette fonction produira des polygones non valides. ST_MakeValid peut être utilisé pour s'assurer que la sortie est valide.

Les lignes d'entrée doivent être correctement nouées pour que cette fonction fonctionne correctement. ST_Node peut être utilisé pour nouer des lignes.

Si le réseau de lignes d'entrée est croisé, cette fonction produira des polygones non valides. ST_MakeValid peut être utilisé pour s'assurer que la sortie est valide.

Disponibilité : 1.1.0

Exemples

Building an area from five input lines.

Code

WITH data(geom) AS (VALUES
   ('LINESTRING (180 40,30 20,20 90)'::geometry),
  ('LINESTRING (180 40,160 160)'::geometry),
  ('LINESTRING (160 160,80 190,80 120,20 90)'::geometry),
  ('LINESTRING (80 60,120 130,150 80)'::geometry),
  ('LINESTRING (80 60,150 80)'::geometry)
)
SELECT ST_BuildArea(ST_Collect(geom )) AS wkt
    FROM data;

Export de raster

POLYGON((180 40,30 20,20 90,80 120,80 190,160 160,180 40),(150 80,120 130,80 60,150 80))

01030000000200000007000000000000000080664000000000000044400000000000003E4000000000000034400000000000003440000000000080564000000000000054400000000000005E4000000000000054400000000000C067400000000000006440000000000000644000000000008066400000000000004440040000000000000000C0624000000000000054400000000000005E40000000000040604000000000000054400000000000004E400000000000C062400000000000005440

Figure

Create a donut from two circular polygons.

Code

WITH input AS (
  SELECT 'POINT(100 90)'::geometry AS geom
),
rings AS (
  SELECT ST_Buffer(geom, 25, 'quad_segs=1') AS inring,
         ST_Buffer(geom, 50, 'quad_segs=1') AS outring
  FROM input
)
SELECT inring AS inner_ring,
       outring AS outer_ring,
       ST_BuildArea(ST_Collect(inring, outring)) AS area
FROM rings;

Export de raster

-[ RECORD 1 ]-----
inner_ring | POLYGON((125 90,100 65,75 90,100 115,125 90))
outer_ring | POLYGON((150 90,100 40,50 90,100 140,150 90))
area       | POLYGON((150 90,100 40,50 90,100 140,150 90),(125 90,100 115,75 90,100 65,125 90))

010300000001000000050000000000000000405F400000000000805640000000000000594000000000004050400000000000C05240000000000080564000000000000059400000000000C05C400000000000405F400000000000805640 | 010300000001000000050000000000000000C0624000000000008056400000000000005940000000000000444000000000000049400000000000805640000000000000594000000000008061400000000000C062400000000000805640 | 010300000002000000050000000000000000C0624000000000008056400000000000005940000000000000444000000000000049400000000000805640000000000000594000000000008061400000000000C062400000000000805640050000000000000000405F40000000000080564000000000000059400000000000C05C400000000000C052400000000000805640000000000000594000000000004050400000000000405F400000000000805640

Figure

Input linework that crosses at non-endpoint intersections must be noded before building areas:

Code

WITH lines(geom) AS (VALUES
  ('LINESTRING(36 35,45 307)'::geometry),
  ('LINESTRING(30 290,390 280)'::geometry),
  ('LINESTRING(320 60,300 310)'::geometry),
  ('LINESTRING(20 60,320 60)'::geometry),
  ('LINESTRING(120 140,168 225)'::geometry),
  ('LINESTRING(140 220,220 150,120 170)'::geometry)
),
noded AS (
  SELECT ST_Node(ST_UnaryUnion(ST_Collect(geom))) AS geom FROM lines
)
SELECT ST_BuildArea(geom) AS area
FROM noded;

Export de raster

POLYGON((320 60,36.8 60,44.4 289.6,302.2 282.4,320 60),(156.9 205.3,135.2 167,220 150,156.9 205.3))

0103000000020000000500000000000000000074400000000000004E40E2E1E1E1E16942400000000000004E4036D964934D364640B1FB7CD7961972403326FD4447E372407FA2A32105A7714000000000000074400000000000004E400400000067B3D96C369B63400683C16030A869401D4324851AE760402D8CC54B94DE64400000000000806B400000000000C0624067B3D96C369B63400683C16030A86940

Figure

Voir aussi

ST_Collect, ST_MakePolygon, ST_MakeValid, ST_Node, ST_Polygonize, ST_BdPolyFromText, ST_BdMPolyFromText (wrappers de cette fonction avec l'interface standard de l'OGC)