SqlGeography.BufferWithTolerance(Double, Double, Boolean) Method

Definition

Returns a geometric object representing the union of all point values whose distance from a SqlGeography instance is less than or equal to a specified value, allowing for a specified tolerance.

[Microsoft.SqlServer.Server.SqlMethod(IsDeterministic=true, IsPrecise=false)]
public Microsoft.SqlServer.Types.SqlGeography BufferWithTolerance (double distance, double tolerance, bool relative);
[<Microsoft.SqlServer.Server.SqlMethod(IsDeterministic=true, IsPrecise=false)>]
member this.BufferWithTolerance : double * double * bool -> Microsoft.SqlServer.Types.SqlGeography
Public Function BufferWithTolerance (distance As Double, tolerance As Double, relative As Boolean) As SqlGeography

Parameters

distance
Double

Is a double that specifies the distance from the SqlGeography instance around which to calculate the buffer.

tolerance
Double

Is a double that specifies the tolerance of the buffer distance.The tolerance value refers to the maximum variation in the ideal buffer distance for the returned linear approximation.For example, the ideal buffer distance of a point is a circle, but this must be approximated by a polygon. The smaller the tolerance, the more points the polygon will have, which increases the complexity of the result, but decreases the error.

relative
Boolean

Is a bool that specifies whether the tolerance value is relative or absolute. If true, then tolerance is relative and is calculated as the product of the tolerance parameter and the angular extent * equatorial radius of the ellipsoid. If false, tolerance is absolute and the tolerance value is the absolute maximum variation in the ideal buffer distance for the returned linear approximation.

Returns

A SqlGeography instance representing the union of all point values whose distance from a SqlGeography instance is less than or equal to a specified value.

Attributes

Applies to