# ee.FeatureCollection.union

Merges all geometries in a given collection into one and returns a collection containing a single feature with only an ID of 'union_result' and a geometry.

<br />

| Usage | Returns |
|---|---|
| `FeatureCollection.union(*maxError*)` | FeatureCollection |

| Argument | Type | Details |
|---|---|---|
| this: `collection` | FeatureCollection | The collection being merged. |
| `maxError` | ErrorMargin, default: null | The maximum error allowed when performing any necessary reprojections. If not specified, defaults to the error margin requested from the output. |

## Examples

### Code Editor (JavaScript)

```javascript
// FeatureCollection of power plants in Belgium.
var fc = ee.FeatureCollection('WRI/GPPD/power_plants')
            .filter('country_lg == "Belgium"');

print('Original FeatureCollection', fc);

// Merge all geometries into one. A FeatureCollection with a single feature
// with no properties is returned.
print('All geometries merged into one', fc.union(1));
```
Python setup

See the [Python Environment](https://developers.google.com/earth-engine/guides/python_install) page for information on the Python API and using
`geemap` for interactive development.

```python
import ee
import geemap.core as geemap
```

### Colab (Python)

```python
# FeatureCollection of power plants in Belgium.
fc = ee.FeatureCollection('WRI/GPPD/power_plants').filter(
    'country_lg == "Belgium"')

display('Original FeatureCollection:', fc)

# Merge all geometries into one. A FeatureCollection with a single feature
# with no properties is returned.
display('All geometries merged into one:', fc.union(1))
```