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.

The plugin allows you to record, save and analyze your training or movement data, such as speed, ascents, descents or route relief, which can then be reused, improved, supplemented or shared with friends.

Overview​

GPS data consists of the latitude and longitude of your location at a specific point in time. If they are recorded in a file as a set of location points arranged in a specific order, the file stores the progress of your journey. Each point in the file also stores coordinates, speed, bearing and elevation. When you place points from the file on the map, your journey is visualized as a track with a fixed start and destination.

Trip recording functions: creating new tracks, displaying existing tracks on the map and working with finished recordings. The plugin should only be enabled to create new records.

Setup​

To start creating new records, you need to make the following settings:

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

After setup is complete, you can make new recordings, display and manage tracks on the map by changing their appearance, editing the route, adding waypoints, etc.

Recorded trip in Android

Enable plugin​

Trip recording plugin is needed for recording new tracks. It is possible to do with Distance/Start-Stop widget, added to the app by Trip recording plugin. To enable Trip recording plugin, open Plugins list and toggle the respective option.

To enable, tap the triple dots at the right side of the option and select Enable: Menu β†’ Plugins β†’ Trip recording

Enable / Disable Plugin Android

Add Recording widget​

The Distance/Start-Stop widget is needed to quickly check whether the recording is in progress 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

Open settings​

Trip recording can be configured for each specific profile, as the parameters may be different depending on the character of the movement, for example, to determine the location of a car driver, a cyclist or a Nordic walker. All profiles are configured in the general 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.

Menu Settings can be opened in two ways: app settings, or plugin settings.

APP SETTINGS​

Go to Menu β†’ Settings, select a profile and tap Trip recording.

Trip recording settings per profile in Android

PLUGIN SETTINGS​

The settings opened from the plugin. Go to Menu β†’ Plugins, tap the triple point at the right side of Trip recording, or tap the Trip recording option, select Settings.

Settings opened from the plugin Settings opened from the plugin

Establish options​

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, too many, spacing, and others to make the end result look smooth and usable.

There are recording parameters that you can adjust depending on the context. For example, the time interval, how often the Location module should detect your location; whether to record points or wait for the next detection result if the detection results are almost the same; if it is acceptable to generate separate segments within the same track in case of gaps, and so on. Use the descriptions of the available parameters specified for the corresponding Android or iOS version of the application.

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.

Create new track​

The Distance/Start-Stop widget is used to create new records.

  • To start recording, tap the Distance/Start-Stop widget, and confirm in the opened Start dialog, if it is enabled. Otherwise, confirmation is not needed, and the recording will start automatically.
  • When in progress, the Distance/Start-Stop widget is colored in red.
  • Distance/Start-Stop widget is colored green during in progress and when online recording is enabled.
  • To finish recording, tap the Distance/Start-Stop widget again and confirm the respective option in the Trip recording dialog. In addition, there are a few other options that you can use. All options are described in detail for iOS and Android versions.

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

START RECORDING​

There are four options for starting a recording:

And another one, use the Start Recording icon on the device screen as shown in the examples in the figures below.

NOTE: Long-tap to open the icon's context menu with an option to Start Recording. Long-tap an option from the icon's context menu, to add it as an individual icon to the screen of the device.

Icon's context menu Start Recording icon

In the opened Start dialog, it is possible adjust the following recording settings before confirming the start of the recording by tapping Start:

  • Show on map - if enabled, shows the detected points on the map.
  • Appearance - the Line icon - opens the Track Appearance options to adjust visual representation of how the track looks like when it is displayed on the map.
  • Logging interval - 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.
  • Settings - opens the Trip recording settings for the currently opened profile.

Start recording in Android

STOP RECORDING​

Tap the Distance/Start-Stop widget, or the Trip recording option in the menu again, to stop recording, and/or to do any of the following extra options in the Trip recording dialog:

  • Show on map - if enabled, to show the detected points on the map.
  • Appearance - the Line icon - to open and work with the Track Appearance options to adjust visual representation of how the track looks like when it is displayed on the map.
  • Start time / End Time - the timestamps of the first detected point and the last detected point.
  • Close - to close the Trip recording dialog and continue recording.
  • Pause - to take a break, and resume recording after a while.
  • Finish - to stop the recording. The track will automatically be put for storing in: Menu β†’ My Places β†’ Tracks tab.
  • Options - to reach out for the following options in the context menu:
    • Clear recorded data - to delete, if any accumulated unsaved data.
    • Stop without saving - to stop recording without saving a track.
    • Stop online tracking - to stop sending recorded points to the specified online resource.
    • Save and continue - to save the track for storing and continue recording further.
    • Start new segment - to start a new segment of the current track. The number of segments are available for analysis with the context menu of the track.

