Differences

This shows you the differences between two versions of the page.

--- manual:user_guide:maps_external [2022/01/10 16:21] – [Android/Media directory] mstupka
+++ manual:user_guide:maps_external [2026/04/09 16:14] (current) – mstupka
@@ Line 3: / Line 3: @@
 ----
-===== Adding 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 ====
-**Locus Map** can also work with **external offline maps** acquired from other sources - PC software, cartography publishers, and other map providers. It is necessary to **copy these maps into your phone's memory or on an SD card**. There are a few options where to put the map files:
+  * open the **[[maps_mmanager|Map Manager]]**
-==== Locus/Maps directory ====
+  * tap **+** and select **Import map**
-The default directory for the raster maps. You can add your maps here in several ways:
+  * choose from a selection of **available drives**
-  * **Import** - open the [[manual:user_guide:functions:data_import|Import]] screen from Locus menu or a function panel, **find** the map file in your device storage and **confirm**
+  * choose the **map file** to import (unsupported files are greyed out):\\ {{ :manual:user_guide:ext_maps02.gif?nolink |}}
-  * **Tap & add** - open a system or any third-party file manager in your device, find the map file you want to add, and **tap it**. Locus Map is offered as one of the apps to load the file. **Select it**.
+==== 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 |}}
-==== Android/Media directory ====
+<WRAP center round info>
-=== Raster maps ===
+**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 external storage, use the latter.
+  * ///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 ===
+==== 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 external storage, use the latter.
+  * ///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>
-Vector maps' appearance can be changed by **themes**. 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 on the right place by the app.
+**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 important>
-**Android 11+**
-This option is available only after granting the app the **All files access** system permission. Do it right after the app's initialization or additionally in the system settings.
+==== Free choice of storage ====
+<WRAP center round info>
+**This option is available only in Android versions 5 - 10.**
 </WRAP>
-  * tap {{:manual:user_guide:add.png?nolink&20|}} in the Offline tab in the bottom right corner
+  * open the **[[manual:user_guide:maps_mmanager|Map manager]] > Offline tab**
-  * select {{:manual:user_guide:ic_map_add_alt.png?nolink&30|}} **External maps**
+  * tap {{:manual:user_guide:add.png?nolink&20|}} in the bottom right corner
-  * browse your device internal storage or SD card
+  * 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 map file's parent directory. The directory emerges as a **new folder** bellow the default Maps folder **[[manual:user_guide:maps_offline|Offline tab]]**.
+  * 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 tip>
+<WRAP center round important>
-  * **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 into individual subfolders and then add them one by one.
+**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.
-  * **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 a few to support so many of them:
+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)- plain SQLite database, with a tilestable, 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 >>]]
+  * **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.
+  * **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 are working.
+  * **RMAP** - an undocumented map format. Support by Locus Map is limited, and not all projections and map format versions work.
-  * **IMG** - Garmin maps format. Locus is able to work with non-paid and unlocked maps in this format but is not able to detect their coverage - therefore some map features like auto-load or Quick map switch do not work with them.
+  * **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.
+  * **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 support of 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.
+  * **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.
+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.

knowledge base

User Tools

Site Tools

Differences