https://github.com/jameslmilner/terra-draw

A library for drawing on maps that supports Mapbox, MapLibre, Google Maps, OpenLayers and Leaflet out the box
https://github.com/jameslmilner/terra-draw

draw drawing geodesic geojson geojson-editor geometry google-maps-api leaflet map mapbox-gl maplibre maplibre-gl-js maps polygon

Last synced: 8 days ago
JSON representation

A library for drawing on maps that supports Mapbox, MapLibre, Google Maps, OpenLayers and Leaflet out the box

• Host: GitHub
• URL: https://github.com/jameslmilner/terra-draw
• Owner: JamesLMilner
• License: mit
• Created: 2022-07-15T17:02:55.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2025-04-07T18:38:08.000Z (15 days ago)
• Last Synced: 2025-04-12T01:11:52.717Z (10 days ago)
• Topics: draw, drawing, geodesic, geojson, geojson-editor, geometry, google-maps-api, leaflet, map, mapbox-gl, maplibre, maplibre-gl-js, maps, polygon
• Language: TypeScript
• Homepage: https://terradraw.io
• Size: 9.27 MB
• Stars: 659
• Watchers: 5
• Forks: 67
• Open Issues: 36
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        

  

  

  



![Terra Draw CI Badge](https://github.com/JamesLMilner/terra-draw/actions/workflows/ci.yml/badge.svg)

[![npm version](https://badge.fury.io/js/terra-draw.svg)](https://badge.fury.io/js/terra-draw)

Frictionless map drawing across mapping libraries.

Terra Draw centralizes map drawing logic and provides a host of out-of-the-box drawing modes that work across different JavaScript mapping libraries. It also allows you to bring your own modes!

![An example of drawing geodesic lines using Terra Draw with Leaflet](./assets/readme.gif)

### Library Support

Terra Draw uses the concept of 'adapters' to allow it to work with a host of different mapping libraries. Built-in adapters are currently exposed as different packages in this monorepo; you can find out more in [the adapters guide](./guides/3.ADAPTERS.md). The currently supported libraries are:

|  Library                                                                                    | Version supported |           npm package            |

|---------------------------------------------------------------------------------------------|-------------------|----------------------------------|

|  [Leaflet](https://leafletjs.com/)                                                          |        v1         | terra-draw-leaflet-adapter       |

|  [OpenLayers](https://openlayers.org/)                                                      |        v10        | terra-draw-openlayers-adapter    |

|  [MapLibre GL JS](https://maplibre.org/maplibre-gl-js/docs/)                                |        v4/5       | terra-draw-maplibre-gl-adapter   |

|  [Google Maps JS API](https://developers.google.com/maps/documentation/javascript/overview) |        v3         | terra-draw-google-maps-adapter   |

|  [Mapbox GL JS](https://www.mapbox.com/mapbox-gljs)                                         |        v3         | terra-draw-mapbox-gl-adapter     |

|  [ArcGIS JavaScript SDK](https://developers.arcgis.com/javascript/latest/)                  |        v4         | terra-draw-arcgis-adapter        | 

### Getting Started

Please see the [the getting started guide](./guides/1.GETTING_STARTED.md) - this provides a host of information on how to get up and running with Terra Draw.

### Development & Contributing

* For development, please see the [the development documentation](./guides/7.DEVELOPMENT.md)

* For guidance on contributing, please see the [the contributing documentation](./guides/7.DEVELOPMENT.md#contributing)

### Project Website

You can check out the official Terra Draw website at [terradraw.io](https://www.terradraw.io). If you are interested in contributing to the website please see [this repository](https://www.github.com/JamesLMilner/terra-draw-website).

### Contact

Email: [[email protected]](mailto:[email protected])

### License

MIT