My Ride History

This is a hobby project I built so I can nicely keep track of where I've ridden on my bicycle. On top of that this app calculates and displays the ~square kilometer sized tiles (OSM tile zoom level 14) visited and based on those it also displays the largest tile cluster and maximum tile square.

Ride data comes through Strava's API and for accessing it you need to create a Strava API account. See https://developers.strava.com/ for details. Server is implemented as a Flask application whereas client relies heavily on Leaflet.js.

Configuration

You need to create a conf.py configuration file under project root. A sample file could look like this:

# Basic auth username, protects ride data sync related resources
auth_username = 'my username'  
# Basic auth password, protects ride data sync related resources
auth_pwd = 'my password'  
# Your Strava API client ID
client_id = 12345
# Your Strava API client secret
client_secret = 'secret'
# Run Flask in debug mode, affects hot deployment etc
debug = False
# Used by Strava so it can redirect back to your site after OAuth
hostname = 'http://localhost:5001'  
# Square size to check when searching for max square. E.g. 100 means that an area of 100*100 tiles is checked
max_square_bounds = 100
# Path to file where you want to locally store your ride data (in .csv format)    
ride_file = 'rides.csv'
# Port assigned for this app
port = 5001  

Your hostname should be explicitly whitelisted in Strava API settings for redirection to work. Localhost is an exception to the rule, it is automatically whitelisted. Note that you should really use HTTPS with basic auth at least if the app is deployed outside localhost.

Starting up

Install required python packages. They are

• flask, Flask-BasicAuth, Flask-Caching, flask-compress
• polyline
• requests

Start the app with python app.py or through some other utility. See Flask documentation for more details.

Syncing your local data with Strava

Just click the refresh icon on the map or navigate to /sync with your browser, enter your basic auth credentials (see above) and you're forwarded to Strava OAuth screen. Allow access and soon you should be all set up. Note that depending on the amount of data you have the initial sync could take some time.

Notes

Max square calculation follows a heuristic that search starts from the most visited tile using predefined customizable bounds because exhaustive search of the whole world would probably be an overkill :)

Also max cluster calculation takes an assumption that center of max square falls inside the max cluster.