Geometry service BufferGeodesic method

The BufferGeodesic method generates buffers around input features to specified geodesic distances. A geodesic distance is the shortest path between two points on an ellipsoid and is shown accurately on the Earth's surface. The distances can be specified in any linear unit of measure. Geometries buffered at a given distance can optionally be unioned together.

Buffer (SpatialReference InSpatialReference, SpatialReference OutSpatialReference, double[] Distances, double Deviation, Unit Unit, boolean UnionResults, Geometry[] InGeometryArray)

Parameter

Description

InSpatialReference

SpatialReference of the geometries in the InGeometryArray. Cannot be null.

OutSpatialReference

SpatialReference of the geometry returned from the buffer operation. Can be null.

Distances

An array of double values. Each value specifies a distance to buffer the input geometries.

MaxDeviation

The maximum distance between vertices in the buffer polygon.

LinearUnit

The units for each distance specified in the Distances array (optional).

UnionResults

If false, each buffer polygon will be added to the output Geometry array separately. If true, then all geometries buffered at a given distance will be unioned into a single (possibly multipart) polygon and included in the output Geometry array.

InGeometryArray

The array of Geometry to be buffered by each distance in the array Distances. All geometries are assumed to be in the coordinate system InSpatialReference.

Return Value

An array of Geometry (Geometry[]) of type Polygon.

Remarks

The OutSpatialReference can be null in which case the InSpatialReference is used for output. Distances can be specified with a separate unit of measure defined by the Unit parameter to the method. For example, the buffer distances can be specified in feet and the coordinates of the output geometries can be specified in meters, although both the buffer and output geometry share the same spatial reference.

The SpatialReference property for all returned geometry will be null. It is the consumer’s responsibility to assign the spatial reference to each geometry returned, if desired. In this case, the spatial reference is assumed to be the output spatial reference defined for the Buffer operation. Geodesic buffers may appear unusual on a flat map, but when displayed on a globe these buffers will look correct. You can use the ArcGlobe or ArcGIS Explorer Desktop applications to view geographic data on a three-dimensional globe.

2/28/2020