ST_Union

Returns a geometry or geography that represents the point set union of two geometries or geographies.

Usage

geometry ST_Union(geomA: geometry, geomB: geometry)
geography ST_Union(geogA: geography, geogB: geography)

Arguments

• geogA (geography): Input geography
• geogB (geography): Input geography
• geomA (geometry): Input geometry
• geomB (geometry): Input geometry

Examples

SELECT ST_Union(
    ST_GeomFromWKT('POLYGON ((0 0, 2 0, 2 2, 0 2, 0 0))'),
    ST_GeomFromWKT('POLYGON ((1 0, 3 0, 3 2, 1 2, 1 0))')
);

┌──────────────────────────────────────────────────────────────────────────────┐
│ st_union(st_geomfromwkt(Utf8("POLYGON ((0 0, 2 0, 2 2, 0 2, 0 0))")),st_geom │
│            fromwkt(Utf8("POLYGON ((1 0, 3 0, 3 2, 1 2, 1 0))")))…            │
╞══════════════════════════════════════════════════════════════════════════════╡
│ POLYGON((0 0,0 2,1 2,2 2,3 2,3 0,2 0,1 0,0 0))                               │
└──────────────────────────────────────────────────────────────────────────────┘

SELECT ST_Union(
    ST_GeogFromWKT('POLYGON ((0 0, 2 0, 2 2, 0 2, 0 0))'),
    ST_GeogFromWKT('POLYGON ((1 0, 3 0, 3 2, 1 2, 1 0))')
);

┌──────────────────────────────────────────────────────────────────────────────┐
│ st_union(st_geogfromwkt(Utf8("POLYGON ((0 0, 2 0, 2 2, 0 2, 0 0))")),st_geog │
│            fromwkt(Utf8("POLYGON ((1 0, 3 0, 3 2, 1 2, 1 0))")))…            │
╞══════════════════════════════════════════════════════════════════════════════╡
│ POLYGON((1.4999999999999036 2.0002283050233185,0 2,0 0,1 0,2 0,3.0000000000… │
└──────────────────────────────────────────────────────────────────────────────┘