Chevron Down
Table of Contents
Chevron DownOverview
Chevron DownInteractive Examples
Chevron DownAPI Reference (Modes)
Chevron DownAPI Reference (Overlays)
Chevron DownAPI Reference (Map GL Draw)

Overview provides editable and interactive map overlay layers, built using the power of

Design Goals aspires to be an ultra-performant, fully 3D-enabled GeoJSON editing system primarily focused on geospatial editing use cases.

  • Maximal rendering and editing performance, without need for complex application logic (such as splitting data into subgroups etc).
  • Target performance: Editing at 60fps (e.g. dragging sub objects) in GeoJSON payloads with 100K features (points, lines or polygons).
  • Handles GeoJSON corner cases, e.g. automatically changing object types from Polygon to MultiPolygon when addition polygons are added.
  • Fully 3D enabled (Can e.g. use WebGL z-buffer so that lines being rendered are properly occluded by other geometry).
  • Seamless integration with and all geospatial layers, allowing for GeoJSON editing to be interleaved with rich 3D visualizations.
  • Handle all aspects of event handling, including touch screen support.


You should strongly consider

  • You want a full-featured, ultra-high-performance editing solution for GeoJson.
  • You are already using e.g. or react-map-gl.

You may want to look at alternatives if:

  • If you have very simple editing requirements (just a simple polygon etc)
  • If you don't want to use in your project.

If is more than what you need (e.g. in terms of bundle size), and you may want to look at other solutions, e.g. the simple polygon editor overlay being developed in react-map-gl.

That said, if you are already using the additional overhead of is small, and the seamless integration with should be valuable.

Quick Overview of the API


EditableGeoJsonLayer is implemented as a layer. It provides the ability to view and edit multiple types of geometry formatted as GeoJSON (an open standard format for geometry) including polygons, lines, and points.


When there is the ability to edit, callbacks are provided to inform you of edits.


The overlay layers are based on HTML and rendered by the browser. You can use them for complicated objects that follow map points. They are less performant but more flexible. For more details see Using Html Overlays