Mapshaper
Edit Shapefile, GeoJSON, TopoJSON and CSV files in the browser. Simplify, convert, and visualize geographic data.
Open the official app on mapshaper.org
This tool is hosted by its maintainers. Click below to open mapshaper.org in a new tab — it's their official demo.
Browse maps tools →What's next with Mapshaper?
Choose how you want to get started.
Use it free
Open the official tool or demo — no account needed.
Self-host it
Run the open-source version on your own infrastructure.
What is Mapshaper?
Mapshaper is an open-source geospatial data processing tool designed to edit, transform, and optimize geographic datasets such as Shapefile, GeoJSON, TopoJSON, and CSV files. Its primary purpose is to streamline workflows for developers, data scientists, and cartographers who need to manipulate large geospatial datasets for mapping applications. By enabling operations like simplification, clipping, and format conversion, Mapshaper addresses challenges related to data size, precision, and compatibility with web mapping platforms. It is particularly useful for reducing file complexity without losing critical spatial accuracy, making it a valuable tool for projects requiring efficient data handling. The tool is widely used in scenarios where geographic data needs to be optimized for performance, such as interactive maps or mobile applications. Mapshaper solves the problem of managing large datasets by providing lightweight processing capabilities that balance detail retention with computational efficiency. Its modular design allows users to apply specific operations like bounding box clipping or planar geometry calculations, ensuring flexibility for diverse use cases. The project’s open-source nature and active community contribute to its adoption in both academic and professional environments.
How it works
Mapshaper is a command-line and web-based tool for editing geospatial vector data. It focuses on simplifying, clipping, and transforming geographic features while preserving essential spatial relationships. The tool is particularly suited for tasks requiring precision in data reduction, such as preparing datasets for web mapping or analysis. Its primary purpose is to optimize geospatial data for performance and usability. By allowing users to adjust parameters like simplification tolerance or projection settings, Mapshaper ensures that datasets remain manageable without sacrificing critical geographic detail. Mapshaper supports operations such as simplification using the Douglas-Peucker algorithm, clipping to defined boundaries, and exporting to multiple formats including GeoJSON and TopoJSON. It also enables advanced features like planar geometry calculations, which treat coordinates as Cartesian rather than spherical, improving accuracy for certain projections. The tool can handle CSV files with geographic coordinates, converting them into structured vector formats.
How to use it
- 1Load a geospatial file (e.g., Shapefile or GeoJSON) via the web interface or command line. 2. Configure export settings, such as specifying the output format or enabling simplification parameters. 3. Apply operations like clipping, smoothing, or quantization using predefined commands. 4. Export the processed data to the desired format, ensuring compatibility with target platforms. Practical tips include using the command-line interface for automation, leveraging the 'no-quantization' option for high-precision outputs, and testing simplification tolerances to balance detail retention with file size.
What it can do
- Conversion
- JSON Processing
- CSV Processing
Use cases
Assumptions and limitations
Assumptions
- source: https://github.com/mbloch/mapshaper
- license: MPL-2.0 — free to use
- privacy: Opens an external demo
Limitations
- Limited support for complex geospatial analysis beyond basic transformation
- Browser compatibility issues may restrict web-based usage
- No built-in tools for raster data processing or spatial analysis
- Manual intervention required for advanced projection adjustments
- Smaller polygons may be removed during high-simplification operations
Understanding the result
Edit Shapefile, GeoJSON, TopoJSON and CSV files in the browser. Simplify, convert, and visualize geographic data.
Tool details
- Clearly flagged when a network request is needed.
- No account, no sign-up, and no tracking of your content.
- Powered by mapshaper (MPL-2.0).
- Built with
- mapshaper (mbloch/mapshaper)
- License
- MPL-2.0
- Runs locally
- No — requires a network request
- Verification
- Not yet verified
- Input
- JSON, CSV
- Output
- JSON, CSV, Converted Output
Built with mbloch/mapshaper. OpenToolVault provides the discovery and browser interface while crediting the original project maintainers.
- Built with
- mapshaper
- License
- MPL-2.0
Open-source project
OpenToolVault is an independent directory. We are not affiliated with or endorsed by this project.
References
- mbloch/mapshaper — GitHub Repository
Upstream project · GitHub
- MPL-2.0 License
Upstream project
Frequently asked
How does Mapshaper handle different geospatial formats?
Mapshaper supports direct editing of Shapefile, GeoJSON, TopoJSON, and CSV files containing geographic coordinates. It automatically interprets these formats during import, allowing users to apply operations like simplification or clipping. CSV files with latitude/longitude pairs are converted into structured vector data for further processing.
What simplification algorithm does Mapshaper use?
Mapshaper implements the Douglas-Peucker algorithm for line simplification, which reduces the number of vertices while maintaining the overall shape. This method calculates the maximum allowed deviation from the original line, ensuring that simplified features remain visually accurate. Users can adjust the precision parameter to control the trade-off between detail and file size.
How do I export data to a specific format?
To export data, select the desired file format (e.g., GeoJSON or TopoJSON) from the export menu. Specify options like bounding box constraints or simplification parameters in the command-line interface. For example, use 'precision=0.001' to define the simplification tolerance. The processed data is then saved to the specified output directory or clipboard.
How does Mapshaper compare to QGIS or PostGIS?
Mapshaper differs from QGIS and PostGIS by focusing on lightweight, command-line-driven processing rather than full-featured GIS workbenches. While QGIS provides a graphical interface for complex spatial analysis, Mapshaper excels in automating repetitive data transformation tasks. PostGIS, a PostgreSQL extension, offers advanced database-based geospatial operations that Mapshaper does not support. Mapshaper is ideal for preprocessing data before importing into other systems.
What should I do if Mapshaper fails to run in my browser?
Mapshaper requires modern browsers like Chrome or Firefox for optimal performance. If it fails to load, ensure your browser is up to date and disable any extensions that might interfere with web-based tools. For persistent issues, use the command-line interface or check the GitHub repository for troubleshooting guidance and compatibility updates.