Skip to content

Latest commit

 

History

History
40 lines (28 loc) · 1.66 KB

README.md

File metadata and controls

40 lines (28 loc) · 1.66 KB

gpx2tiles

An utility to create Openstreetmap slippy map tiles from a set of GPX files.

Inpired by the http://wiki.openstreetmap.org/wiki/Gpx2png

The gpx2png is a Perl script and as such is too slow and too resource hungry to be used on the puny server hardware originally intended for the task. Besides, its dependencies (ImageMagick in particular) make a task of its deployment a bit complicated.

Gpx2tiles requires two external libraries LidGD (https://www.libgd.org/) - to draw the tiles, and LibXML2 (www.xmlsoft.org/) - for parsing the XML of the GPX files.

The program parallelizes loading of the tracks (to speedup processing), can regenerate the speed (from distance and timestamps, to handle tracklogs without complete GPS data).

The tiles can be either generated completely from scratch or only updated with the new tracks, which is obviously faster (and default mode of operation).

The output is immediately usable by Leaflet and OpenLayers: the directory structure corresponds to the popular .../{z}/{x}/{y}.png layout.

The usage of memory can be restricted to be able to run it in constrained environments. The code is not good enough to process (even at slower pace) really big GPX data sets on small, single-board computers like Raspberry Pi, though. Please be careful, the program will happily eat all available memory if it has to.

Usage example:

$ gpx2tile -C tiles/tracklogs /mnt/gps/logs/*.gpx

This will place the tiles in the "tiles/tracklogs" directory, creating the necessary zoom levels and latitude directories, updating the existing tiles with the new track information (remove the files before running the program, to generate the tiles from scratch).