SqlGeometry.Reduce Method (Double)

 

Returns an approximation of the given SqlGeometry instance produced by running the Douglas-Peucker algorithm on the instance with the given tolerance.

Namespace:   Microsoft.SqlServer.Types
Assembly:  Microsoft.SqlServer.Types (in Microsoft.SqlServer.Types.dll)

[SqlMethodAttribute(IsDeterministic = true, IsPrecise = false)]
public SqlGeometry Reduce(
	double tolerance
)

Parameters

tolerance
Type: System.Double

A double that represents the tolerance to input to the Douglas-Peucker algorithm.

Return Value

Type: Microsoft.SqlServer.Types.SqlGeometry

A SqlGeometry object that represents an approximation of the calling SqlGeometry within the specified tolerance.

For collection types, this algorithm operates independently on each SqlGeometry contained in the instance.

This algorithm does not modify Point instances.

On LineString instances, the Douglas-Peucker algorithm retains the original start and end points of the instance, and iteratively adds back the point from the original instance that most deviates from the result until no point deviates more than the given tolerance.

On Polygon instances, the Douglas-Peucker algorithm is applied independently to each ring. The method will produce a FormatException if the returned Polygon instance is not valid; for example, an invalid MultiPolygon instance is created if Reduce is applied to simplify each ring in the instance and the resulting rings overlap.

Return to top
Show: