mapbox-gl-draw-circle-modes
v4.0.0
Published
Provides multiple ways (modes) to draw a circle by extending mapbox-gl-draw
Downloads
49
Maintainers
Readme
mapbox-gl-draw-circle-modes
Extends mapbox-gl-draw library by providing custom modes for drawing and editing of a circle. Following are the available modes:
- CircleMode: User can click a point to create circle of fixed radius
- DragCircleMode: User can click a point and drag it to create a circle
- RadiusCircleMode: User can click two point to define center and radius of a circle
Demo
Circle mode
Drag Circle mode
Usage
Installation
npm install mapbox-gl-draw mapbox-gl-draw-circle-modes
import {
CircleMode,
DragCircleMode,
RadiusCircleMode,
DirectMode,
SimpleSelectMode,
} from 'mapbox-gl-draw-circle-modes';
// userProperties has to be enabled
const draw = new MapboxDraw({
defaultMode: "draw_circle",
userProperties: true,
modes: {
...MapboxDraw.modes,
draw_circle : CircleMode,
drag_circle : DragCircleMode,
radius_circle: RadiusCircleMode,
direct_select: DirectMode,
simple_select: SimpleSelectMode
}
});
// Add this draw object to the map when map loads
map.addControl(draw);
The default radius units are in kilometers and initial radius is 2km.
// Provide the default radius as an option to CircleMode
draw.changeMode('draw_circle', { initialRadiusInKm: 0.5 });
It fires the same events as the mapbox-gl-draw library. For more information follow this link.
Sample feature object returned in draw.create
event
{
"id": "e184898e58feaa5c2c56f20a178ffe2c",
"type": "Feature",
"properties": {
"isCircle": true,
"center": [
-0.2472604947478203,
51.53200220026099
],
"radiusInKm": 2
},
"geometry": {
"coordinates": [], // populated with 64 vertices used to render the circle
"type": "Polygon"
}
}