|Project Name||Stars||Downloads||Repos Using This||Packages Using This||Most Recent Commit||Total Releases||Latest Release||Open Issues||License||Language|
|Countries||5,709||399||77||21 days ago||21||April 04, 2020||37||odbl-1.0||PHP|
|World countries in JSON, CSV, XML and Yaml. Any help is welcome!|
|Tools for editing Shapefile, GeoJSON, TopoJSON and CSV files|
|Awesome Geojson||1,983||a month ago||2||cc0-1.0|
|GeoJSON utilities that will make your life easier.|
|Admdongkor||373||17 days ago||2|
|대한민국 행정동 경계 파일|
|🔁 A tool for merging data from CSV, JSON, Geo- and TopoJSON files|
|Atlas Make||29||6 years ago||1||August 27, 2016||1||Makefile|
|Makefiles for building geo/topojson & csv from public Shape files 🌎|
|D3 Topojson Data Guide||9||7 years ago|
|How to wrangle your data into a useable TopoJSON format for making D3 visualizations|
|Ehak||5||5 years ago||3||Shell|
|Spatial data for Estonian Administrative and Settlement Classification in JSON and CSV formats|
|Sfm Proxy||5||6 years ago||23||mit||Ruby|
|Security Force Monitor CSV proxy|
|GeoJSON conversion with ease and consistency|
Mapshaper supports essential map making tasks like simplifying shapes, editing attribute data, clipping, erasing, dissolving, filtering and more.
See the project wiki for documentation on how to use mapshaper.
To suggest improvements, add an issue.
Mapshaper includes several command line programs, which can be run under Mac OS X, Linux and Windows.
mapshaperRuns mapshaper commands.
mapshaper-xlWorks the same as
mapshaper, but runs with more RAM to support larger files.
mapshaper-guiRuns the mapshaper Web interface locally.
The project wiki has an introduction to using the command line tool that includes many simple examples.
For a detailed reference, see the Command Reference.
Visit the public website at www.mapshaper.org or use the web UI locally via the
All processing is done in the browser, so your data stays private, even when using the public website.
The web UI works in recent desktop versions of Chrome, Firefox, Safari and Internet Explorer. Safari before v10.1 and IE before v10 are not supported.
rmapshaper is an R package written by Andy Teucher that gives R users access to many of mapshaper's editing commands.
Here are resources for using mapshaper with Docker, provided by Christian Weiss.
You can find a number of mapshaper tutorials online, including a two part guide to command line cartography by Dylan Moriarty and this introduction by Jack Dougherty.
Firefox is able to load Shapefiles and GeoJSON files larger than 1GB. Chrome has improved in recent versions, but is still prone to out-of-memory errors when importing files larger than several hundred megabytes.
Command line interface
There are hard limits for reading and writing most file types. The maximum output size of a single file of any type is 2GB. Some file types (GeoJSON, CSV, .shp, .dbf) are read incrementally, so much larger files can be imported.
You can use
mapshaper-xl as a replacement for the standard
mapshaper program to allocate more heap memory (8GB by default). You can allocate even more memory like this:
mapshaper-xl 20gb [commands].
Another option is to run Node directly with the
--max-old-space-size option. The following example (Mac or Linux) allocates 16GB of heap memory:
$ node --max-old-space-size=16000 `which mapshaper` <mapshaper commands>
Mapshaper requires Node.js.
With Node installed, you can install the latest release version of mapshaper using npm. Install with the "-g" flag to make the executable scripts available systemwide.
npm install -g mapshaper
To install and run the latest development code from github:
git clone [email protected]:mbloch/mapshaper.git cd mapshaper npm install # install dependencies npm run build # bundle source code files npm link # (optional) add global symlinks so scripts are available systemwide
From the project directory, run
npm run build to build both the cli and web UI modules.
npm test to run mapshaper's tests.
This software is licensed under MPL 2.0.
According to Mozilla's FAQ, "The MPL's ‘file-level’ copyleft is designed to encourage contributors to share modifications they make to your code, while still allowing them to combine your code with code under other licenses (open or proprietary) with minimal restrictions."
My colleagues at The New York Times, for countless suggestions, bug reports and general helpfulness.
Mark Harrower, for collaborating on the original "MapShaper" program at the University of Wisconsin–Madison.