Skip to main content

Trip recording

🚧 This article is incomplete

This article is incomplete & needs to be reviewed. You can help by creating a pull request.

Trip recording (Android) / Track recording (iOS) plugin is a special tool designed to record your routes, movements, and workouts. Thanks to this feature you can reuse, modify, update, and share your tracks with friends.

Overview​

Trip recording plugin is used to create new tracks, display recorded tracks on the map and work with existing records. It helps you analyze data such as speed, ascents, descents, or terrain features during your trip. The route can be recorded while navigating or simply on the go.

Recorded trip in Android

Setup​

To start recording tracks, you need to make the following settings:

  1. Enable the Trip recording plugin.
  2. Configure Trip recording parameters for the required profile.
  3. If needed, add Trip recording widgets to the screen.

After setup is complete, you can make new records, display and manage tracks on the map, change their appearance, edit the route, add waypoints, etc.

Record new track​

Distance/Start-Stop widget in iOS Distance/Start-Stop widget in Android

There are several options to start a new recording:

Start Dialog​

Start dialog opens, if the Show start dialog option is enabled in the settings section of the Start dialog box.

Start recording in Android

note
  • the Line icon opens the Track Appearance options, which allow you to customize the displaying of the track on the map.
  • Logging interval is used to set the frequency of the requests sent to the GPS sensor to detect and post a new point onto the route of the track.
  • in the Settings menu you can adjust parameters of your recording. For detailed information see trip recording parameters.
TROUBLESHOOTING

For any troubleshooting details, refer to: Track recording issues

Launcher (Android)​

Another option to start a new recording is to use the Start Recording icon on the device screen, as shown in the examples in the figures below. A long press opens the context menu of the icon with the option to Start Recording.

Icon's context menu Start Recording icon

note

Use long press on Start recording in the icon context menu to add it as a separate icon to the device screen.

Stop / Save / Pause

To stop the recording, tap on the relevant button in the Distance/Start-Stop (REC) widget dialog box, for the Android version you can also stop the recording by tapping the Main menu item Trip recording.

Π‘urrent track recording​

Overview screen​

To view information about currently recorded track tap on the Trip recording widget.

overview

The graph shows information about distance, altitude, slope angle.

note

The graph can be scaled.

  • You can use two-finger movement to zoom in and out for a more detailed view.
  • If you want to see information at a specific point, you can tap on the graph and a pointer with the values will appear.

All values on the graph are indicated either for the whole route or only for the selected interval (while scaling). The right side of the graphs contains data about the highest, average and lowest values. Overview - distance and speed, Altitude - elevation and grade, Speed - speed in current moment.

InfoPicture
Overview. This tab opens a graph with speed/altitude information on the distance and additional track data. "Overview" Information section: Distance, Time span, Start time, End time.data data
Altitude. This tab opens a graph with information about the altitude/grade of current trip recording and additional data about the trip. "Altitude" Information section: Average altitude, Altitude range, Uphill, Downhill.data data
Speed. This tab opens with speed info on distance and additional track data. "Speed" Information section: Average speed, Maximum speed, Time in motion, Distance corrected.data data
info

Here you can find more helpful information about Tracks context menu, about Appearence of the track on map and about adding track points to the current track.

Show on the map​

If the track displaying was previously disabled, you can enable it via Menu β†’ Configure map β†’ Tracks tab.

show_tr_onmap_andr_1 show_tr_onmap_andr_2

Recorded GPX file​

OsmAnd records tracks in a file in the GPX format, according to the following structure: file > track > segments > points, where:

  • One point has a number of attributes: coordinates, speed, altitude, heading.
  • Points are grouped into tracks.
  • The next point after the gap makes up a new segment.
  • Both segments and tracks are shown with the Start and Finish icons on the map.

GPX file of a recorded track

ParameterDescription
trkptPoint shows the detected geographical location of the user. Every point is provided with the latitude and the longitude as base attributes of the detected location.
trksegSegment groups points between gaps detected as absence of any movement within one recording.
latLatitude is one of the geographical coordinates to identify the location with.
lonLongitude is one of the geographical coordinates to identify the location with.
eleElevation is the hight of the point above the sea, calculated in meters.
timeTimestamp is the date and time of when the point was recorded.
hdopHDOP is one of the terms of GPS accuracy, horizontal accuracy, calculated in meters, abbrev. from Horizontal Dilution of Precision, determined as the error caused by the relative position of the GPS satellites.
speedSpeed is the rate, in meters per second, at which the user is detected to be moving.
headingHeading is the direction to where the front panel of the vehicle/device points to. The heading direction is calculated in degrees, and determined with the angle between the direction where the front panel points to and the course towards which the vehicle/device is intended to move. In navigation, the difference may exist due to the drift caused by the air, water, skidding, slipping, etc.

