Help Center Route Editor

Last updated

The Route Editor turns a GPS file, or a line you draw on a map, into a rideable 3D route. It surveys the terrain, smooths the gradients, finds bridges and tunnels, and points out anything that would ride badly.

The Route Editor with a route loaded: quality chips top-left, toolbar top-right, map and elevation chart

Adding a route

On the Routes page, click Add route. You can upload a route file (.gpx, .fit or .tcx) or draw a route on the map.

The Create a route dialog with Upload and Draw options

Drawing: click the map to add waypoints (up to 50), drag a pin to move it, right-click to remove it. Fetch route finds the road between them, and Send to route editor opens the result in the editor.

The Draw view with three waypoints and the fetched road between them

Free accounts can upload five routes in total, one at a time, up to 80 km. Subscribers upload without limit, up to 320 km. For anything longer, email hello@biketerra.com with the file.

What happens on load

Before you see the route, Biketerra:

  • surveys every point against its elevation data, and uses the survey outright for a file with no altitudes,
  • adds points so there's one at least every 100 m,
  • removes kinks and closes loops,
  • detects bridges and tunnels from OpenStreetMap and annotates them,
  • aligns the elevations, smooths the gradients and simplifies the track.

Quality scores

Two chips at the top show how the route will ride. Hover for the thresholds: 80+ is excellent, under 50 needs work. Green is good, amber is marginal.

The Smoothness chip's tooltip

  • Smoothness — how jittery the gradient is. It only counts phantom climbing (up-and-down noise), so genuinely steep roads aren't penalised. Select the rough stretch and press Smooth gradients to fix it.
  • Fit — how well your elevations line up with the survey. A poor fit shows up in 3D as a road sunk in a canyon or floating on a plateau. Align elevations fixes it.

Both are judged on the line you'll actually ride, and recalculate as you edit.

Issues

The warning chip lists sharp kinks, sharp corners and sudden gradient changes with their distance. Click one to fly the map there; Fix repairs it, and Fix all repairs everything as a single undo step.

The issues panel listing a sharp kink and several warnings, with Fix and Fix all buttons

Editing

Select points on the map or on the elevation chart, then use the toolbar.

A stretch selected on the elevation chart, with the toolbar showing the point count and the bridge, tunnel, surface, smooth, align, average and nudge buttons

  • Click a point to select it; Shift+click another to select the range between; Ctrl+click toggles one point. On the chart, drag to select a stretch and Shift+drag to zoom into it.
  • Drag a point to move it. Drag the path to insert a new point.
  • Toolbar, with a selection: add a bridge or tunnel, set a surface type, smooth gradients, align elevations, average (a straight ramp from the first point to the last), and nudge the altitude up or down a metre at a time.
  • Ctrl+Z undoes, Ctrl+Shift+Z redoes, Del deletes the selection, Space fits the selection to the view. Press ? for the full list.

The Shortcuts tab of the settings panel

Settings

The gear icon opens three tabs.

  • Settings — the route's default surface (asphalt, rough, cobble, dirt, gravel, singletrack or concrete) and Show spline, which draws the smoothed line the ride will follow.
  • Advanced — clear annotations, re-run bridge and tunnel detection, undo your altitude edits, undo the automatic cleanup, refresh the elevation data, or replace the file.

The Advanced tab with the annotation and danger-zone actions

Saving and exporting

Click the title to rename the route. Save uploads it to Biketerra; the arrow beside it exports the cleaned route as JSON or GPX. The route's description and privacy are set on its page after saving. Leaving the page with unsaved changes asks for confirmation.

The Save button's menu with Export JSON and Export GPX

Unsupported routes

The editor is built for routes that don't cross or overlap themselves. Intersections and repeated segments may still ride, but expect visual glitches in 3D. For an out-and-back, upload one half: Biketerra adds the second lane and a turnaround at each end.