View on GitHub

map-runs

map runs into a single HTML world map

map-runs

Build Status

Code for creating an HTML map with all runs mapped with runkeeper (or similar). It uses:

Installation

In a Python environment (created with e.g. Conda) and from the repository’s root, run:

pip install .

NB: Tested for Python 3.8, 3.9 & 3.10.

Usage

Instructions for creating your own map

  1. Either clone locally or download this repo.
  2. Request your running data from the app you use for tracking runs. In the case of runkeeper, you can do this here (it takes about a week for them to send you your data the first time).
  3. Place all your .gpx files in ./gps-data. Make sure to remove any preexisting files.
  4. Modify the origin of your map (parameters starting-latitude & starting-longitude in ./map_runs/map-runs.ini) to correspond to your hometown.
  5. Follow the installation instructions if you have not done so yet.
  6. Run locally ./map_runs/map_runs.py.
  7. Done! your map is now available at ./output-map.html.

Instructions for keeping your map up to date

These steps are only necessary if you would like to update automatically your map as you get new data with continuous integration (CI). You will need a local Git client + a Github account.

  1. Fork this repo.
  2. Follow steps 2-3-4 from the previous instructions.
  3. Commit+push your changes to the repo.
  4. Your map will be available in the gh-pages branch, at ./output-map.html.

Additional customizations

You can customize your map to your liking by changing any of the parameters in the ./map_runs/map-runs.ini file. Some considerations for this:

Credits

Thanks to Jörg R Schumacher (@eHanseJoerg) for this useful jupyter notebook for plotting routes using the geoJSON format.