strava-heatmap-proxy

This is a simple Cloudflare Worker allowing unauthenticated access to personal and global Strava heatmaps. If you want to use your personal Strava heatmap in Gaia or Locus, this will give you a URL that you can use for that.

Note: you will need to be a Strava premium subscriber to use the personal heatmap, while the global heatmaps are available to all Strava accounts. Personal use only, please. Strava will ratelimit you.

Usage

If you want to use these heatmaps as a tile layer in another app, here are the template URLs to use:

• Personal: https://strava-heatmap-proxy.YOUR_NAMESPACE.workers.dev/personal/orange/all/{zoom}/{x}/{y}@2x.png
• Global: https://strava-heatmap-proxy.YOUR_NAMESPACE.workers.dev/global/orange/all/{zoom}/{x}/{y}@2x.png

Check https://strava-heatmap-proxy.YOUR_NAMESPACE.workers.dev/ for full list of supported tile colors, activities, and sizes.

Deploying the proxy

Requirements:

• wrangler to manage Worker deployments

Strava Credentials

Strava's API doesn't support heatmap access directly, so we'll need to grab a session cookie from the browser for authentication.

1. Open https://strava.com/maps in your browser
2. Using devtools, find the _strava4_session cookie for strava.com

We also need your account id. You can find this by clicking on "My Profile" on the Strava website and taking note of the URL: https://www.strava.com/athletes/{strava_id}.

Secrets

wrangler login

# The worker uses a KV namespace to cache CloudFront cookies and keep them up to
# date.
#
# Make sure to update wrangler.toml with the ID you get back.
wrangler kv namespace create STRAVA_HEATMAP_PROXY_COOKIES

echo "1234" | wrangler secret put STRAVA_ID
echo "abc123..." | wrangler secret put STRAVA_SESSION

The worker will automatically exchange your session cookie for CloudFront credentials and refresh them as they expire.

You'll need to update STRAVA_SESSION if your session cookie ever expires though.

Verify

Check that everything's working by running wrangler dev.

Here's an example tile URL with some data: /global/mobileblue/all/11/351/817@2x.png (Downtown Los Angeles)

When you're all set, use wrangler publish to bring the site live on strava-heatmap-proxy.YOUR-NAMESPACE.workers.dev

(optional) GitHub Actions

Start by forking this repository and setting up some GitHub secrets (github.com/you/strava-heatmap-proxy/settings/secrets/actions).

• CF_ACCOUNT_ID
• CF_API_TOKEN
• KV_NAMESPACE_ID: ID of the STRAVA_HEATMAP_PROXY_COOKIES KV store (see above)

These secrets will be used by GitHub Actions:

1. deploy.yml: Deploy to Cloudflare on every commit to main.

Trigger the action for your first deploy, and you should be good to go. Your site should now be live on strava-heatmap-proxy.YOUR-NAMESPACE.workers.dev.