GeodeticBuffer(Geometry,Double,LinearUnit,Double,GeodeticCurveType) Method

In This Topic

Creates a geodetic buffer polygon at the specified geodetic distance around the given geometry.

Syntax

C#
Visual Basic (Declaration)

Geometry GeodeticBuffer( 
   Geometry geometry,
   double distance,
   LinearUnit distanceUnit,
   double maxDeviation,
   GeodeticCurveType curveType
)

Overloads Function GeodeticBuffer( _
   ByVal geometry As Geometry, _
   ByVal distance As Double, _
   ByVal distanceUnit As LinearUnit, _
   ByVal maxDeviation As Double, _
   ByVal curveType As GeodeticCurveType _
) As Geometry

Parameters

geometry: The input geometry. Cannot be null and its spatial reference cannot be null.
distance: The distance to used to buffer the geometry.
distanceUnit: The unit of the buffer distance. If null, then the buffer distance is in meters.
maxDeviation: The deviation in meters to use for convergence. The geodetic arcs of the resulting buffer will be closer than the max deviation of the true buffer. Pass in NaN or a value less than or equal to 0 to use the default deviation which will be the maximum of 0.01 meters and 0.2% of the buffer distance.
curveType: The GeodeticCurveType of the segments. If the curveType is GeodeticCurveType::ShapePreserving, then the segments are densified in the spatial reference where they are defined before buffering.

Return Value

A polygon representing the buffered area. If the input geometry is empty, then an empty polygon is returned.

Exceptions

Exception	Description
System.ArgumentNullException	Geometry is null or geometry's spatial reference is null.
System.NotImplementedException	The method is not implemented for GeometryBag.
System.NotImplementedException	The method is not implemented for Multipatch.
System.ArgumentException	The buffer distance must be a valid floating point number.
System.NotImplementedException	Spatial reference of geometryis an image coordinate system.

Remarks

If the buffer distance is zero and the input geometry is a polygon, then the polygon is returned unchanged. If the input geometry is an envelope, then a polygon created from the envelope is returned. Otherwise, an empty polygon is returned.

A negative buffer distance can be used to create a buffer inside a polygon or an envelope. Using a negative buffer distance shrinks the geometry's boundary by the distance specified. Note that if the absolute value of the negative distance is too large, the buffer may collapse to an empty polygon. If a negative buffer distance is used and the input geometry is not a polygon or an envelope, then an empty polygon is returned.

Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3.4 or higher.

Reference

IGeometryEngine Interface
IGeometryEngine Members
Overload List

Send feedback