Tools overview

All drawing tools and editing modes at a glance.

Element Editor organises its capabilities into two groups: drawing tools that create new features, and editing modes that operate on existing ones. The sections below give you a quick reference; each tool and mode has its own detailed page.

The floating toolbar with the drawing tools over a dark map, the cursor on the line tool.
The drawing tools live in the floating toolbar.

Drawing tools

ToolDefault keyProducesPersonality
Area ('polygon')GPolygonVersatile
LineLLineStringStraightforward
PointPPointMinimal
RectangleRPolygon (_drawType: 'rectangle')Principled
CircleOPolygon (_drawType: 'circle')Existentially complicated
FreehandFLineString or Polygon (simplified)Chaotic good
RouteCLineString (_drawType: 'route')Opinionated
PickerXThe OpenStreetMap shape you clickBorrowed

Note: Default keys are configurable. Press K to open the shortcuts panel and remap any tool key. The keys above reflect factory defaults; your users may have changed them.

Editing modes

ModeActivationWhat it does
Vertex editingDouble-click feature or EnterDrag, insert, and delete individual coordinates
TransformAScale and rotate selected features
SelectionClick / Shift+click / Shift+dragSelect one or more features for further operations
SnappingActive automatically (configurable)Constrains cursor to nearby vertices and edges while drawing or editing
Boolean operationsUnion, subtract, intersect, exclude: their own buttons next to the editing toolbar, with 2+ areas selected (union also joins 2+ lines). Cut hole (H) and slice (J): editing toolbar, with exactly 1 area selectedUnion, intersect, subtract, exclude, cut hole, slice
MeasureMMeasure distances and areas without adding features to the map

Geometry processing tools

These tools modify the geometry of a selected feature.

ToolWhat it does
BufferExpand or contract a polygon, or turn a line into a corridor polygon, by a fixed distance (−500 m to +2,000 m; lines 0 m up)
SimplifyReduce vertex count using the Ramer–Douglas–Peucker algorithm
SmoothRound and soften a polygon or line by adding vertices (1–5 passes)
Break apartSplit a Multi* or GeometryCollection feature into one feature per part
MergeCombine 2+ same-type features into a single Multi* feature

The editing toolbar adapts to the current selection — only relevant actions appear:

  • Point selected → Duplicate, Delete
  • MultiPoint / GeometryCollection selected → Transform, Break apart, Duplicate, Delete
  • LineString / MultiLineString selected → Transform, Simplify, Smooth, Buffer, Duplicate, Delete (plus Break apart on Multi*)
  • Polygon / MultiPolygon selected → Transform, Cut hole, Slice, Simplify, Smooth, Buffer, Duplicate, Delete (plus Break apart on Multi*)
  • Multiple features selected → Transform, Merge, Duplicate, Delete, plus Union / Subtract / Intersect / Exclude unless they are all points (subtract, intersect and exclude need all areas)

Detailed pages

The _drawType foreign member

Three tools — rectangle, circle, and route — produce standard GeoJSON geometry types (Polygon or LineString) but attach a _drawType foreign member to record the original drawing intent. Element uses it to warn before an edit would turn the shape into a plain polygon or line (vertex edit on a circle, rectangle or route; route alignment warnings when transforming). The first committed point change removes the tag.

{
  "type": "Feature",
  "geometry": { "type": "Polygon", "coordinates": [[...]] },
  "properties": {},
  "_drawType": "circle"
}

Do not strip _drawType when round-tripping data through a backend. Without it, Element treats the shape as a plain polygon and removes the associated constraints.