VeloViewer / StatHunters - Explorer

Generic Overlay

Configure for VeloViewer

VeloViewer ID

You can find your VeloViewer ID in URL bar at - 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:


Setup BRouter Web

BRouter Planner web interface:

Step 1 - choose Custom Layers


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

Step 3 - Enable the layer



NaKarte web interface:

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

Step 3 - Enable the layer


Setup Locus Map

LocusMap Application:

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.


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


Step 5. Map Overlays

Go to More Functions / Map Overlays


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)


Setup OsmAnd

OsmAnd Application:

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


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.


Step 5. Enable Overlay

Go to Configure Map / Overlay Map


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


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 "-".


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


Change colors:{z}/{x}/{y}.png will render view similar to


Change transparency:{z}/{x}/{y}.png will render opaque tiles (and one can adjust transparency in your mapping application)

Ex Ex


If you have any problems please report an issue at or just write to email


This page uses: