osm_conflate/README.rst

54 lines
1.4 KiB
ReStructuredText

OSM Conflator
=============
This is a script for merging points from some third-party source with
OpenStreetMap data. Please make sure the license allows that. After
merging and uploading, the data can be updated.
See `the OSM wiki page`_ for detailed description and instructions.
Installation
------------
Run
``pip install osm_conflate``.
Profiles
--------
Each source should have a profile. It is a python script with variables
configuring names, tags and processing. See heavily commented examples
in the ``profiles`` directory.
Usage
-----
For a simplest case, run:
::
conflate <profile.py> -o result.osm
You might want to add other arguments,
to pass a dataset file or prepare a preview GeoJSON. Run
``conflate -h`` to see a list of arguments.
Uploading to OpenStreetMap
--------------------------
It is recommended to open the resulting file in the JOSM editor and
manually check the changes. Alternatively, you can use
`bulk\_upload.py`_ to upload a change file from the command line.
Please mind the `Import Guidelines`_, or your work may be reverted.
License
-------
Written by Ilya Zverev for MAPS.ME. Published under the Apache 2.0
license.
.. _the OSM wiki page: https://wiki.openstreetmap.org/wiki/OSM_Conflator
.. _bulk\_upload.py: https://wiki.openstreetmap.org/wiki/Bulk_upload.py
.. _Import Guidelines: https://wiki.openstreetmap.org/wiki/Import/Guidelines