NOTE: For any troubleshooting details, refer to: Track recording issues

Manage tracks​

After recording and saving, the tracks can be managed as follows:

  • In My Places, so that to view all ever recorded data pieces in the GPX format.
  • In Configure map, so that to select a specific track and display it on the map.
  • With the Context menu of the track on the map, so that to adjust the appearance, to update points on the route, to view segments, to start navigation along the track/segment, and/or other options.

View all tracks​

All tracks ever recorded are automatically displayed in My Places. This is the central storage of all user-generated information, organized in tabs according to the main criterion of saved data. There are favourites, notes, and tracks. Browse through Tracks tab to find any trip recordings.

More information about My Places, and/or Tracks stored in it can be found in the relevant sections of the current documentation. However, it makes sense to underscore here that:

  • The internal organization of the Tracks tab in My Places can be managed with the Trip recording plugin settings described above.
  • This is a useful place to consult with in case of doubts, for example, on what/if something is recorded, what/if something is visible right now on the map, and so forth.
  • My Places is perfect for any inventory work: tap the triple points/arrow at the right side of a track to manage it with any of the options, such as Move, Rename, Share, etc.

To view all ever-recorded tracks, and/or manage them, go to: Menu β†’ My Places β†’ Tracks tab.

My Places with tracks in Android

Show tracks on map​

Tracks are an individual data layer that can be shown or hidden using the corresponding option in the Configure map menu or in the My Places menu. In addition, when you tap on Tracks, a track selection dialog appears, allowing you to choose which track or multiple tracks to display on the map.

For a specific profile, to display a track on the map, open Configure map and tap Tracks. Then from the opened dialog, check the needed track. To hide a track, either uncheck it from the list of tracks, or toggle off the Tracks option in the Configure map menu: Menu β†’ Configure map β†’ Tracks.

Show tracks on the map in Android Select a track to display in Android

To display a track on the map another way, open the My Places menu and then Tracks. The Visible folder displays the tracks already selected. In the Rec, Import and Tracks folders, you can select one or more tracks to display on the map by tapping the Show on map icon on the bottom menu of the screen. Go to: Menu β†’ My Places β†’ Tracks tab.

Show tracks on the map Android

Options of context menu​

When a track is displayed on the map, tapping on it, the track context menu appears. For detailed information about each available option, refer to the respective section of the current documentation. Here is an overview of the options:

  • Basic info to show the distance, ascending and descending areas, description and quick action buttons, such as whether to show the track on the map, its appearance, points and if to place the track for navigation.
  • Graphs for analysis of altitude and speed.
  • Tab for any overview and/or updates of points and waypoints.
  • And other options: appearance, analysis of split intervals, sharing, editing, renaming, etc.

When you tap the track directly on the map, the track context menu appears, providing a basic overview of the track as well as more analytical data for investigating the route and making adjustments to points and waypoints, if necessary. You can also edit the track with the Plan route tool, in the context menu open the track in this tool and edit it: delete or add points, cut the track before or after a certain point. For more information, refer to Track Context Menu.

Context menu of a track in Android

Change folder​

All recorded tracks are stored My Places. This is the only storage location for tracks. Even when moved, tracks are moved between folders in My Places. However, as soon as a new track is created, it is automatically saved to the default folder in My Places. The default folder is one and the same for all new tracks. After showing up in the default folder, tracks can be moved to any other preferred folder, as follows:

  • Select more options from the Context menu of a track on the map.
  • Tap Change folder and select another folder in My Places to store the track in.

Default folder in My Places for saved new tracks: Menu β†’ My Places β†’ Tracks tab.

The default folder can be established in Trip recording settings as one of the following options:

  • The Rec folder, which is one folder for all tracks.
  • The Rec/yyyy-mm folder is created individually for each month and contains tracks recorded during that month.

Then you can move the track to any other preferred folder in the My Places using the:

CONTEXT MENU ON THE MAP​

