Quick reference

Read the map.

Viatrail is a map and trip planner for hikers. This page shows where things are in the app, what each part is for, and what the symbols and colours on the map mean.

Look up a symbol
Alder RidgeAlder Lake N

Getting around

Where things are

Most of the screen is the map. The strip at the bottom has three buttons: Map, Item menu and Global menu. When you tap something on the map, its panel opens over the lower part of the screen.

MapItem menuGlobal menu
Nothing selected. Item menu shows +.
MapItem menuGlobal menu
A plan selected. Item menu shows the plan's icon.

Item menu

With nothing selected, Item menu shows +. Use it to create a plan, a waypoint, a folder and more. When you select an item, it shows that item's icon and acts on that item. For example, you can focus, hide or edit it.

Global menu

Global menu holds the map tools. Use it to start a recording, change the routing options, search or import files. It also turns labels and satellite images on and off, and centres the map on you. Settings and the Library are at the bottom.

The panel

The panel shows the item you tapped. Drag it up to see more, or down to see more of the map. The chip at the top right moves between the item's pages, such as Overview, Camps or Edit. Some plan pages, such as Weather, show "Coming soon" for now.

Location and Quick Plan

Press and hold the map

A long press is the quickest way to look at a place, or to plan a walk to it. You do not need a menu. Press once to see the place. Press again to route to a second place.

Location
Long press: Location. A pin drops where you press, and the Location panel opens.
Location
Long press again. A dotted line joins the pin to your finger while you drag.
Quick Plan
Let go: Quick Plan. Viatrail routes from the pin to that place.

Location

Press and hold anywhere on the map. A pin drops there, and the Location panel shows how far the point is from you, its elevation, and nearby things. From here you can add a waypoint. You can also tap To Here to route from where you are to the pin.

Quick Plan

While the pin is up, press and hold a second place, and drag if you want to. When you let go, Viatrail routes a Quick Plan from the pin to that place. It uses your routing options. To cancel, drag to Cancel and let go there.

Keep it, or let it go

A Quick Plan is not saved until you save it. Tap Save on its "Unsaved quick plan" line, or use Save as Plan or Save as Network in its menu. If you close it, it is deleted, and Undo brings it back.

On a network? When a network is selected, the pin snaps to its lines. You can then add a waypoint, a highlight or an area to that network.

Recording

Record your walk

Viatrail can record where you walk and save it as a track. Tap Record in the Global menu to start. The recording carries on when you use other apps.

Before you start

Recording needs precise location access. With approximate location, the position is only good to about a kilometre, so Viatrail does not record.

Map symbols

One item or several?

Read the shape first. Each item takes the largest form that has room, so the same item can change form as you zoom. All examples are drawn at the same scale, so you can compare their sizes.

Dot

The smallest mark for one item, on its exact point. It keeps up to three colours, but has no icon or text.

Marker

An icon mark for one item. Here, the tent marks a camp. The icon, colour and outline come from the item's data and from rule sets.

Group of markers

One item with several kinds of data. It shows up to three markers, with the strongest first. There is no count.

Stack

Several items that are too close to show one by one. The number counts the items, and the marks show each kind of mark inside. The dashed edge means the stack is not at an exact place: its items are under it or nearby. Tap it to list them.

Ellipsis

A small stack with no count or icons. It shows when a stack has more than three kinds of mark, or when Labels is off. The dashed edge again means "not at an exact place". Tap it to list the items.

Alder CampTent sites

Card

A label for one item. It shows the name, then one row for each data record. A solid line joins the card to a dot on the item's exact point.

Labels off? The Labels row in the Global menu hides all cards. The map then shows only dots, and an ellipsis where the dots have no room.

Ground and overlays

Colour only where it matters

The map is simple on purpose. Ground that you can normally walk over gets no colour, so the cream background shows. Colour marks ground that changes your walk, such as forest, water or wet ground.

GroundLightDarkOpenStreetMap land types
Easy groundNo fill: the background
Forestforest
Waterwater, river, reservoir, ocean
Wetlandbog, marsh, string_bog, swamp
Farmlandfarmland, farmyard, orchard, vineyard and similar
Glacierglacier
Rock and screebare_rock, scree, shingle
In the light map, rock is grey only when you zoom in. When you zoom out, it has no fill.

