dissolve

Description

Dissolves a FeatureCollection of polygon features, filtered by an optional property name:value. Note that multipolygon features within the collection are not supported

Parameters

Name	Type	Description
featureCollection	FeatureCollection<Polygon>	input feature collection to be dissolved
options?	Object	Optional parameters (default {})
options.propertyName?	string	features with the same propertyName value will be dissolved.

Returns

FeatureCollection<Polygon> a FeatureCollection containing the dissolved polygons

Examples

var features = turf.featureCollection([
  turf.polygon(
    [
      [
        [0, 0],
        [0, 1],
        [1, 1],
        [1, 0],
        [0, 0],
      ],
    ],
    { combine: "yes" },
  ),
  turf.polygon(
    [
      [
        [0, -1],
        [0, 0],
        [1, 0],
        [1, -1],
        [0, -1],
      ],
    ],
    { combine: "yes" },
  ),
  turf.polygon(
    [
      [
        [1, -1],
        [1, 0],
        [2, 0],
        [2, -1],
        [1, -1],
      ],
    ],
    { combine: "no" },
  ),
]);

var dissolved = turf.dissolve(features, { propertyName: "combine" });

Installation

$ npm install @turf/dissolve

import { dissolve } from "@turf/dissolve";
const result = dissolve(...);

$ npm install @turf/turf

import * as turf from "@turf/turf";
const result = turf.dissolve(...);