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.
Quick reference
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 symbolGetting around
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.
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 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 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
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.
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.
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.
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
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.
Recording needs precise location access. With approximate location, the position is only good to about a kilometre, so Viatrail does not record.
Map symbols
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.
The smallest mark for one item, on its exact point. It keeps up to three colours, but has no icon or text.
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.
One item with several kinds of data. It shows up to three markers, with the strongest first. There is no count.
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.
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.
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
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.
| Ground | Light | Dark | OpenStreetMap land types |
|---|---|---|---|
| Easy ground | No fill: the background | ||
| Forest | forest | ||
| Water | water, river, reservoir, ocean | ||
| Wetland | bog, marsh, string_bog, swamp | ||
| Farmland | farmland, farmyard, orchard, vineyard and similar | ||
| Glacier | glacier | ||
| Rock and scree | bare_rock, scree, shingle |
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.
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
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.
These colours show only in the editor. On the normal map, a plan uses its own line colour.
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.
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.
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
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.
These are your own waypoints, and points in a visible network, that have Camp, Shelter, Hotel or Settlement data. Hidden items are not used.
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 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.
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
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.
These colours come from the built-in Default styles rule set. Your own rule sets can change them.
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
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.
Drag a point to change the route. The router fills in each part with your routing options.
Select junctions to Join or Delete them. Select segments to Merge, Route or Delete them.
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.
Change the outline. An area needs at least three sides, and its sides must not cross.
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
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.
CampWaypoint · rating, flat, sheltered, water
ShelterWaypoint · rating, booking, beds
HotelWaypoint · rating, booking, rooms
SettlementWaypoint or area · hotels, resupply
WaterWaypoint · rating, seasonal
ShopWaypoint · resupply
RouteHighlight · rating
TerrainHighlight · road, trail, cross-country, bush bash
HazardWaypoint, highlight or area · description
NoteAny item · text
PhotoAny item · photos
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.
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
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.
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.
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.
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.
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
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.
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.
In Settings, Storage sets how much space the app can use to keep map data you have already seen.
Search, import and export
Search finds what is already in your Library. Import brings in routes from other apps, and Export sends your items out as files.
Search looks through your Library. If you type a pair of coordinates, a pin drops there.
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.
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.