{{ :manual:user_guide:ic_import_alt.png?nolink|}}====== Import of Tracks and Routes ======

----
===== About =====
Import is used when you want to **work with tracks or routes from outside of Locus** - websites, apps, add-ons etc. Either you choose the data yourselves or Locus Map receives them.
===== 1. Launch import =====
There are a few ways:
  * **Tracks & routes manager > {{:manual:user_guide:add.png?20|}} > Import**\\ {{ :manual:user_guide:tracks:trackimport02.jpg?nolink |}}
  * **Tracks & routes manager > folder menu > Import** - imports directly into the selected folder\\  {{ :manual:user_guide:tracks:trackimport03.jpg?nolink |}}

===== 2. Select the file to import =====
**Locus file browser** opens the last used memory drive. **Importable files are in full color and are clickable** (more about supported formats see below). **Long-press one file to display the multi-select option**. It is possible to import more files at once:\\ {{ :manual:user_guide:tracks:import.jpg?nolink |}}
You can sort the files by **name, size and creation date**:\\ {{ :manual:user_guide:tracks:import6.jpg?nolink |}}
Other available drives can be selected by tapping the entry button in the file path:\\ {{ :manual:user_guide:tracks:import7.gif?nolink |}}
  * **Local** - the content of the device's internal storage.\\ <WRAP center round info>
**Android 11+**

Since Android 11 Locus Map is not permitted to access the whole internal storage. Therefore there are two other options:
  * **Main directory** - contents of Locus main app directory
  * **Device storage** - system file browser is launched for selecting the file.\\ {{ :manual:user_guide:tracks:import8.jpg?nolink |}}
</WRAP>
 
  * **Dropbox** - contents of your Dropbox. Dropbox login is required when using the drive for the first time. Logout option is included (see top bar menu).
  * **Google Drive**  - contents of your Google Drive. Google Drive login is required when used for the first time. Logout option is included (see top bar menu).
  * **OneDrive** - contents of your OneDrive. OneDrive login is required when used for the first time. Logout option is included (see top bar menu).
  * **Remote file** - a field for inserting a URL of a remote file stored on the internet
===== 3. Select where to import =====
After selecting the file or receiving it from some external application or add-on Locus Map analyses it and modifies the import dialog according to the content - the dialog can process points or tracks or both of them at once. 
==== Track import dialog ====

Appears when the imported file contains just tracks:\\ {{ :manual:user_guide:tracks:trackimport.jpg?nolink |}}
  * topbar displays the file name
  * **Folder selector** - select the folder into which the file will be imported. You can create a new folder directly from the menu. If you start importing from a //folder action menu// in the //Tracks manager// it is already pre-selected.
  * **Delete other tracks in folder** - removes all other tracks from the selected folder before the import
  * **Use style of the folder** - the imported track will take color, thickness, pattern, etc. defined for the folder it is imported to
  * **Display only (not save)** - tracks are just displayed on the map screen - useful for a quick preview of the imported file
  * **Show on the map after import** - displays imported tracks on the map when the import is finished
  * **Update elevation** - adds or updates the value of imported tracks' elevation (both only if the offline elevation data is available)
  * **Cancel** - aborts the action
  * **Import** - confirms the action
===== Supported file formats =====
Locus Map tracks import supports following file formats:
  * {{:manual:user_guide:ic_file_type_kml_alt.png?nolink&30|}} **KML and KMZ** 

<wrap info>Supported both for //Import// and //Export//</wrap>

[[https://developers.google.com/kml/documentation/|Keyhole Markup Language]] is XML based plain text format with really wide range of usage. Since the version 2.2 KML format is standardized by OGC so it is used by many web/desktop/mobile applications as well as Locus Map. 

  * {{:manual:user_guide:ic_file_type_gpx_alt.png?nolink&30|}} **GPX**
 
<wrap info>Supported both for //Import// and //Export//</wrap>

[[http://www.topografix.com/gpx.asp|GPS eXchange format]] is an XML based text format used for handling points, tracks and routes. Locus fully supports all valid tags. More detailed description of GPX format is available on this [[http://en.wikipedia.org/wiki/GPS_eXchange_Format|Wikipedia page]]. 

  * {{:manual:user_guide:ic_file_type_tcx_alt.png?nolink&30|}} **TCX**
<wrap info>Supported both for //Import// and //Export//</wrap>

[[http://en.wikipedia.org/wiki/Training_Center_XML|Training Center XML]] is a data exchange format introduced as part of Garmin's Training Center product. The XML is similar to GPX since it exchanges GPS tracks, but treats a track as an Activity rather than simply a series of GPS points. TCX provides standards for transferring heart rate, running cadence, bicycle cadence, calories in the detailed track. It also provides summary data in the form of laps. 

  * {{:manual:user_guide:ic_file_type_json_alt.png?nolink&30}} **GeoJSON**
<wrap info>Supported for //Import// only</wrap>

[[https://en.wikipedia.org/wiki/GeoJSON|GeoJSON]] is an open standard format designed for representing simple geographical features, along with their non-spatial attributes, based on JavaScript Object Notation.