Stays cream

Open land such as grass, meadow, heath, scrub or sand has no fill on purpose, and the same is true of a few more land types. In the dark map, this land shows the dark background.

Zoomed out
Closer
Close

National parks

A park gets a soft tint with no outline. The tint is strongest when you can see the whole park. It fades out as you zoom in, and it is gone before the park fills the screen.

Light map
Dark map
Satellite

Routing

Trails, routes and slopes

Green lines on the base map are trails. While you edit a plan or a network, each part of the line shows what the router followed.

Trails on the base map

  • Hiking route. A named hiking route from OpenStreetMap. Long routes show first as you zoom in.
  • Other path. A path or bridleway that is not part of a hiking route. These show when you zoom in closer.

Route colours while editing

  • Library. Follows your own saved lines.
  • Trails. Follows paths and trails on the base map.
  • Roads. Follows roads on the base map.
  • Cross-country. Crosses open ground with no path.
  • Straight line. No routing. This happens when all routing types are off, for a short join, or when no route was found.

These colours show only in the editor. On the normal map, a plan uses its own line colour.

Show max gradient

Red cells mark ground that is steeper than your Max gradient. Each cell is one square of elevation data, so the shading looks blocky when you zoom in. Turn it on with Show max gradient in the Routing options, in the Cross-country card. It also shows while you drag the Max gradient slider. Where there is no elevation data there is no red, so no red does not always mean easy ground.

400 m600 m800 m1000 m

Elevation profile

The line shows the height along the walk, with a pale fill under it. The lines across the chart are marked in metres. The thin strip under the chart shows how steep each part is. The grade is the same going up or down.

  • Gentle · under 5%
  • Moderate · 5–10%
  • Steep · 10–15%
  • Very steep · 15% or more

Routing options

Open the options from Routing in the Global menu, or from an editor. Library, Base map and Cross-country each have a switch, so you choose what the router can follow. Cross-country also has a Max gradient and an Avoid forests switch.

Camps

Your camps and base map camps

A plan's Camps page splits the walk into days, and picks a place to stop each night. The places come from two sources, and the marker's shape tells you which.

CampShelterHotelSettlement
Librarycircle
Base mapsquare

Library camps

These are your own waypoints, and points in a visible network, that have Camp, Shelter, Hotel or Settlement data. Hidden items are not used.

Base map camps

These are places from OpenStreetMap, such as campsites, huts, hotels and villages. Each one keeps its OpenStreetMap type, which its camp page shows. An imported plan may first need Download data.

Base map groups

Base map places come in four groups. Camps are campsites and tent pitches, so bring a tent. Shelters are huts and shelters, so bring a sleeping bag. Hotels include hostels, guest houses and more. Settlements are towns, villages and hamlets.

Other marks on the Camps page

  • Custom camp: a place you added with Add camp.
  • Day end, with its day number.
  • Pinned day end.
  • Skipped camp: pale.

Camp settings

Camp settings choose which camp types the plan can use, from the Library and from the base map. They also set how long a day should be, and how far a camp can be from the plan. On the Camps page, Pin keeps a day end in place, Skip drops a camp, and the arrows move a day end earlier or later.

Library

What did you save?

The Library holds everything you make or import, in folders. The icon tells you what kind of item it is. The map symbols above tell you how the map shows it.

Plan
A trip you intend to walk. It has a routed line, days and camps.
Network
Connected lines with junctions, such as a trail system. It can hold highlights, waypoints and areas.
Track
A record of where you went, with times. It comes from a recording or an import.
Highlight
A path along the lines of one network, such as a named route.
Waypoint
A saved point, such as a camp, a junction or a water source.
Area
An outline around a place on the map.
Offline Map
A set of map squares to keep on this device. See Offline.
Rule Set
Rules that set how items look on the map. See Rule sets.
Data Type Set
Your own kinds of data for records. See Data.

Default line colours

These colours come from the built-in Default styles rule set. Your own rule sets can change them.

  • Plans: orange
  • Tracks: yellow
  • Networks: blue
  • Highlights: purple-blue. A highlight with Route data is purple, with a card.
  • Areas: teal
  • Anything with Hazard data: strong red, with a solid card. An area also gets a hatched fill.

