A tool for converting ogr-readable files like shapefiles into .osm data
ogr2osm requires gdal with python bindings. Depending on the file formats
you want to read you may have to compile it yourself but there should be no
issues with shapefiles. On Ubuntu you can run sudo apt-get install -y python-gdal to get
the software you need.
To install ogr2osm and download the default translations the following command can be used:
git clone --recursive https://github.com/pnorman/ogr2osm
To update
cd ogr2osm
git pull
git submodule update
This version of ogr2osm is based on Andrew Guertin's version for UVM which is in turn based on Ivan Ortega's version from the OSM SVN server.
ogr2osm will read any data source that ogr can read and handle reprojection for you. It takes a python file to translate external data source tags into OSM tags, allowing you to use complicated logic. If no translation is specified it will use an identity translation, carrying all tags from the source to the .osm output.
Anyone planning an import into OpenStreetMap should read and review the import guidelines located on the wiki. When writing your translation file you should look at other examples and carefully consider each external data source tag to see if it should be converted to an OSM tag.
Usage: ogr2osm.py SRCFILE
Options:
-h, --help show this help message and exit
-t TRANSLATION, --translation=TRANSLATION
Select the attribute-tags translation method. See the
translations/ directory for valid values.
-o OUTPUT, --output=OUTPUT
Set destination .osm file name and location.
-e EPSG_CODE, --epsg=EPSG_CODE
EPSG code of source file. Do not include the 'EPSG:'
prefix. If specified, overrides projection from source
metadata if it exists.
-p PROJ4_STRING, --proj4=PROJ4_STRING
PROJ.4 string. If specified, overrides projection from
source metadata if it exists.
-v, --verbose
-d, --debug-tags Output the tags for every feature parsed.
-f, --force Force overwrite of output file.
--significant-digits=SIGNIFICANTDIGITS
Number of decimal places for coordinates
--rounding-digits=ROUNDINGDIGITS
Number of decimal places for rounding
--no-memory-copy Do not make an in-memory working copy
--no-upload-false Omit upload=false from the completed file to surpress
JOSM warnings when uploading.