Skip to main content

Interactive Maps

FitFileViewer provides powerful map visualization using Leaflet.js.

Overview​

The Map tab displays your GPS route with:

  • Interactive route visualization
  • Multiple map layer options
  • Lap and waypoint markers
  • Measurement tools
  • Elevation profile

Map Controls​

Zoom​

MethodAction
Mouse wheelScroll up/down
ButtonsClick +/-
Keyboard+ or - keys
Double-clickZoom to point

Pan​

  • Click and drag the map
  • Use arrow keys
  • Click mini-map to jump

Reset View​

  • Double-click to zoom to point
  • Use "Fit to route" button
  • Press Home key

Map Layers​

Click the layers button (🗂️) to choose:

LayerDescriptionBest For
OpenStreetMapDetailed street mapUrban routes
SatelliteAerial imageryTrail visualization
TerrainElevation shadingMountain activities
DarkDark-themed mapNight viewing

Route Display​

Route Line​

Your GPS track is shown as a colored line:

  • Green section: Start of route
  • Blue section: Middle of route
  • Red section: End of route

Markers​

MarkerColorMeaning
Start🟢 GreenActivity start point
End🔴 RedActivity end point
Laps🔵 BlueLap split points

Hover Information​

Mouse over the route to see:

  • Distance from start
  • Elapsed time
  • Current speed
  • Elevation
  • Estimated power (when enabled and no real power exists)

Tools​

Estimated Power (⚡ Est Power)​

For cycling activities that do not contain real power meter data, FitFileViewer can estimate ("virtual") power from speed + elevation/grade.

  1. Open the Map tab
  2. Click ⚡ Est Power
  3. Adjust rider/bike weight, CdA, Crr, drivetrain efficiency, wind, and smoothing

When enabled, map tooltips will show Est. Power.

Measurement Tool​

Measure distances on the map:

  1. Click the measure button (📏)
  2. Click points on the map to build a measurement path
  3. See per-segment distances and the total distance as you add points
  4. Finish the measurement using any of these gestures:
    • Double-click
    • Right-click
    • Click an existing point on the measurement path
  5. Results are shown in both metric and imperial units

Fullscreen​

Expand map to full window:

  • Click fullscreen button (⛶)
  • Press F11
  • Click again to exit

Mini Map​

A small overview map in the corner:

  • Shows your location on larger area
  • Click to navigate
  • Can be collapsed

Customization​

Route Colors​

The route automatically uses colors based on:

  • Speed (faster = warmer colors)
  • Heart rate zones
  • Elevation changes

Map Style​

Match your theme:

  • Light theme → Standard map
  • Dark theme → Dark map style

Performance Tips​

Large Routes​

For activities with many GPS points:

  • Zoom in for detail
  • Use route simplification
  • Give time for initial render

Offline Maps​

Previously viewed areas are cached:

  • Works offline for cached areas
  • Blank tiles for new areas offline

Common Issues​

No Route Displayed​

Causes:

  • Indoor activity (no GPS)
  • GPS data not recorded
  • File parsing error

Solutions:

  • Check if activity has GPS data
  • Try reloading file
  • Verify FIT file isn't corrupted

Slow Map Loading​

Causes:

  • Large activity file
  • Slow internet for tiles
  • Many map layers

Solutions:

  • Wait for initial load
  • Zoom to specific area
  • Use cached tiles

Inaccurate Route​

Causes:

  • Poor GPS signal during activity
  • Indoor/tunnel sections
  • Device GPS issues

Note: FitFileViewer displays the data as recorded. GPS accuracy depends on your device.

Related: Charts | Tables