Show less on the map

You can make the map quieter without deleting anything. Hide takes an item off the map, and Isolate shows only the items you isolate. Pin keeps an item at the top of its folder, and Focus moves the map to show the item.

Map editors

Change the shape on the map

Open an item on the map, then go to its Edit page. You then change the item by dragging it on the map. What you can drag depends on the kind of item.

Dragging a point of a plan. The router fills in each part again. Here the point is about to snap to a hut.

Plan

Drag a point to change the route. The router fills in each part with your routing options.

Network

Select junctions to Join or Delete them. Select segments to Merge, Route or Delete them.

Highlight

Drag the start, the end and the handles along the network's lines. Make a handle a U-turn to go out and come back.

Area

Change the outline. An area needs at least three sides, and its sides must not cross.

Editor options

Library snap makes a dragged point snap to your visible Library items, such as other plans, tracks or waypoints. Basemap snap makes it snap to things on the base map, such as peaks, places and trails. Both switches are in the editor's Options, and at the top of the Routing page.

Wireframe, in the plan and network editors, also shows each part as a dashed straight line. Routing then waits until you tap Save.

Want a quick route without editing a plan? Use a long press instead. See Long press.

Records and data types

Details on an item

An item can carry records of data. Each record has a data type, such as Camp or Water, so one waypoint can be a camp and a water source at the same time. Records give the map its markers and the card its rows.

Primary and secondary markers

A primary marker always shows with the item's name. A secondary marker folds into one row on the card, and does not show on the map. Note and Photo are secondary at first.

Data Type Sets

A Data Type Set lets you make your own kinds of data, or add to a built-in one. Each type has fields, such as text, a number or stars, and more. It also has a one-line summary for the card, and a marker. A type can also add behaviour. For example, it can list its items on a plan's Camps page, or add a Plan button to a highlight.

Rule sets

How items look

A rule set changes the look of many items at once, so you do not have to style each one. It holds a list of rules. Each rule picks some items, then sets part of how they look and act on the map.

Which items a rule picks

Applies to sets the kinds of item, such as waypoints, plans or areas. Conditions narrow it down, for example by name or by a data value, such as a camp with 4 stars or more. A rule can need all of its conditions, or any one of them. A rule with no conditions picks every item of those kinds.

Card and behaviour

A higher importance keeps the card on the map as you zoom out. Behaviour can hide the items. It can also stop a tap on a line or an outline from selecting the item.

Order and reach

Rules work from the top of the list down. A later rule changes only what it sets, and an item's own settings win over all rules. A rule set works on the items in its own folder and in the folders inside it. If a rule hides an item, the item's pages say Hidden by rule, with a button that opens the rule.

Default styles

The built-in Default styles rule set applies everywhere. It is not in the Library: open it from Settings with Edit default styles.

Offline maps and downloads

Take the map with you

Download an Offline Map before you walk beyond mobile signal. You choose the area as squares on the map, and the app keeps those squares on your device.

Choose the squares. Tap squares on the map to add them to the Offline Map, or to remove them.

Choose the area

Make a New Offline Map. While its page is open, tap squares on the map. Pending changes shows what will download and what will go.

Storage

In Settings, Storage sets how much space the app can use to keep map data you have already seen.

Search, import and export

Find, bring in, send out

Search finds what is already in your Library. Import brings in routes from other apps, and Export sends your items out as files.

GPXKMLor KMZGeoJSONVNXor VNZ KEEPS ALL IN · OUT Library
Files in and out. You can import and export all four formats. A Viatrail file (VNX) keeps everything, such as networks, data, data types and rule sets. The other formats keep less.

Search

Search looks through your Library. If you type a pair of coordinates, a pin drops there.

Import

Import opens files from other apps, such as GPX or KML files, and Viatrail's own files. Missing elevation can be filled in from terrain data.

Export

A Viatrail file (VNX) keeps everything, and the VNZ form also keeps photos. GPX keeps plans, tracks and waypoints. KML and GeoJSON also keep areas, and part of a network.