VeloViewer / StatHunters - Explorer

Generic Overlay



Configure for VeloViewer

VeloViewer ID

You can find your VeloViewer ID in URL bar at veloviewer.com - it's the number behind /athlete/.

You need to enable Share my data with anyone and Show my details in the VeloViewer leaderboard in VeloViewer Options.

VV Options


Configure for StatHunters

StatHunters API key

You can find your API key in StatHunters Settings: https://www.statshunters.com/settings

SH

Setup BRouter Web

BRouter Planner web interface: https://brouter.de/brouter-web

Step 1 - choose Custom Layers

BRouter

Step 2 - Fill the Customize Layers form

  1. Name of the layer
  2. Layer URL (with your VeloViewer ID) *** setup VeloViewer ID or StatHunters API key first ***
  3. Add overlay
BRouter

Step 3 - Enable the layer

BRouter

Setup NaKarte.me

NaKarte web interface: https://nakarte.me

Step 1 - choose Add custom Layer (pencil icon)

Step 2 - Fill the form

  1. Layer name
  2. Tile URL template (with your VeloViewer ID) *** setup VeloViewer ID or StatHunters API key first ***
  3. Choose overlay
  4. Add layer
NaKarte

Step 3 - Enable the layer

NaKarte

Setup Locus Map

LocusMap Application: https://www.locusmap.app

Step 1. Install Locus Map

Install Locus Map on your smartphone, note - the overlay was tested with LocusMap App version 3 (pro).

Step 2. Get providers.xml

Step 3. Upload providers.xml to smartphone

It should be stored in Internal Storage / Locus / mapsOnline / custom directory.


LocusMap

Step 4. Verify it's recognized

In Map Manager it should be visible under the name of VeloViewer Explorer Personal Overlay in the World category

LocusMap

Step 5. Map Overlays

Go to More Functions / Map Overlays

LocusMap

Step 6. Set Overlay

Enable Overlay, choose Set, Select Online Map and then select VeloViewer Explorer Overlay

LocusMap LocusMap

Step 7. Have fun

The overlay should be immediately visible

LocusMap LocusMap LocusMap LocusMap

Step 8. Cache

You can clear Locus Map cache of Explorer Overlay in case you uploaded new tracks to Strava, updated VeloViewer and refreshed data here (the Refresh Explorer stats button)

LocusMap

Setup OsmAnd

OsmAnd Application: https://osmand.net

Step 1. Install OsmAnd

Install OsmAnd on your smartphone. Tested with OsmAnd+ 3.9.10 (Android) and 3.9.7 (iOS)

Step 2. Enable Online Maps plugin

OsmAnd

Step 3. Add new Map Source

In Configure Map menu theres Map Source - select it and then choose Add


OsmAnd OsmAnd

Step 4. Setup Overlay - fill the form

  1. Name of the source
  2. Layer URL (with your VeloViewer ID) *** setup VeloViewer ID or StatHunters API key first ***
  3. Save

Important: iOS OsmAnd required different format of URL template ({z}/{x}/{y} replaced with {0}/{1}/{2}) but they fixed it in recent versions.

OsmAnd

Step 5. Enable Overlay

Go to Configure Map / Overlay Map

OsmAnd

Step 6. Choose Overlay

Choose VeloViewer Explorer you added on Step 4. You can set transparency to the max, because Overlay is already served as transparent (you will be able to make it even less visible with tranparency seekbar (if you choose to enable it).

OsmAnd OsmAnd

Step 7. Have fun

The overlay should be immediately visible

OsmAnd OsmAnd OsmAnd

iOS Version

OsmAnd

Tile opions

You can specify customize tile colors etc. with several options.

Add one or more parameters between id element and coordinates. Options are separated with single slash "/", name is separated from value with single hyphen "-".

Options

option namedecriptionoption valuedefault value
msshow max square frame1 (visible) or 0 (hidden)1
clshow cluster squares1 (show cluster squares with different color) or 0 (don't distinguish cluster squares)1
zzzoom levelsquare base zoom level, 14 for standard squares, 17 for sqadratinhos (ony grid is supported)14
cvcolor of visited squarergb color as 6-digit hex numberff0000
cccolor of cluster squaresrgb color as 6-digit hex number0000ff
cgcolor of gridrgb color as 6-digit hex numberff0000
cmcolor of max square gridrgb color as 6-digit hex number0000c8
tvtransparency of visited squareinteger 0-127 (0 - opaque, 127 - transparent)115
tctransparency of cluster squaresinteger 0-127115
tgtransparency of gridinteger 0-12750
tmtransparency of max square gridinteger 0-12750

Examples

Change colors: https://vv.fork.pl/00000000000/ms-1/cl-1/cv-00ff00/tv-100/cc-00dd00/tc-100/cg-666666/tg-20/cm-000000/tm-20/{z}/{x}/{y}.png will render view similar to

Ex

Change transparency: https://vv.fork.pl/00000000000/ms-0/tv-0/tc-0/cg-00000000/tg-0/{z}/{x}/{y}.png will render opaque tiles (and one can adjust transparency in your mapping application)

Ex Ex


Problems?

If you have any problems please report an issue at https://github.com/marcin-gryszkalis/veloviewer-explorer-overlay/issues or just write to email mg@fork.pl


Credits

This page uses: