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