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.