GIS is a library to do reverse geocoding, route matching, and polygon matching by leveraging OpenStreetMap maps.

The reverse geocoding API matches a GPS point onto a physical address.

The route matching API matches GPS traces onto roads.

GIS uses Apache Maven, please refer to the Apache Maven documentation for further details.

To run tests you need to download a PBF file from https://download.geofabrik.de/europe/italy-latest.osm.pbf and place it in the src/test/resources/graphHopperSource directory.

Then you can run tests by executing the following command:

mvn test

Sometimes PBFs of a specific area you want to use aren't available, the osmium tool allows merging multiple PBFs into a single PBF file.

Download country maps in osm.pbf format from https://download.geofabrik.de/

Then you can install and run osmium to merge all of them in a file called merge.osm.pbf by executing the following command:

sudo apt-get install osmium-tool
osmium cat 1.osm.pbf 2.osm.pbf 3.osm.pbf -o merge.osm.pbf

Creating a graph is expensive and slow, so to avoid building it every time we can create a serialized graph starting from a PBF file by running the following command:

export MAVEN_OPTS = "-Xmx6G -Xms6G"
mvn exec:java -Dexec.mainClass=it.agilelab.bigdata.gis.core.apps.ConverterFromOSMToGraphHopperMap -Dexec.args="--graphLocation graphHopperMap/ --osmLocation merge.osm.pbf"

The serialized graph will be saved in the graphHopperMap directory.

Note: you need to adjust Xmx and Xms to your specific situation.

Once downloaded the country map from https://download.geofabrik.de/ as *.osm.pbf files, it is possible to filter only the desired railway types (see https://wiki.openstreetmap.org/wiki/Key:railway) and compute the corresponding shapefiles, by using the ogr2ogr command.

For example, the italy-gis-railways.* files, under the src/test/resources/osm/maps/italy, have been produced by running:

osmium tags-filter --overwrite -o italy-railways.pbf italy-latest.osm.pbf nw/railway=light_rail,narrow_gauge,rail,disused
ogr2ogr -f "ESRI Shapefile" -skip italy-railways.shp italy-railways.pbf

In this case only the lines.* files inside italy-railways.shp have been considered, renamed and added to the test folder.

The polygons representing the sea have been downloaded from https://osmdata.openstreetmap.de/data/water-polygons.html (projection WGS84).

Once downloaded, they have been loaded into QGIS in order to select only the region of interest, the Mediterranean Sea, uploaded into the repository.

All the Shapefiles inside the sea_input_path directory are supposed to contains sea polygons.