Tracks
This article is incomplete & needs to be reviewed. You can help by creating a pull request.
Overviewβ
Track on the map is user recorded trip or plan route with makred points on it or not. OsmAnd track file has gpx-format.
You can add / create tracks to / in OsmAnd in these ways:
- Import from the external source.
- Create in the application using Plan route tool.
- Record in the application using Trip recording plugin.
All tracks in the application are stored in the Menu β My Places β Tracks.
Abilities to manage tracks in OsmAnd:
- Enable and disable tracks on the map.
- Configuring track appearance, editing and analyzing.
- Using for navigation.
OsmAnd has no limit on the number of tracks to store and display.
There are three options to display Tracks on the map:
- Configure map menu.
- My places menu.
- Track Context menu.
Formats: OsmAnd uses GPX format for tracks and points.
Import: the app can import GPX, KML, KMZ formats of tracks and points.
- Android
- iOS
Create / Edit Trackβ
Coordinate inputβ
A simple and fast tool for creating points by specifying geographic coordinates. Read how to add points by coordinates: By Coordinate input
Record trackβ
Use the OsmAnd Trip recording Plugin and special widgets to record your tracks. Trip recording (Android) or Track recording (iOS) plugin is a special tool designed to record your routes, movements, and workouts. This feature allows you to reuse, modify, update, and share your tracks with friends.
Edit tracks with Plan a routeβ
Add waypointβ
- Android
- iOS
Waypoints are one kind of point available on the map. The description is in the article Points on the map. In general, waypoints are track points that are part of GPX files. They can be added to the currently recorded track or to any track from your My Places β Tracks list using the Map Context Menu. Waypoints are automatically displayed if the selected track is enabled on the map.
To create a waypoint use a long-tap on the map at any chosen location. In the opened Map Context Menu you can set information about the waypoint.
- Add the name of the waypoint, the address of the selected place and a description for it.
- Select Group.
- You can select previously created categories of groups or create a new one.
- For a new group (in the application it is also called a new category) of waypoints you create a name and an appearance. The icon, its color and shape will be used for all new waypoints added to the group.
- Appearance setting:
- Icon from the list: Default, Special, Amenity, Transport, Service, Symbols, Sport, Emergency, Travel, Nautical, Education, Industrial.
- Color of the icon.
- Shape of the icon: Circle, Octagon, Square.
- Replace another point with this, if you need to.
Quick actionβ
You can also add a waypoint as a Quick action. Follow the Add track waypoint to configure.
Waypoint format descriptionβ
<gpx version="1.1" creator="OsmAndRouterV2" xmlns="http://www.topografix.com/GPX/1/1" xmlns:osmand="https://osmand.net" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.topografix.com/GPX/1/1 http://www.topografix.com/GPX/1/1/gpx.xsd">
<wpt lat="43.5368866" lon="3.7396109">
<time>2023-05-24T04:42:07Z</time>
<name>Test</name>
<desc>description test</desc>
<type>Waypoints test</type>
<extensions>
<osmand:icon>special_sun</osmand:icon>
<osmand:color>#eecc22</osmand:color>
<osmand:background>square</osmand:background>
<osmand:amenity_subtype>building</osmand:amenity_subtype>
</extensions>
</wpt>
</gpx>
Parameter | Description |
---|---|
lat | Latitude is one of the geographic coordinates by which you can determine a location. |
lon | Longitude is another of the geographic coordinates by which you can determine a location. |
time | Timestamp is the date and time when the point was recorded. |
name | Name is the name of the point. Any characters are allowed. |
desc | Description contains additional information about the point. |
type | Select group is the name of the OsmAnd folder in which this waypoint is saved. |
Extension | Description |
---|---|
osmand:icon | Icon is the name of the icon you selected. |
osmand:color | Color is the color in HEX format. |
osmand:background | Background is the shape of the icon, such as a circle, octagon or square. |
Waypoints are recorded together with the track in the GPX file. Each of these waypoints has its own set of tags for description. All tags that are directly related to the description of waypoints and that can be edited directly in the OsmAnd application are listed in this section.
To change the Waypoint description, you can go one of the following ways:
Find the required track in the Menu β My Places β Tracks tab list.
Tap the track on the map, if it is included in the list of visible.
Tap the required waypoint if it is visible on the map.
Then in the Tracks Context menu tap Points, the field of the required folder with available waypoints and the Waypoint you are looking for. Select menu Actions β Edit GPX waypoint and make changes. You cannot change the creation date of a point, timestamp, in the application.
Amenity tags that describe additional information, such as hours of operation or phone number, specific to the POI take that information from OpenStreetMap data or data that you entered when creating the POI. You can edit such tags and custom tags only in the code of the GPX file, which you can open with any text editor on your device.
Display custom GPX tagsβ
<gpx version="1.1" creator="OsmAnd" xmlns="http://www.topografix.com/GPX/1/1" xmlns:osmand="https://osmand.net" xmlns:test="https://test.net" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.topografix.com/GPX/1/1 http://www.topografix.com/GPX/1/1/gpx.xsd">
<wpt lat="37.5460870" lon="-77.4532843">
<time>2023-06-07T12:31:35Z</time>
<name>Test</name>
<type>SOTM</type>
<extensions>
<osmand:address>Floyd Avenue (The Fan) 907, Richmond</osmand:address>
<osmand:icon>place_town</osmand:icon>
<osmand:background>circle</osmand:background>
<osmand:color>#ff4e4eff</osmand:color>
<test:country>United States</test:country>
<test:state>Virginia</test:state>
<test:telephone>(804) 828-0100</test:telephone>
<test:postcode>23284</test:postcode>
<test:start_date>Thursday, June 8, 2023</test:start_date>
</extensions>
</wpt>
</gpx>
To describe points, you can use the basic tags available in OsmAnd, which you can add and edit directly in the application. Or you can use custom tags for the description. These tags cannot be edited in the application, you need to use a text editor.
The official documentation of the gpx standard here.
Locations along the routeβ
Waypoints, points of interest (POIs), Favorite points and Audio/video notes all refer to the concept of saving locations and routes in GPX (GPS Exchange Format). You can use the same tags to describe and edit them.
Waypoints are individual points on a map or route. They are used to mark certain places that may be important for navigating or recording your travels. For example, you can create a waypoint on the map to indicate an important intersection or change of direction.
Points of interest(POI) are places of special interest to the user. These can be landmarks, restaurants, hotels, gas stations, and other places of interest that the user wants to note or visit.
Favorite points are places that the user finds particularly important or interesting and saves to their list of favorite places. They can include any location that the user wants to easily find and return to later.
Audio/video notes. In GPX format, you can save audio and video recordings as waypoints. This allows you to associate media files to specific locations on the map or route.
All of these point types can be saved in GPX format to provide the user with location information and help with navigation and route planning. They serve different purposes, but the general idea is to store and transmit geographic information so that the user can use it in their navigation tasks.
Waypoints folderβ
Track Context menu β Points β Three dots menu
All waypoints of the route are stored in the folders you selected for them when creating or editing. To access a specific folder, you need to open the required track and go to the Points submenu. In the three points menu, you can edit a group of waypoints, add them to your marker list, or create a folder in Menu β My Places β My Favorites. You can read more information in the article Tracks Context menu.
My Places menuβ
The My Places menu allows you to organize and manage your personal points of interest, and provides convenient tools for saving, editing and using this data.
Main features of the My Places menu:
- Create Points of Interest. In this menu, you can create new points of interest by marking places you are interested in. It can be a meeting place, vacation, travel, restaurant, store and more. You can add title, description, photos and even choose an icon for each point.
- Edit and Delete. The My Places menu provides the ability to edit information about saved points of interest. Users can update names, descriptions, photos and coordinates. There is also a delete function if the point is no longer relevant.
- Categories and Hashtags. You can organize your points of interest into different categories such as Restaurants, Parks, Attractions, and other. Hashtags can also be used for easier searching and filtering of places.
- Export & Import. The My Places menu allows you to export and import point of interest data. This is useful if you want to share your places with friends or save them on another device.
- Navigation and Route Management. Saved points of interest can be used as intermediate waypoints. You can include them in trip planning and navigation, making the process more convenient and customizable.
My Places menu benefits:
- Personalization. The menu allows you to create your own places and organize them as you see prefer.
- Integration with navigation. Points of interest can be used in route planning to help you find places of interest quickly.
- Ease of use. With categories, hashtags and editing capabilities, you can easily manage your POI data.
- Synchronization. The optional data export and import feature allows you to save and use your points of interest information across devices.
Actionsβ
- Android
- iOS
Menu β My Places β Tracks
- "+" button - allows to import GPX track from device storage.
- "earth" button - opens Add point menu for adding points by inputting coordinates.
- "map" button - allows to choose tracks for showing its on the map.
- "π" button - allows to choose tracks for deleting.
- "β³" button - allows to refresh tracks list.
- "OSM editing" button - allows you to upload the selected track to the OSM.
Menu β My Places β Tracks
ACTIONS
- Import tracks - open tab "Import from documents" and next description "To import your GPX files (common GPS data format) from Dropbox, Email, or any other source use "Copy to OsmAnd Maps" option", My files.
- Create new track - opens "Plan route tool" for creating a new track.
Buttons in "β¦" menu
- "export" button - allows to export choosing GPX file or files by anyways (messengers, email) or save to My files.
- "map" button - allows to choose tracks for showing its on the map.
- "OSM editing" button - allows you to upload the selected track to the OSM.
- "π" button - allows to choose tracks for deleting.
Searchβ
Tap the "π" button at the top of the device screen to open the track list sorting menu.
Sortβ
Tap the "sort" button at the top of the device screen to open the track list sorting menu tool.
Sort menu:
- Last modified - sorting tracks in the list by last modified.
- Name: A β Z - sorting tracks in the list by name A β Z.
- Name: Z β A - sorting tracks in the list by name Z β A.
Import / Export trackβ
Import trackβ
There are two variants for importing a track file in OsmAnd. The first is importing by clicking on a track file, the second is by My Places menu action.
- Importing track by clicking to GPX (KML, KMZ) track file (massengers, email, Drive, File managers..). It suggests to open it by OsmAnd app. Importing tracks save in "Import" folder of My places menu: clicking to the chosen GPX file β opening it by OsmAnd.
- Importing button in My places menu β Tracks.
- Track GPX file:
- Multitrack GPX file: saving as one GPX track or selected tracks.
- Android
- iOS
![]() | ![]() |
![]() | ![]() |
Export trackβ
- Android
- iOS
Exporting track file or files to any massengers, email, file managers, Drive , apps. There are two general ways:
- By Track Context menu β Share.
- By Local backup file. Exporting GPX-tracks as OSF-file.
Exporting track file or files to any massengers, email, file managers, Drive , apps. There are two general ways:
- By Track Context menu β Share.
- By My Places menu β Tracks β β¦ β "export" button. Exporting more than one track by a bundle (It's the case of Local Backup).
- By Local backup file. Exporting GPX-tracks as OSF-file.
Manage tracksβ
After recording and saving, tracks can be managed as follows:
- In My Places, you can view all GPX data that has ever been recorded.
- In Configure map, 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.
Dashboard Androidβ
Menu β My Places β Tracks
Information section that allows you to view the overall statistics for all tracks in the selected folder.
- The number of tracks in the folder.
- Total sum of distances.
- Sum of uphills.
- Sum of downhills.
- Sum of duration time.
- Total size of downloaded files in MB.
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.
- Android
- iOS
Menu β My Places β Tracks tab
Menu β My Places β Tracks tab
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.
- Android
- iOS
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.
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.
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.
To display a track on the map another way, open the My Places menu and then Tracks. The Tracks on map 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 first tapping the three dots in the upper right corner and then tapping the Show on Map icon on the bottom menu of the screen. Go to: Menu β My Places β Tracks tab.
Options of context menuβ
- Android
- iOS
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.
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.
- Android
- iOS
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.
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.
Default folder in My Places for saved new tracks: Menu β My Places β Tracks tab.
You can then move the track to any other preferred folder in My Places and/or export the GPX file to an external storage device.
MOVE TRACK WITHIN MY PLACESβ
To move a track from the default folder to another folder in My Places, do the following:
- 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 the triple points on the extreme right of the bottom panel.
- Tap [object Object] from the opened [object Object] list.
- Select a folder to move the track to.
EXPORT GPX FILE TO EXTERNAL STORAGEβ
To export a GPX file to an external storage, do the following:
- 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 Export.
- Select the required storage to export the GPX file to.