{{ :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 =====

  * **My Library > {{:manual:user_guide:tracks:add.png?nolink&20}} > Import**\\ {{ :manual:user_guide:mylib50.jpg |}}

===== 2. Select the storage =====
{{ :manual:user_guide:tracks:import8.jpg?nolink |}}
  * **Main directory** - contents of Locus Map's main app directory
  * **System File Manager** - launches the system file browser to select a file in accessible parts of the phone's storage. It **does not allow multiple selection** of imported files, unfortunately.
  * **Dropbox** — the contents of your Dropbox. A Dropbox login is required when using the drive for the first time. The logout option is included (see the top bar menu).
  * **OneDrive** - contents of your OneDrive. OneDrive login is required when using the drive for the first time. The logout option is included (see top bar menu).
  * <del>Google Drive</del> - <wrap alert>**Since September 2025, Locus Map's support for Google Drive has been banned as it was denied full access to the service.**</wrap>
  * **Remote file** - a field for inserting a URL of a remote file stored on the internet
===== 3. Select the file =====

  * **Importable files are in full color and are clickable** (more about supported formats see below).
  * You can sort the files by **name, size and creation date**:\\ {{ :manual:user_guide:tracks:import6.jpg?nolink |}}
  * If you are in Locus Map's main directory, in Dropbox or OneDrive, it is possible to **import more files at once**. Long-press one file to display the multi-select option:\\ {{ :manual:user_guide:tracks:import.jpg?nolink |}}
===== 4. 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 is loaded:\\ {{ :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 **particular folder in My Library** it is already **pre-selected.**
  * **Delete the folder content before import** - removes all other tracks or points from the selected folder before the import
  * **Display only (not save)** - tracks are just displayed on the map screen and not saved into the Library - useful for a quick preview of the imported file
  * **Use style of the parent folder** - the imported track will take the color, thickness, pattern, etc. defined for the folder it is imported to
  * **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.