<WRAP center round todo 80%>
**Screenshots to be taken (remove this box when done)**

</WRAP>

====== Live map ======

{{:main_live_default.svg?nolink&100 |}}

<WRAP center round info 60%>
While the map screen is shown your mobile device will for your convenience not automatically switch off any longer. You have to leave this screen in order to return to automatic (timed) switch-off for power conservation. Of course, manually switching on and off your mobile device still works as usual.
</WRAP>


{{ :en:livemap_1.png?direct&400 |}}

===== Top Bar Menu =====
{{anchor:top_bar_menu:}}

{{ :en:livemap_2.png?direct&400 |}}

<WRAP center round info 100%>
The icons shown in the top bar and the contents behind the overflow menu button are distributed dynamically based on your device resolution and screen orientation. Thus it might be possible, that more or less items can be found behind the menu button or instead shown as icons in the top bar on your device.\\
In case a menu entry is shown as an icon you can long press the icon to get a popup showing its function.
</WRAP>

^ Icon ^ Function ^ Description ^
|{{ :en:livemap_mapname.png?nolink&150 |}}|Map info|Shows the current map status: ''Live Map'' in case the map is live, ''Map'' if live update is disabled or the name of a list which is shown on the map.\\ Furthermore the amount of caches visible on the map is shown.|
|{{ :settings_map.png?nolink&40 |}}|[[livemap#map_settings|Map settings]]|This button is shown on bottom center of the map and will open a quick settings menu containing several options to customize the map display (e.g. hiding of certain elements).|
|{{ :en:livemap_progress.png?nolink&80 |}} |Progress spinner|A small blue line directly underneath the title bar is shown as progress indicator while the live map is loading data from the geocaching servers and/or from your cache lists. It will disappear if the live map has finished loading.|
|{{ :ic_menu_mylocation_off.svg?nolink&40 |}}{{ :ic_menu_mylocation.svg?nolink&40 |}}|Center Position|This button can be used to center the map on your current position. \\ \\ If the map is centered to your position a filled icon is shown.|
|{{ :ic_action_layers.svg?nolink&40 |}}|Map Source Selection|Use this button to change the active [[..:mapsources|map source]]\\ \\ If visible in the top bar, a long tap will choose the last used map source.|
|{{ :ic_menu_filter.svg?nolink&50 |}}|[[..:cachefilter|Filter]]|Tapping this icon will open a filter dialog to filter the caches on your map according to various criteria. \\ \\ If visible in the top bar, a long tap will open a list of the stored filters to change the active filter.|
|{{ :three_dot_vertical.svg?nolink&40 |}}|Overflow Menu Button|Tapping here will open the menu of functions not fitting into the top bar on your device, thus being displayed as a list instead. The function shown in this list are also described in this table.|
|{{ :ic_menu_marker.svg?nolink&40 |}}|Markers|Opens a dialog to activate/deactivate the [[..:cachefilter|named filter]] markers shown on the cache icons. A long tap toggles the markers on/off directly.|
|{{ :ic_menu_sync_enabled.svg?nolink&40 |}} {{ :ic_menu_sync_disabled.svg?nolink&40 |}}|Enable/disable live|This function turns the live map update on/off.\\ \\ If the live map is disabled, the slashed icon is shown.\\ \\ Long tap will activate plain offline mode.|
|{{ :ic_menu_hint.svg?nolink&40 |}}|Hint|Only shown if a cache is set as target and has a hint or note. Shows the hint of the target cache.|
|{{ :ic_menu_compass.svg?nolink&40 |}}|Compass|Only shown if a cache is set as target. Opens the compass for the target cache.|
|{{ :ic_menu_edit.svg?nolink&40 |}}|Log visit / Quick offline log|Only shown if a cache is set as target. Opens the [[..:logging|logging window]] for the target cache or allows to create a quick offline log.|
|{{ :ic_menu_save.svg?nolink&40 |}}|Store caches offline|Stores all caches visible on the map onto your stored caches list. Caches already stored will be refreshed during this process.|
|{{ :compass_rose_mini.svg?nolink&40 |}}|Map rotation|Opens a menu to select the map rotation: ''Off'', ''Manual'', ''Automatic (low power)'' or ''Automatic (precise)''. The automatic modes rotate the map according to the device heading.\\ \\ If the rotation is not switched off and the compass rose is shown on the map, a long tap on the compass rose will also show the options to switch rotation of the map.|
|{{ :downloader_theme.svg?nolink&40 |}}|Select map theme / Theme options|Only shown if the current (offline) map supports themes. Allows to select the map theme and to adjust the options of the selected theme.|
| |Map language|Only shown if the current map provides several languages. Allows to select the language used for the map labels.|
|{{ :ic_menu_recent_history.svg?nolink&40 |}}|History track|Opens a sub menu with the options to show/hide, export and clear the [[livemap#history_track|history track]] (the history of your movement).|
|{{ :ic_menu_route.svg?nolink&40 |}}|[[livemap#route_track_settings|Routes / Tracks]]|Opens the dialog to manage your [[livemap#individual_route|individual route]] and loaded [[livemap#gpx_track_route|GPX/GeoJSON/KML tracks and routes]]: load, hide, center, color, rename, delete, optimize and export them. The long tap function needs to be enabled in [[.:settings#map_behavior|map behavior settings]] to create an individual route.|
|{{ :ic_menu_list.svg?nolink&40 |}}|[[lists#cache_list|Show as list]]|This will display all caches shown on the map as [[lists|cache list]].|

The map source selection button additionally contains the following options below the list of map sources (availability depends on the selected map):

^ Option ^ Description ^
|Map overlays|Overlays (e.g. hiking trails) which can be activated on top of the selected map.|
|Grayscale map|Shows the map in grayscale.|
|Hillshading|Switches the hillshading layer on/off.|
|Background Maps|Shows/hides the background map layer (for offline maps).|
|Manage offline data|Opens the download and management of offline maps and routing data.|
===== Map content =====
{{anchor:map_content:}}

The map will use your selected [[..:mapsources|map type]] and show a live view of all available caches on the displayed location.

The live map always shows a combination of caches loaded live from all your enabled geocaching services as well as caches stored in your [[lists|cache lists]]. 

<WRAP center round tip 100%>
Tap on the following links to get information about the [[..:cacheicons|Geocache Type Icons in c:geo]] and [[..:cachemarkers|Geocache marker icons in c:geo]], which are used throughout c:geo.
</WRAP>


===== Map popup window =====
{{anchor:map_popup_window:}}

If you tap on a cache icon on the live map the following popup windows will be shown above the map, providing additional information for the selected cache:

{{:en:livemap_popup_1.png?direct&400 |}}{{ :en:livemap_popup_2.png?direct&400 |}}

==== Top section ====
{{anchor:top_section:}}

This section of the map popup provides several menu options concerning the selected cache.

^ Icon/Option ^ Description ^
|{{ :en:livemap_popup_3.png?nolink&150 |}}|Showing the [[..:cacheicons|Cache type icon]] and the geocode of the selected cache.\\ \\ Tap on the title allows to set a user defined icon for this cache, which replaces the default cache type icon ([[..:cachedetails#advanced_submenu| Set cache icon]]).|
|{{ :ic_menu_compass.svg?nolink&40 |}}|A short tap on this icon will start your [[settings#navigation|default navigation]] tool to navigate to the selected cache.\\ A long press will start your [[settings#navigation|secondary navigation]] tool.|
|{{ :ic_menu_near_me.svg?nolink&40 |}}|This options turns on/off the direction line/routing between your position and the position of the selected cache.|
|{{ :three_dot_vertical.svg?nolink&40 |}}|This option opens a menu list with additional options also described in this table.|
|Compass|This opens the compass for this cache.|
|Navigate|This opens the list of all available [[settings#navigation|navigation tools]] to start one of them for this cache.|
|Log Visit|This opens the [[..:logging|logging window]] to log the selected cache.|
|Toggle talking|Will start or stop the text-to-speech output of direction and distance towards the target.\\ You can also switch off the display once talking function has been started.|
|Caches around|This option starts a [[lists|nearby search]] around the coordinates of the selected cache and will display the results.|
|Open in browser|This option opens the cache listing on the geocaching web page using your internet browser.|
|Share Cache|Will share a link to the cache using the built-in Android share options.|

==== Cache information ====
{{anchor:cache_information}}

The middle section of the map popup window shows helpful information about the selected cache.
Some of the information might not be shown depending on the loading status of the selected cache (e.g. due to the [[livemap#strategy| loading strategy]]).

{{ :en:livemap_popup_4.png?direct&400 |}}

^ Heading ^ Description ^
|Type|[[..:cacheicons|Type]] of the selected cache.|
|Geo code|Geo code of the selected cache.|
|Distance|Distance to the coordinates of the selected cache from your current position.|
|Difficulty|Difficulty rating of the selected cache shown as decimal value as well as graphical.|
|Terrain|Terrain rating of the selected cache shown as decimal value as well as graphical.|
|Rating|Shows the quality rating of this cache from [[http://gcvote.com|GCVote]] if this service is enabled in the [[settings#services|c:geo settings]] as decimal value as well as graphical.\\ The value shown in parenthesis is the number of votes given for this cache.|
|Favorite|The amount of favorite points (geocaching.com) or recommendations (Opencaching platforms) the selected cache has been awarded. The percentage value is the amount of favorite points divided by the number of total finds.|
|Recent logs|Will visualize the log types of the most recent logs for this cache (newest on the left).|
|More details|This button will take you to the [[..:cachedetails|cache detail page]] of the selected cache providing the full information for this geocache.|
|{{:ic_menu_hint.svg?40|}}|This button is only available if the cache as a owners hint or a personal note stored. Tapping the button will display the hint and/or personal note at the [[#hint_section|bottom]] of the popup window.|

==== List managegment ====
{{anchor:list_management:}}

This section of the map popup provides several options to manage the storage state of the selected cache.

{{ :en:livemap_popup_5.png?direct&400 |}}

^ Icon/Option ^ Description ^
|{{ :en:livemap_popup_6.png?nolink&200 |}}|This field provides information if the selected cache is stored on your [[lists|cache lists]] and for how long the cache is stored (i.e. gives you an indication of how up-to-date the shown details are).|
|{{ :ic_menu_refresh.svg?nolink&40 |}}|Tapping this button will refresh the cache information by updating it from the geocaching server.|
|{{ :en:livemap_popup_7.png?nolink&200 |}}|In case the selected cache is already stored in your [[lists|cache lists]] this field shows you the list(s) it is stored in.|
|{{ :ic_menu_save.svg?nolink&40 |}} |This button is only shown if the selected cache is not yet stored in your [[lists|cache lists]] and will store it.\\ A long press on this icon will store the cache to the last used list, instead of asking for the list.|
|{{ :ic_menu_edit.svg?nolink&40 |}}|If the selected cache is already stored in your [[lists|cache lists]] this icon is shown and allows you to modify the list or add the cache to another list.|
|{{ :ic_menu_delete.svg?nolink&40 |}}|If the selected cache is already stored in your [[lists|cache lists]] this icon is shown and allows you to delete the cache from your lists.|

==== Hint/Note section ====
{{anchor:hint_section:}}

If you tapped the hint button in the cache information section of the popup window, the owners hint and/or your personal note will be shown at the bottom of the popup window. In case of a long text you can scroll this part of the popup window.

{{ :en:livemap_popup_hint.png?direct&400 |}}


===== Map quick settings =====
{{anchor:map_settings}}

After selecting the quick settings button, which is shown on bottom center of the map the following settings screen will be shown:

{{ :en:livemap_mapsettings.png?direct&400 |}}

^ Category ^ Description ^ 
|Show caches|Toggle whether caches are shown on the map depending on their current state.\\ The settings used here will automatically be applied as a live [[..:cachefilter|filter]].|
|Show waypoints|Toggle whether whether waypoints are shown in the map depedning on their type or state.|
|Show other|This section contains options to hide other elements on the map.|
|Use compact icons|With this option you can switch from the classic cache icon view to a compact view showing single caches as a colored dot only. You can set this feature to on/off and automatic mode. The automatic mode will toggle between classic and compact view depending on zoom level.|
|Routing|Here you can select the desired routing mode used to draw the direction line between your position and the chosen target cache/waypoint. Either no line, a straight line or turn-by-turn navigation for pedestrian, bike or car can be used.\\ \\ :!: Turn-by-turn navigation requires an activated and configured [[..brouter|BRouter setup]].|
|Individual route|You can select to automatically set the start point of your individual route as target for the direction line.\\ This item is only shown if an individual route is present on the map.|

===== Route/Track settings =====
{{anchor:route_track_settings}}

All functions to manage routes and tracks on the map are combined in one dialog. Open it using the menu entry ''Routes / Tracks'' in your [[livemap#top_bar_menu|map menu]].

{{ :en:livemap_routetrack_dialog.png?nolink&400 |}}

^ Type ^ Description ^
|Individual route|Contains your [[livemap#individual_route|individual route]]. If none exists yet, only the header with an import button {{ :ic_menu_import.svg?nolink&30 |}} is shown, which allows you to load an individual route from a GPX file.|
|Routes / Tracks|Lists all loaded [[livemap#gpx_track_route|routes and tracks]] (supported file formats: GPX, GeoJSON, KML). The import button {{ :ic_menu_import.svg?nolink&30 |}} in the header lets you select one or more files to load.|

An entry ''Current navigation'' is shown if you set a routing target manually (e.g. by long tapping a cache/waypoint). The button ''Clear routing target'' below it removes this target again.

==== Functions per entry ====
{{anchor:route_track_functions}}

Each entry has its own toolbar. The functions depend on the type of the entry. The most important ones are shown as icons directly in the toolbar, further functions can be found behind the overflow menu button {{ :three_dot_vertical.svg?nolink&30 |}}. Which functions are shown as icon and which are found behind the overflow menu depends on the available space on your device.

=== Individual route ===

{{ :en:livemap_routetrack_individual_toolbar.png?nolink&400 |}}

^ Function ^ Description ^
|{{ :ic_menu_edit.svg?nolink&30 |}} Edit|Opens the [[#sort_individual_route|sort screen]] to reorder or remove the caches/waypoints of the route.|
|{{ :visibility.svg?nolink&30 |}} Hide / Make visible|Hides the route on the map without removing it. The icon changes to make it visible again.|
|{{ :center.svg?nolink&30 |}} Center|Moves/zooms the map so that the complete route is shown.|
|{{ :ic_menu_delete.svg?nolink&30 |}} Delete|Removes all caches/waypoints from the individual route after confirmation (''Clear individual route'').|
|Show elevation chart|Closes the dialog and shows an elevation chart for the route (only if elevation data is available).|
|Optimize|Opens the [[#optimize_route|route optimization]].|
|Invert order|Reverses the sequence of the route.|
|Refresh|Updates all caches contained in the route (including the caches of contained waypoints) from the geocaching servers.|
|Export as route|Exports the individual route into a GPX route file.|
|Export as track|Exports the individual route into a GPX track file.|
|Load from GPX|Loads an individual route from a GPX file. If a route already exists you will be asked whether it should be overwritten.|

=== Track / route (loaded from file) ===

{{ :en:livemap_routetrack_track_toolbar.png?nolink&400 |}}

^ Function ^ Description ^
|Color {{ :downloader_theme.svg?nolink&30 |}}|Shows the currently used color. Tapping it opens a dialog to select the line color and line width for this track.|
|{{ :visibility.svg?nolink&30 |}} Hide / Make visible|Hides the track on the map without removing it. The icon changes to make it visible again.|
|{{ :center.svg?nolink&30 |}} Center|Moves/zooms the map so that the complete track is shown.|
|{{ :ic_menu_delete.svg?nolink&30 |}} Delete|Unloads the track from the map after confirmation (''Clear route/track'').|
|Show elevation chart|Closes the dialog and shows an elevation chart for the track (only if elevation data is available).|
|Rename|Opens the dialog ''Change name'' to change the name shown in the list.|

=== Current navigation ===

This entry is your manually set target.

^ Function ^ Description ^
|{{ :center.svg?nolink&30 |}} Center|Moves/zooms the map so that the complete line to the target is shown.|
|{{ :ic_menu_clear_target.svg?nolink&30 |}} Clear routing target|Removes the target.|
===== Map navigation =====
{{anchor:map_navigation}}

c:geo provides several options to help you with navigation using different lines drawn on the (live) map: 

  * It can show a **direction line** between your position and a chosen target cache/waypoint.
  * You can load an **GPX track/route**, which will then be shown on the map.
  * You can set an **individual route** between several caches/waypoints. 
  * c:geo can optionally draw a **history track** showing the position history (your movement) on the map.

To get the most out of the direction line and individual route it is recommended to use [[..:brouter|BRouter]] as described in the linked section of our user guide. This will enable routed lines instead of just a straight connection line.

The different line and track types are described in more detail below.

==== Direction line ====

The direction line is a map line which connects your current position with a chosen target cache/waypoint. This can be either a straight line or a routed line if you have configured [[..:brouter|BRouter]].

The default line color is <color #ed1c24>red</color> but line color and additional appearance parameters can be configured according to your needs within the [[.:settings#map_lines_customization|map line customization]] settings.

The example below shows the typical appearance of the direction line (with and without Brouter).

^ Direction line without BRouter ^ Direction line with BRouter ^
|{{:en:brouter_without.png?direct&250|}}|{{:en:brouter_with.png?direct&250|}}|

There are two ways to activate the direction line:
  - Tap on a cache, which is shown on map, and activate the direction line with the corresponding icon{{:ic_menu_near_me.svg?nolink&30|}}shown in the [[livemap#map_popup_window|map popup]].
  - From [[..:cachedetails|cache details menu]] use Navigation - Map to open the map including direction line.
==== GPX track/route ====
{{anchor:gpx_track_route}}

You have the possibility to load route and track files which are then shown on the map. For example cache owners might provide a GPX-track/route file to follow a certain route to find a cache, or you can generate such files with other routing tools. Supported formats are GPX, GeoJSON and KML.
Tracks and routes both are basically GPX files, one having a recorded track of positions (track file), the other (route file) only some waymarks, for which c:geo will route you from point to point.

You can load several tracks/routes at the same time. Each of them is listed in the [[#route_track_settings|Routes / tracks options dialog]], where you can rename, hide, center, delete or color it individually.

The default line color is <color #22b14c>green</color> but the line color and line width can be configured per track in the dialog (color icon) and the defaults according to your needs within the [[.:settings#map_lines_customization|map line customization]] settings.

The example below shows the typical appearance of a track/route.

{{ :en:livemap_individual_track.png?direct&250 |}}

To load a track/route open the ''Routes / tracks options'' dialog from your [[livemap#top_bar_menu|map menu]] and tap the import button {{ :ic_menu_import.svg?nolink&30 |}} in the section ''Routes / Tracks''. You can select several files at once.
==== Individual route ====
{{anchor:individual_route}}

An individual route can be created by long tapping several caches/waypoints on the (live) map. A route will then be drawn between each of the selected caches/waypoints in sequence of your selection. This allows you to create a custom route between caches and can be e.g. used to plan your caching trip.

<WRAP center round important 60%>
To make use of the individual route feature you need to enable the long tap function on the map in your [[.:settings#map_behavior|map behavior settings]].
</WRAP>


The route points will either be connected by a straight line or a routed line if you have [[..:brouter|BRouter]] installed and configured. Using BRouter for this function is highly recommended to get the most out of it.

The default line color is <color #00a2e8>blue</color> but the line color and additional parameters can be configured according to your needs within the [[.:settings#map_lines_customization|map line customization]] settings.

The example below shows the typical appearance of an individual route.

{{ :en:brouter_individualroute.png?direct&250 |}}

While you can add and remove caches/waypoints to/from your route by long tapping them, all further functions are available in the entry ''Individual route'' of the [[#route_track_settings|Routes / tracks options dialog]] (see [[#route_track_functions|functions per entry]] for the toolbar functions such as hide, center, delete, refresh, invert order and export):

{{ :en:livemap_routetrack_dialog.png?nolink&400 |}}

^ Option ^ Description ^
|Load individual route (import button in header)|Load a previously exported individual route from a GPX file. The button is shown in the header as long as no individual route exists; afterwards use ''Load from GPX'' in the overflow menu of the route entry.|
|Set route start as target|If activated the routing start point will be set as direction line target automatically (showing the way from your position to the starting point of the route).\\ This can be handy while doing a geocaching tour. Long-tap on a visited cache/waypoint will remove it from your individual route, and with this option activated, your next stop on your route will be set as target automatically.\\ The option is also available in the [[#map_settings|map quick settings]].|
|Clear routing target|Removes the manually set target and switches off ''Set route start as target''. Only shown if a target is set.|

=== Sort individual route ===
{{anchor:sort_individual_route}}

The edit icon of the individual route opens a screen, where you can modify the sequence or remove one or more of the selected caches/waypoints on your route; The route will then be recalculated accordingly.\\ Don't forget to hit the "save" button to save your changes to the individual route, or just leave the screen to discard them.\\ Long tap on the title or detail allows you to move the cache/waypoint and its successors to the top of the route.

=== Optimize route ===
{{anchor:optimize_route}}

The function ''Optimize'' in the overflow menu of the individual route tries to find a shorter sequence of the caches/waypoints on your route. You can choose how the route should be optimized in the dialog shown; the optimized route replaces your current individual route.
==== History track ====
{{anchor:history_track}}

The history track provides a line of your position history (your movement) on the map.
You have to activate the history track in your [[.:settings#map_content|map content settings]], where you can also configure additional parameters (such as maximum length of the track).

The default line color is black but the line color and additional appearance parameters can be configured according to your needs within the [[.:settings#map_lines_customization|map line customization]] settings. 

The example below shows the typical appearance of a history track line. 

{{ :en:livemap_history_track.png?direct&250 |}}

To configure the history track you can use the map menu items below ''History track'' in your [[livemap#top_bar_menu|map menu]]:

{{ :en:livemap_history_track_2.png?nolink&400 |}}

^Menu item ^ Description ^ 
|Export history track|Allows you to export your position history to a GPX track file.|
|Hide/Show history track|Using this option you can turn the history track off/on. Turning it off will not clear the existing track but just stop recording and hide it.|
|Clear history track|This will clear the position history and thus remove the existing track.|
==== Distance information ====

While using the direction line and/or individual route c:geo will also provide several distance figures at the top of the map (can also be seen in the dedicated screenshots above). The distances are shown in meter/kilometer or feet/mile depending on your settings.

Depending on whether you use one or both lines and whether you activated to show the straight distance in addition to the routed distance (only if [[..:brouter|Brouter]] is installed) in your [[.:settings#map_content|map content settings]] several distance figures might be shown.

The picture below shows a combination of all possible distance figures. Additionally the chosen target cache/waypoint is shown on top left is the direction line is active.

{{ :en:livemap_distance_info_1.png?direct&400 |}}

Some or all of these distance figures might be shown depending on configuration and active navigation lines:

  - The first figure is the straight line distance for the direction line (i.e. straight distance between your current position and the chosen target cache/waypoint). The icon in front represents therefore the straight line if both routed and straight line distances are shown.
  - The second figure is the routed line distance for the direction line (i.e. the distance between your position and the chosen target cache/waypoint according to the [[..:brouter|BRouter]] routing information). The icon in front represents therefore the routed line if both routed and straight line distances are shown.
  - The third figure is the length of your individual route.

For better visibility you can tap on the distances to supersize them and reduce them again. If straight and routed distances are shown each tap will let you cycle between straight distance enlarged, routed distance enlarged or normal view.

{{:en:livemap_distance_info_2.png?direct&400 |}} {{:en:livemap_distance_info_3.png?direct&400 |}}