import * as bufferOperator from "@arcgis/core/geometry/operators/bufferOperator.js";
const bufferOperator = await $arcgis.import("@arcgis/core/geometry/operators/bufferOperator.js");
@arcgis/core/geometry/operators/bufferOperator
Creates planar buffers around 2D geometries. A planar buffer calculates the area around a geometry using the straight line distance between points based on a flat, two-dimensional surface. This is suitable for rendering smaller areas within a projected coordinate system where the curvature of the Earth can be ignored, such as when all features are contained in one UTM zone. Planar buffers can introduce distortions and inaccuracies when applied over larger areas.
Property Overview
| Name | Type | Summary | Object |
|---|---|---|---|
Indicates if the operator supports input geometries that contain curves. | bufferOperator |
Property Details
-
supportsCurves
PropertysupportsCurves Booleanreadonly -
Indicates if the operator supports input geometries that contain curves. The value will always be
true. This will produce densified output geometries.
Method Overview
| Name | Return Type | Summary | Object |
|---|---|---|---|
Creates a buffer around the input geometry. | bufferOperator | ||
Creates a buffer around the input geometries. | bufferOperator |
Method Details
-
Creates a buffer around the input geometry.
Parametersgeometry GeometryUnionThe input geometry to be buffered.
distance NumberThe buffer distance for the geometry. Unless the
unitoption is set, the default is the geometry's spatial reference unit.options ObjectoptionalAdditional options.
Specificationunit LengthUnitoptionalThe length unit of the buffer distance. The default is the input geometry's spatial reference unit. An error will be thrown if this is set for Geographic Coordinate Systems.
ReturnsExample// Buffer a polyline geometry const bufferGeometry = bufferOperator.execute(polyline, 1000);
-
Creates a buffer around the input geometries.
Both
maxDeviationandmaxVerticesInFullCirclecontrol the quality of round joins that are in the buffers. The precision of each buffer ismaxDeviationunless the number of required vertices is too large.ParametersSpecificationgeometries GeometryUnion[]The input geometries to be buffered. All the geometries must have the same spatial reference.
The buffer distances for the geometries. If the size of this array is less than the number of geometries in the input
geometries, the last distance value is used for the rest of geometries. Unless theunitoption is set, the default is the geometries spatial reference unit.options ObjectoptionalAdditional options.
SpecificationmaxDeviation NumberoptionalDefault Value: NaNThe max deviation of the result buffer from the true buffer. When the value is NaN, internal logic is used to select deviation based on the buffer distance. Unless the
unitoption is set, the default is the geometries spatial reference unit.maxVerticesInFullCircle NumberoptionalDefault Value: 96The maximum number of vertices in the polygon produced from a buffered point.
union BooleanoptionalDefault Value: falseIndicates if the buffer geometries should be unioned. When set to
true, the output will be a single geometry.unit LengthUnitoptionalThe length unit of the buffer distances and max deviation. The default is the input geometry's spatial reference unit. An error will be thrown if this is set for Geographic Coordinate Systems.
Returns