4.0.0 • Published 2 months ago

mapbox-gl-draw-circle-modes v4.0.0

Weekly downloads
-
License
MIT
Repository
github
Last release
2 months ago

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

Circle Mode Demo

Drag Circle mode

Drag Circle Mode Demo

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"
  }
}