Documentation

Routebook is a geospatial visualization application for Rouvy cycling routes and ride data. It combines satellite mapping, cinematic route animation, and performance overlays to create an immersive ride exploration experience. This documentation covers the map viewer controls, performance data overlays, points of interest management, and route library navigation.

Drawer Navigation

Upload

Import new Rouvy FIT files to add routes to your library.

Favorite

Quick access to starred routes for frequently viewed rides. Year and month filters are not applied when viewing favorites.

Globe View

Global route overview showing all rides with geographic distribution.

Edit Menu

Access to settings, account management, subscription details, and logout.

Filters & Search

Year Selector

Filter routes by calendar year with visual activity distribution.

Month Calendar

Bar chart visualization showing ride frequency by month.

Metric Selector

Choose which metric is displayed on the month bar chart: Distance, Ascent, Time, or number of Routes.

Search Routes

Text search across route names, locations and POIs for quick access to specific rides. Year and month filters are not applied during search.

Route List

Scrollable library of all routes with location indicators for geotagged rides.

Map Viewer Controls

Play/Pause

Initiates or pauses the cinematic ride-through animation along the route path.

Rewind

Returns the animation to the start of the route.

Scrubber

Drag to navigate to any point along the route. Displays current distance position.

Speed Control

Adjusts playback speed of the animation (1x to 40x multipliers).

Zoom Controls

Standard zoom in/out for map detail level.

Pitch Control

Adjusts camera angle from top-down to oblique perspective for terrain visualization.

Bearing Control

Rotates the map orientation and camera heading.

Camera Track Mode

Locks camera to follow the route path during animation playback.

Route Display Modes

Toggle between route reveal (yellow progressive path display) and gradient path (slope-based coloring).

Gradient mode colors the route path by slope percentage:

  • Blue descents (≤0%)
  • Green flat (0–2%)
  • Yellow gentle (2–4%)
  • Orange moderate (4–6%)
  • Red steep (6–8%)
  • Dark red very steep (8-10%)
  • Near black red extreme (≥10%)

Performance Overlays

Elevation

Real-time elevation profile with current altitude, grade percentage, and maximum elevation. Interactive chart shows terrain along the route.

Power

Current, maximum, and average power output in watts. Time-series graph displays power fluctuations throughout the ride.

Heart Rate

Current, maximum, and average heart rate in bpm with continuous monitoring visualization.

Cadence

Current, maximum, and average pedaling cadence in rpm. Shows cycling rhythm patterns across the route.

Speed

Current, maximum, and average speed in km/h with velocity profile over time.

Points of Interest

Adding POIs

Long-click (click and hold) on any map location to open the POI creation dialog. Enter POI details including name, description, and category.

Editing POIs

Click a POI marker to display its popover, then click the popover to open the edit dialog. POIs can be modified or deleted from this dialog.

Moving POIs

Long-click and drag a POI marker to reposition it on the map.

JSON Import

POIs can also be added in bulk in JSON format in the route details editor.

Coordinates

Route Coordinates

The route edit dialog includes a "Copy Coordinates" button for start and end GPS coordinates, copying latitude and longitude to the clipboard.

POI Coordinates

Each POI dialog provides a "Copy Coordinates" button to capture the exact GPS location. This can be used to obtain coordinates for any map position.

Device Support

macOS, iPadOS and iOS

Routebook is tested for macOS, iPadOS, and iOS devices. Devices newer than iPad Air 4th generation (released October 23, 2020) should render terrain and animations smoothly.

Windows and Android

Routebook should work on modern Windows and Android devices using Chrome web browsers. Performance may vary depending on device capabilities and browser version.

Known Issue: Terrain May Appear Flat in Safari

Routebook uses three-dimensional terrain to bring your rides to life, showing the climbs and descents of your route as they actually look in the real world. If you're using Safari on a Mac, iPad, or iPhone, you may notice that the terrain looks unusually flat compared to other browsers like Chrome. This is a known limitation with how Safari renders 3D graphics, and it affects Mapbox-powered maps across many applications — not just Routebook. We're actively investigating a fix, but in the meantime, opening Routebook in Chrome will give you the full terrain experience as intended.