{{ :manual:user_guide:ic_map_add_alt.png}}
====== External Maps ======

----
**Locus Map** can also work with **external offline maps** acquired from other sources - PC software, cartography publishers, and other map providers. The easiest way to get the maps into the app is to **import** them.
===== Import map =====
You can import a map file from both Locus Map and from any file browser.
==== Map manager ====

  * open the **[[maps_mmanager|Map Manager]]**
  * tap **+** and select **Import map**
  * choose from a selection of **available drives**
  * choose the **map file** to import (unsupported files are greyed out):\\ {{ :manual:user_guide:ext_maps02.gif?nolink |}}
==== File browser ====
  * find the map file in your **local storage**
  * long-press its name and select **open** or **send to**
  * **choose Locus Map** from the list of available apps
  * **confirm** importing the map file:\\ {{ :manual:user_guide:ext_maps03.gif?nolink |}}

<WRAP center round info>
**Import** of the map files stores them into the **[[.:settings:backup_fsys#set_the_main_directory|default map directory]]** of the app.
</WRAP>

===== Manual adding to the map directory =====
Another option is to add the map files manually. Choose this if you need to insert **multiple map files, vector maps or map themes**. The files can be inserted into the /Android/Media directory:
==== Raster maps ====
  * maps in //SQLiteDB, MBT, Gemf// etc. formats
  * ///Android/Media/menion.android.locus/Maps// directory. It is placed both in the internal storage and on the external SD card so if you want to save some space in your internal storage, use the latter.
  * **Copy** the map files into this directory via a system or third-party file manager
  * **Restart** Locus Map
==== Vector maps ====
  * maps in //.map// format, //.db// POI databases
  * ///Android/Media/menion.android.locus/MapsVector// directory. It is placed both in the internal storage and on the external SD card, so if you want to save some space in your internal storage, use the latter.
  * **Copy** the map files into this directory via a system or third-party file manager
  * **Restart** Locus Map
<WRAP center round important>
**Map themes can change vector maps' appearance**. The theme files must be placed in the default //Locus/MapsVector// directory. **OpenAndroMaps themes** - download them directly from their [[https://www.openandromaps.org/kartenlegende/elevation-hike-theme|website]], they'll be imported to the right place by the app.
</WRAP>
<WRAP center round tip>
**Maps stored in one (sub)folder are automatically merged.** Both as areas and zooms, i.e. you can go freely from one map to another, from one zoom in one map to another zoom in a different map without the need to switch between them manually. If you want to add external maps to Locus without merging them, store them in individual subfolders and then add them one by one.
</WRAP>

==== Free choice of storage ====
<WRAP center round info>
**This option is available only in Android versions 5 - 10.**
</WRAP>

  * open the **[[manual:user_guide:maps_mmanager|Map manager]] > Offline tab**
  * tap {{:manual:user_guide:add.png?nolink&20|}} in the bottom right corner
  * select {{:manual:user_guide:ic_map_add_alt.png?nolink&30|}} **External maps**:\\ {{ :manual:user_guide:ext_maps.jpg?nolink |}}
  * browse your device's internal storage or SD card
  * select the map file (or the whole directory with external map(s)) and confirm
  * the map emerges in the Map manager Offline tab in a folder named after the map file's parent directory. The directory appears as a **new folder** below, the default Maps folder **[[manual:user_guide:maps_offline|Offline tab]]**. 

<WRAP center round important>
**Do NOT add the native /Locus/Maps/ directory as an external folder** - there is no need to do so, and the app will display an error message.
</WRAP>

===== Supported Map Formats =====
There is a huge amount of map file formats, and **Locus Map** is proud to be one of the few to support so many of them:
  * **SQLite** (*.sqlitedb, sometimes referred to as **RMaps**) - plain SQLite database, with a tile table, that contains //x//, //y//, //z//, //image// columns with required data. Coordinates are computed by the [[http://wiki.openstreetmap.org/wiki/Slippy_map_tilenames|Slippy map system]]. SQLite files created by Locus Map when downloading online maps work fine, but there can be problems with some SQLites from other sources. Some of corrupted SQLite databases [[manual:advanced:map_tools:corrupted_sqlite|can be repaired >>]]
  * **TAR** - as we mentioned before, it is an obsolete map format, however, with wide support and available map material. For example famous OZI Explorer. This software uses its own //OZFX v2/v3// map format together with a calibration //*.map// file. TAR format is a very simple archive containing one //*.map// calibration file (including name, calibration points, datum, projection specifications, and more) and map images. 
  * **MBT** - [[http://mapbox.com/developers/mbtiles/|MBTiles]] is SQLite based map format, maintained by [[http://mapbox.com/about/|MapBox]] company.
  * **RMAP** - an undocumented map format. Support by Locus Map is limited, and not all projections and map format versions work.
  * **IMG** - Garmin maps format. To some extent, Locus Map can work with non-paid and unlocked maps in this format, but it is not able to detect their coverage; therefore, some map features like auto-load or Quick map switch do not work with them.
  * **GEMF** (*.gemf) - [[http://www.cgtk.co.uk/gemf|GEMF]] Map Store Format is fast and efficient. It enables storing raster map tiles in the same format (PNG, JPEG only) as SQLite, but in a faster and more efficient way. Unfortunately, it is not widespread much.
  * **MapsForge** (*.map) - [[https://github.com/mapsforge/mapsforge/|The MapsForge]] project is aimed on supporting OpenStreetMap-based Android applications. It provides its own binary format for OSM data, enabling applications to render their own maps on the fly from raw information. More on [[https://github.com/mapsforge/mapsforge/|MapsForge]] homepage.
  * **OruxMaps** - SQL-based format of maps designed for the [[https://play.google.com/store/apps/details?id=com.orux.oruxmaps|OruxMaps]] application.
  * **[[https://play.google.com/store/apps/details?id=com.crittermap.backcountrynavigator|Backcountry Navigator]], [[https://play.google.com/store/apps/details?id=com.trailbehind.android.gaiagps.pro|Gaia GPS]], [[https://play.google.com/store/apps/details?id=com.codesector.maverick.lite|Maverick]]** - their designated map formats
If you come across a map file in a format **not included in this list** and you would like to use it in **Locus Map**, there is no need to worry. There is a lot of desktop conversion software to solve the problem.