The Export Tool creates OpenStreetMap exports for GIS programs and mobile devices. It outputs files in various tabular formats based on an input area of interest polygon and a selection of OpenStreetMap tags. It is synchronized minutely with the main OSM database, so exports can be created to accompany real-time humanitarian mapping efforts.
This is the source code for the web service available at export.hotosm.org. If you would like to export OSM data offline without using the website, you can access the separate command line tool and Python Library. This repository is at github.com/osm-export-tool-python.
We have included below a reference to the HOT Export Tool Product Roadmap [subject to change]. We hope it is a useful reference for anyone wanting to get involved.
- To report a problem or bug, please include a link to the export's download page. This will be a URL that looks like this: export.hotosm.org/en/v3/exports/cb709d41-6f78-4ee5-8e9a-9eae7b63177c
- Include the GIS program you are using and the version: for example, QGIS 3.8.
- Screenshots of the web interface or the data within your GIS program are always helpful!
- See detailed contributor guidelines here.
The code in this repository powers the export tool web service and includes a number of features besides creating GIS files:
- Periodic exports for HOT's partner humanitarian organizations, such as those that appear on the Humanitarian Data Exchange platform.
- Authentication via OSM accounts and email notifications for when exports are complete.
- Storage of YAML feature tag selections.
- A rich user interface with error reporting and geometry drawing/uploading, built on OpenLayers.
If you would like to host the Export Tool yourself, see the ops folder, which includes instructions for setting up both an Overpass Instance and the Export tool web app on Ubuntu.
If you would like to enhance the code of the Export Tool web app, a guide to installing it in a local development environment is at docs/setup-development.md.