Beskrivning

Samlar geometrier till en geometrisamling. Resultatet är antingen en Multi* eller en GeometryCollection, beroende på om indatageometrierna har samma eller olika typer (homogena eller heterogena). De ingående geometrierna lämnas oförändrade inom samlingen.

Variant 1: accepterar två inmatningsgeometrier

Variant 2: accepterar en array av geometrier

Variant 3: Aggregerad funktion som tar emot en rad med geometrier.

	ST_Collect löser inte upp gränser eller överlappningar. Att samla överlappande polygoner kan skapa en ogiltig MultiPolygon. Använd i stället ST_Union om resultatet måste vara en giltig polygonal geometri med sammanslagna överlappningar. ST_Union delar också linestrings vid skärningar och kan returnera en enda geometri efter att gränser lösts upp.

Om någon indatageometri är en samling (Multi* eller GeometryCollection) returnerar ST_Collect en GeometryCollection, eftersom det är den enda typ som kan innehålla kapslade samlingar. Undvik detta genom att använda ST_Dump i en underfråga för att expandera indatasamlingar till deras atomära element (se exemplet nedan).

Tillgänglighet: 1.4.0 - ST_Collect(geomarray) introducerades. ST_Collect förbättrades för att hantera fler geometrier snabbare.

Denna funktion stöder 3d och kommer inte att tappa z-index.

Denna metod stöder cirkulära strängar och kurvor.

Exempel

Variant med två indata.

Samla 2D-punkter.

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

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

0104000000020000000101000000000000000000F03F0000000000000040010100000000000000000000C00000000000000840

Figur

Samla 3D-punkter.

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

MULTIPOINT(1 2 3,1 2 4)

0104000080020000000101000080000000000000F03F000000000000004000000000000008400101000080000000000000F03F00000000000000400000000000001040

Figur

Samla kurvor.

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

Figur

Matrisvariant.

Använda en array constructor för en subquery.

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

Använda en array constructor för värden.

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

Figur

Aggregatvariant.

Skapa flera samlingar genom att gruppera geometrier i en tabell.

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

Se även

ST_Dump, ST_Union