To move a track to another folder inside My Places, you can use Context menu of a track on the map as follows:

  • Open the Context menu of a track on the map in one of the following ways:
    • By tapping a track in My Places, the map shows up with the context menu opened for the track.
    • By tapping a track directly on the map.
      In any case, make certain the track is visible on the map.
  • Tap Options.
  • Tap Change folder from the opened Options list.
  • Select a folder to move the track to.

More options in Android Change folder in Android

CONTEXT MENU IN MY PLACES​

To move a track to another folder inside My Places, you can use Context menu of a track in My Places as follows:

  • Open: Menu β†’ My Places β†’ Tracks tab.
  • Tap the triple points on the right of the required track.
  • Tap Move from the opened context menu.
  • Select a folder to move the track to.

Move with My Places in Android

Trip recording widgets​

You can use them 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.

Pre-use Setup​

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.

Open Distance/Start-Stop widget options​

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

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, Trip recording plugin for Android consists of 4 widgets. Distance/Start-Stop is the main widget, when you tap it opens Trip recording dialog. The Duration, Uphill and Downhill widgets are more for information.

Β 
Trip recording widget Finish recording in Android

Distance/Start-Stop: shows the distance of the currently recorded trip. It is added automatically with the Trip recording 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 Show start dialog is enable in Trip recording Plugin settings, then tapping on the inactive widget opens the Trip recording dialog. If it is disabled, it will immediately start recording.
NOTE. If Show start dialog is disabled in Trip recording Plugin settings and widget is active, then tapping on it opens the Trip recording dialog, anyway.

Details

  • Name of the dialog box - Trip recording
  • Status: Recording / On pause
  • Buttons: Show on map on/off and Appearence.
  • Graph
  • Information box. There is a different list for each of the graphs.
  • Menu: Close, Pause/Resume, Finish, Options.

Open widgets options​

Duration: shows time of track recording the duration in minutes/hours of the currently recorded trip.
widgets
Uphill: shows the sum of all the climbs of the currently recorded trip.
widgets
Downhill: shows the sum of all descents of the current recorded trip.
widgets

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.
On the graph you can see the information about distance, altitude, slope angle. The graph can be scaled.

Description of trip recording information dialog box

  • Track. Currently recording track - general name of the dialog.
  • "Track: 1" is the default name of the track if you haven't set it before (you can change it with Trip settings). ???
  • Graphs Overview, Altitude, Speed, info block with Average altitude, Altitude range, Uphill, Downhill and two menus: Analyse on map and Options.
  • There are menu items below the graph: Overview, Track, Points, Options.
    NOTE. By default, the Track menu appears when you tap on the widget.

whats_in_screen

Interactions with the graph

  • Zoom in/out. By default, the graph shows the full recorded path at the current time. You can use two-finger movement to zoom in and out for a more detailed view. You can also move the graph to the right and left from the start of recording to the current moment.
  • Place a point on the graph. If you want to see information at a specific point on your trip recording, you can tap anywhere on the graph and a pointer with the values will appear. Overview - distance and speed, Altitude - elevation and grade, Speed - speed in current moment.

Graph
All values are indicated either for the whole route or only for the selected interval by scaling the graph.

Additional information. The right side of the graphs contains data about the highest, average and lowest values of the data related to a particular graph. Overview - distance and speed, Altitude - elevation and grade, Speed - speed in current moment.
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
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
Speed This tab opens with speed info on distance and additional track data.
data

Menu
You can read more information here.

  • Overview
    • Currently recording track - general name of the dialog.
    • A list of information about currently recording track: Distance, Uphill, Downhill, Altitude range, Average speed, Maximum speed, Time span, Time in motion. This list is scrollable.
    • Direction and distance to the point on the track / Your current location (if you allowed).
    • Buttons: Show on map on/off and Appearence.

Β  Overview

  • Track - described above.
  • Points
    You can add one or more track points to the current track map or delete them all. Read more here.

Overview Overview Overview

  • Options
    This is a separate screen without a map and a track with points:
    • Show on map - on/off.
    • Appearance.
    • Analyze on the map.
    • Analyze by intervals - overview of the current track recording segment.
    • Share - gpx file.

Β  Overview

GPX file details​

The location points are recorded into 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.
  • One track is generated by one recording, i.e. one start and one stop actions.
  • With auto-split after gaps, the next point after the gap makes up a new segment.
  • Both segments and tracks are identified with the Start and Finish icons on the map.
  • Both tracks and segments are recorded into a file.

Below is an example of a point and a segment in the track.

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.