Recording settings​

Trip recording can be configured for each profile, as the parameters may be different depending on the character of the movement (a car driver, a cyclist or a Nordic walker). You may need to make some adjustments to the way you capture and record location points in the file: few, a lot, with gaps etc. to make the end result look smooth and usable. All profiles are configured in the global settings of the entire app. First, you need to select the required profile, and then among other profile settings find the section dedicated to Trip recording.

Depending on the character of your movement: driving, cycling, horseback riding, skiing, etc., you may need to make some adjustments to the way you capture and record location points in the file: few, a lot, with gaps etc. to make the end result look smooth and usable.

Configuring Trip recording in Android

ParameterDescription
Show start dialogIf enabled, you need to tap the respective option in the Start dialog to start recording. Otherwise, the recording will start automatically.
Auto-record track during navigationIf enabled, the track is automatically recorded during navigation and saved to the respective folder in My Places. Note that Track recording consumes the battery energy and continues to run in the background when the screen is closed. To use the battery efficiently, keep an eye on its status.
Logging intervalIt is the frequency of the requests to detect the location with subsequent logging of location points into the track, which is started to be recorded automatically via the enabled Auto-record track during navigation option. 5 seconds is the default option. Available are the options in the range from 0 seconds to 5 minutes.
General logging intervalIt is the frequency of the requests to detect the location with subsequent logging of location points into the track, which is started to be recorded manually via the Distance/Start-Stop widget. The option is duplicated on the Start recording dialog. 5 seconds is the default option. Available are the options in the range from 0 seconds to 5 minutes.
Minimum displacementGiven that two points are detected being close to one another, when a minimum displacement option is established, one of the points is removed, if it is detected to be closer than the established interval. It is helpful for none, or little movement, so that not to generate redundant points, regardless of any motion detection. The displacement interval is disabled if the Not selected option is set. Otherwise, an interval is considered to be between 2 meters and 50 meters depending on the selected option. For example, 5 meters is used, when there is no need in capturing more precise data than that, and no need in capturing any data at all when not moving.
Minimum accuracyGiven that your location is identified via the built-in Location module of the device, when the longitude and latitude are calculated, the resulted location point can be detected accurately to a certain extend and expressed in meters/feet. It is possible to establish a minimum threshold between 1 meter and 50 meters for calculating the accuracy of the detected location in relation to the real location. A too small accuracy may cause the existence of blank spots on the track. It is recommended to decrease the accuracy, or disable at all by establishing the Not selected option, in case of uncertainty of the quality of the signals used for identifying the location, whether it is the GPS signal, and/or the mobile phone signal, and/or the Internet connection. For example, GPS signal can be weaker in circumstances when the route goes under the bridge, or between large trees, or high buildings, or in unfavorable weather conditions; and better with the growing number of GPS satellites.
Minimum speedGiven that at low speed the recorded track can be noisy, showing a lots of points on a small segment of the route, when motion is detected and the speed level is calculated to be less than the established threshold, then the points will not be recorded. To disable the minimum speed detection, set the Not selected option. To detect only motion to start recording points, set the >0 option. The other options are recommended to use carefully and to avoid losing too many points, lower the minimum threshold.
Auto-split recordings after gapIf enabled, a new segment will automatically start after a 6-minute gap; a new track will automatically start after a 2-hour gap; and a new file will automatically start when the date has changed. The gap is determined as the absence of any point being recorded. Points can, or cannot be detected, and not recorded. It might happen due to a number of reasons as well as the current configuration of the Trip recording functionality. For example, the GPS signal is weak because of the current weather conditions and therefore, the location is not detected and not recorded. Or, the speed of the movement gets below the threshold, and thus, the location is actually detected, but not recorded. Such gaps in recorded data can be used to generate a new segment on the same track, or a new track in the same file, or a new GPX file within one recording identified as single start/stop actions performed once at a time.
Prevent standalone loggingIf enabled, Trip recording will automatically stop, when the OsmAnd app is stopped, and the notification bar of Android shows no indication of OsmAnd's working in the background.
Include headingIf enabled, the heading is saved into the GPX file for every point. The heading is the direction to where the front panel of the vehicle/device points to. It is determined with the angle between the direction where the front panel points to and the course towards which the vehicle/device is intended to move. In navigation, the difference may exist due to the drift caused by the air, water, skidding, slipping, etc.
Track storage folderGiven that all tracks are stored in: Menu β†’ My Places β†’ Tracks tab; it is possible to establish the internal structure of this folder by selecting one of the following two options: either 1. to record all tracks to the Rec folder; or 2. to group all tracks by respective month folders, such as: Rec/yyyy-mm
NotificationIf enabled, trip recording messages show up in the system notification area of the device. The notification area is opened with a swipe from the top of the screen to the bottom, and closed with a swipe in the opposite direction. The messages are intended to notify about all start/stop actions of the trip recording functionality and especially useful in case of the enabled Auto-record track during navigation option, as well as when the Start recording dialog is disabled and the recording starts silently on tap of the Distance/Start-Stop widget. Once a message is sent, it is visible in the notification area. A sent message can be cleared, if not needed. The visibility of a sent uncleared message does not depend on the status of the app: whether it runs in the background, foreground, or closed.
Online trackingIt is real-time monitoring of your current location. If the option is enabled and the recording is in progress, the Distance/Start-Stop widget is green, instead of red, and every point is transmitted to the specified URL. The Web address field is intended for entering the URL in the following format: https://example.com?lat={0}&lon={1}Γ—tamp={2}&hdop={3}&altitude={4}&speed={5} The Tracking interval parameter is used to determine the frequency of how often to send the location points. The options can be selected in the range from 0 second to 5 minutes. The Time buffer parameter establishes the period of time during which the points will be accumulated in case if the Internet connection is lost.
TracksThis is a quick re-direction to the folder: Menu β†’ My Places β†’ Tracks tab.
Reset plugin settings to defaultEstablishes default values for all of the above settings.
Copy from another profileOpens a profile selection dialog from which you can copy the established configuration of Trip record values and then set them for the current profile.

