Awesome
minjur
This program will not be developed any further. We recommend you use the
export
command of osmium-tool instead.
Osmium-based converter of OSM data to GeoJSON.
Installing
It is recommended that you install minjur from binaries using mason:
$ mkdir mason && curl -sSfL https://github.com/mapbox/mason/archive/v0.6.0.tar.gz | tar --gunzip --extract --strip-components=1 --directory=./mason
$ ./mason/mason install minjur 0.1.0
$ ./mason/mason link minjur 0.1.0
$ ./mason_packages/.link/bin/minjur --version
0.1.0
If you need to source compile then you'll need libosmium headers available. Then you build minjur with cmake:
mkdir build
cd build
cmake ..
make
Run
Run like this:
minjur [OPTIONS] OSMFILE >out.geojson
Call with --help to see command line options.
Options:
-d, --dump=FILE Dump location cache to file after run
-e, --error-file=FILE Write errors to file
-h, --help This help message
-i, --with-id Add unique id to each feature
-l, --location-store=TYPE Set location store
-L, --list-location-stores Show available location stores
-n, --nodes=sparse|dense Are node IDs sparse or dense?
-p, --polygons Create polygons from closed ways
-t, --tilefile=FILE File with tiles to filter
-z, --zoom=ZOOM Zoom level for tiles (default: 15)
-a, --attr-prefix=PREFIX Optional prefix for attributes, defaults to '@'
Output
The output will be a (possibly rather large file) with one GeoJSON object per line.
Nodes without any tags will not appear in the output. Ways with zero or a single node will not appear in the output.
All tags will appear as GeoJSON properties, the object type, id, version,
changeset, uid, user, and timestamp will also be in the properties
using a leading @ in the key indicating that this is an attribute, not a
tag. You can use the --attr-prefix or -a option to change this prefix.
Working with updates
If you are working with a planet file or very large extract (a large continent) set:
export INDEX_TYPE=dense
If you are working with a small (city-sized) to medium (country-sized) extract set:
export INDEX_TYPE=sparse
Then run like this on the old OSM data file:
minjur -d locations.dump -n ${INDEX_TYPE} OLD_OSMFILE >out.geojson
This will create a file locations.dump in addition to out.geojson. With
the change file (usually with suffix .osc.gz) you run the following to
create the tile list:
minjur-generate-tilelist -l ${INDEX_TYPE}_file_array,locations.dump CHANGE_FILE >tiles.list
Then run minjur again with the tile list to create a GeoJSON file with only
the changes:
minjur -d locations.dump -n ${INDEX_TYPE} -t tiles.list NEW_OSMFILE >changes.geojson
Repeat the last two lines for every change file.
For planet updates, you'll need at least 40GB RAM for the node location cache, on OS/X and Windows it could be twice that!
minjur-generate-tilelist
Run like this:
minjur-generate-tilelist [OPTIONS] OSM-CHANGE-FILE
Output is always to stdout.
Options:
-h, --help This help message
-l, --location_store=TYPE Set location store
-L, --list-location-stores Show available location stores
-n, --nodes=sparse|dense Are node IDs sparse or dense?
-z, --zoom=ZOOM Zoom level for tiles (default: 15)
Experimental version with multipolygon support
There is an experimental version called minjur-mp that has multipolygon
support. It does not support updates, that's why it doesn't have all the
options the minjur program has.
Run like this:
minjur-mp [OPTIONS] OSMFILE >out.geojson
Call with --help to see command line options.
Options:
-e, --error-file=FILE Write errors to file
-h, --help This help message
-i, --with-id Add unique id to each feature
-l, --location-store=TYPE Set location store
-L, --list-location-stores Show available location stores
-n, --nodes=sparse|dense Are node IDs sparse or dense?
-a, --attr-prefix=PREFIX Optional prefix for attributes, defaults to '@'
The output will have GeoJSON objects for all the tagged nodes first and then, in no particular order, the GeoJSON LineString objects (generated from ways) and the MultiPolygon objects (generated from multipolygon relations and closed ways).
Note that this version of the program will run much longer, generating the multipolygons is rather slow.
Name
This project is named after the town of Minjur in India which I know nothing about.