Description

Rassemble les géométries dans une collection de géométries. Le résultat est soit un Multi*, soit une GeometryCollection, selon que les géométries d'entrée ont des types identiques ou différents (homogènes ou hétérogènes). Les géométries d'entrée restent inchangées dans la collection.

Variante 1: accepte géométries en entrée

Variante 2: accepte un tableau de géométries

Variante 3: fonction agrégée acceptant un ensemble de géométries.

	ST_Collect does not dissolve boundaries or resolve overlaps. Collecting overlapping polygons can produce an invalid MultiPolygon. If the result must be a valid polygonal geometry with overlaps merged, use ST_Union instead. ST_Union also splits linestrings at intersections and may return a single geometry after dissolving boundaries.

If any input geometry is a collection (Multi* or GeometryCollection), ST_Collect returns a GeometryCollection, since that is the only type which can contain nested collections. To prevent this, use ST_Dump in a subquery to expand input collections to their atomic elements (see example below).

Disponibilité : 1.4.0 - ST_Collect(geomarray) a été introduit. ST_Collect a été amélioré pour gérer plus de géométries plus rapidement.

Cette fonction prend en charge la 3D et ne supprime pas l'indice z.

Cette méthode prend en charge les types Circular String et Curve.

Exemples

Two-input variant.

Collectez les points 2D.

SELECT ST_Collect(
    'POINT(1 2)',
    'POINT(-2 3)' );

MULTIPOINT((1 2),(-2 3))

0104000000020000000101000000000000000000F03F0000000000000040010100000000000000000000C00000000000000840

Figure

Collectez les points 3D.

SELECT ST_Collect(
        'POINT(1 2 3)',
        'POINT(1 2 4)' );

MULTIPOINT(1 2 3,1 2 4)

0104000080020000000101000080000000000000F03F000000000000004000000000000008400101000080000000000000F03F00000000000000400000000000001040

Figure

Collectez les courbes.

SELECT ST_Collect(
        'CIRCULARSTRING(220268 150415,220227 150505,220227 150406)',
        'CIRCULARSTRING(220227 150406,2220227 150407,220227 150406)');

MULTICURVE(CIRCULARSTRING(220268 150415,220227 150505,220227 150406),
CIRCULARSTRING(220227 150406,2220227 150407,220227 150406))

010B000000020000000108000000030000000000000060E30A4100000000785C02410000000018E20A4100000000485F02410000000018E20A4100000000305C02410108000000030000000000000018E20A4100000000305C02410000008061F0404100000000385C02410000000018E20A4100000000305C0241

Figure

Array variant.

Utilisation d'un constructeur de tableau pour une sous-requête.

SELECT ST_Collect(ARRAY(SELECT geom FROM sometable));

Utilisation d'un constructeur de tableau pour les valeurs.

SELECT ST_Collect(
        ARRAY[ 'LINESTRING(1 2,3 4)'::geometry,
            'LINESTRING(3 4,4 5)'::geometry ] ) As wktcollect;

MULTILINESTRING((1 2,3 4),(3 4,4 5))

010500000002000000010200000002000000000000000000F03F0000000000000040000000000000084000000000000010400102000000020000000000000000000840000000000000104000000000000010400000000000001440

Figure

Aggregate variant.

Création de collections multiples en regroupant les géométries dans une table.

SELECT stusps, ST_Collect(geom) AS geom
FROM (
  SELECT stusps, (ST_Dump(geom)).geom AS geom
  FROM somestatetable
) AS f
GROUP BY stusps;

Voir aussi

ST_Dump, ST_Union