Widgets​

You can use widgets to view brief information about the track recording on the screen. Such as Distance, Duration, Uphill and Downhill for the Android version and for iOS version only Distance/Start-Stop.

To start using Trip recording widgets, you need to make all of the following settings:

  • Enable the plugin.
  • Configure Trip recording for the required profile or configure a general setting for all profiles.
  • Add the necessary Trip recording widgets to the screen. This setting is individual for each profile.

Add Recording widget​

The Distance/Start-Stop widget is used to quickly check if you are recording or not, and for quick access to the recording settings and information about it. The widget is added automatically when the Trip recording plugin is enabled.

You can delete or add the Distance/Start-Stop widget and other widgets by following:
Menu β†’ Configure screen β†’ Left panel β†’ Right panel β†’ Trip recording.

Adding Distance/Start-Stop widget in Android

Distance (Start-Stop)​

To open Trip recording widgets options follow:
Menu β†’ Configure screen β†’ Widgets β†’ Left / Right panel β†’ Trip recording

Trip recording widget Finish recording in Android

When the selected widgets appear on the map, you can tap any of them and more information about the track and the ability to interact with it will appear. In general, the Trip recording plugin for Android consists of 4 widgets. Distance/Start-Stop is the main widget, when you tap it opens the Trip recording dialog. The Duration, Uphill and Downhill widgets are more for information.

Distance/Start-Stop: shows the distance of the current trip recording. It is added automatically with the Trip recording plugin enabled, but you can hide the widget in Configure screen menu. The widget has 3 different views: Recording, Paused, Inactive.
Trip recording (REC) widget
If the Trip Recording Plugin settings have the Show Startup Dialog option enabled, tapping on the inactive widget will open the Trip recording dialog. If it is disabled, the recording will start immediately.
note

If the option Show Startup Dialog is disabled in the Trip Recording Plugin settings and the widget is active, tapping on it will open the Trip Recording Dialog anyway.

Duration, Uphill, Downhill​

Duration: shows the time, in hours and minutes, of the current trip recording.
widgets
Uphill: shows the sum of all the climbs of the current trip recording.
widgets
Downhill: shows the sum of all descents of the current trip recording.
widgets
note

If you have several widgets selected, Duration, Uphill, or Downhill, you don't need to switch between them by closing the dialog box that opens. The dialog box is the same for all these widgets.