Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/hotosm/osm-export-tool

Web service to download customised OSM data in various file formats
https://github.com/hotosm/osm-export-tool

django gis openstreetmap overpass-api react

Last synced: 6 days ago
JSON representation

Web service to download customised OSM data in various file formats

Host: GitHub
URL: https://github.com/hotosm/osm-export-tool
Owner: hotosm
License: bsd-3-clause
Created: 2015-05-26T12:15:30.000Z (over 9 years ago)
Default Branch: master
Last Pushed: 2024-09-12T03:36:29.000Z (2 months ago)
Last Synced: 2024-09-12T13:15:39.750Z (2 months ago)
Topics: django, gis, openstreetmap, overpass-api, react
Language: JavaScript
Homepage: http://export.hotosm.org/
Size: 26.1 MB
Stars: 144
Watchers: 26
Forks: 46
Open Issues: 47
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

# Export Tool

[![Join the chat at https://gitter.im/hotosm/osm-export-tool2](https://badges.gitter.im/hotosm/osm-export-tool2.svg)](https://gitter.im/hotosm/osm-export-tool2?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)

[![CircleCI](https://circleci.com/gh/hotosm/osm-export-tool.svg?style=svg)](https://circleci.com/gh/hotosm/osm-export-tool)

The **Export Tool** is a web service that generates exports of OpenStreetMap (OSM) data for use in Geographic Information System (GIS) programs and mobile devices. The tool allows users to define an area of interest using a polygon and select OSM tags to include in the export. The tool then generates tabular files in various formats, such as CSV or GeoJSON, containing the OSM data within the specified area and tags.

One of the most important features of the Export Tool is its synchronization with the main OSM database. The tool is updated minutely, which means that it reflects changes made to the OSM database in near-real time. This makes the Export Tool a valuable resource for humanitarian mapping efforts that require up-to-date OSM data.

In addition to creating GIS files, the Export Tool also includes features such as periodic exports for humanitarian organizations and email notifications for when exports are complete. The tool also includes a user-friendly interface with error reporting and geometry drawing/uploading, built on OpenLayers.

![screenshot](images/screenshot.png)

# Get involved!

This is the source code for the web service available at [export.hotosm.org](https://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](https://github.com/hotosm/osm-export-tool-python).

## Product Roadmap

| Status | Feature |
|:--:| :-- |
|✅| Connection with raw-data-api |
|✅| Vector tile support |
|✅| Stable Country exports support |
|✅| Upgrade python and django version |
|✅| Admin methods to control queues and manage exports |
|✅| Migration of cloud env |
|⚙️| Connect HDX exports with custom yaml endpoint in raw-data-api |
| | Upgrade Frontend of export tool ( Ideation ) |

## How to Contribute

* 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](https://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](https://github.com/hotosm/osm-export-tool/blob/master/CONTRIBUTING.md).

## For Developers

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](https://data.humdata.org) 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](docs/setup-development.md).