{{ :manual:user_guide:ic_launcher_addon_gc4locus.png?64|}}====== Geocaching in Locus Map ======

----
===== About =====

  * **Locus Map** handles geocaches as a category of **[[manual:user_guide:points:about|points]]** - each has its name, coordinates, description plus further specific parameters like cache code, difficulty, terrain, size etc.\\ {{ :manual:user_guide:geocaching:geocaching.jpg?nolink |}}
  * Geocaches can use all the features related to points - you can **[[manual:user_guide:points:management|manage]]** them (store them in folders, sort them, filter, copy...), you can **[[manual:user_guide:points:management#tools|share]]** them, you can **[[manual:user_guide:functions:navigation:point-to-point|navigate]]** to them, **[[manual:user_guide:functions:guidance#guidance_to_a_point|guide]]** to them on the map or by the compass, or include them in your **[[manual:user_guide:tracks:planning#add_your_own_points|planned routes]]**
  * Then there is a wide range of **[[manual:user_guide:geocaching:tools|tools and functions]]** for geocachers and makes hunting for geocaches easier and more fun.

===== Import =====

  * Before you can display the geocaches on the map you have to **[[manual:user_guide:points:import|import]]** them to the app. The import is processed by the app, by **[[manual:user_guide:add-ons|Locus add-ons]]** or cooperating applications. See more details in **[[manual:user_guide:geocaching:import|Import of Geocaches >>]]**.
===== Geocache detail panel =====
The imported geocaches are stored in a selected folder of the **[[manual:user_guide:points:management|point manager]]** or **displayed on the map**. After tapping a geocache in both a panel with its detailed info slides up.\\ {{ :manual:user_guide:geocaching:geocaching2.jpg?nolink |}}
The panel is similar to that of a common point but there is quite a lot of additional information and tool buttons:
  * **Difficulty**- 5-star scale of difficulty to find the geocache
  * **Terrain** - 5-star scale of terrain difficulty
  * **Quality/GCVote** - user rating of the geocache
  * **Logs** - icons of the last five geocache logs - the category can be maximized to a detached box with details
  * **Favorites** - number of users who marked the geocache as their favorite
  * **Size** - a 5-grade scale of the geocache box size
  * **Trackables** - number of trackables dropped here (displayed only to Premium members, others see TR 0) - the category can be maximized to a detached box with details
  * **Waypoints** - number of waypoints connected to the geocache - the category can be maximized to a detached box with details

When you scroll the panel up, more information appears:\\ {{ :manual:user_guide:geocaching:geocaching3.jpg?nolink |}}
  * **Attributes** - various preferences of the geocache according to **[[https://www.geocaching.com/about/icons.aspx|Geocaching.com]].**
  * **Listing** - an excerpt of the geocache listing that can be displayed as a whole. <wrap info>Listing is visible only to Geocaching Premium members</wrap>
  * **Code** - a unique GC code of the geocache. Tapping it displays a couple possible actions:\\ {{ :manual:user_guide:geocaching:geocaching5.jpg?nolink |}}
  * **Type** - type according to GC categories - traditional, multi, mystery...

Another scroll up...\\ {{ :manual:user_guide:geocaching:geocaching4.jpg?nolink |}}
  * **Hidden** - the date when the cache was installed
  * **Updated** - the date of the last cache web update
  * **Owner** - the name of the cache owner - by tapping it you can display the profile or send a message:\\ {{ :manual:user_guide:geocaching:geocaching6.jpg?nolink |}}
  * **Country** - the state or local region of origin
  * **Folder** - selected folder of the point manager with the cache. Tapping opens the folder detail.
  * **Downloaded** - date of the cache download to Locus
  * **Las updated** - date of the last info update within the app
  * **Coordinates** - geocache lat/lon coords. Long-press copies them into clipboard.

==== Context menu ====
{{ :manual:user_guide:geocaching:geocaching7.jpg?nolink |}}
  * **Hint** - decrypted hint with tools:\\ {{ :manual:user_guide:geocaching:geocaching8.jpg?nolink |}}\\ You can encrypt/decrypt the hint, copy it to clipboard or let it translate by any installed translating app/service
  * **Log visit** - opens the logging menu (details below)
  * **Log trackable** - opens tracking code insert dialog
  * **Notes** - opens the notes dialog - to add notes, load them from the web, etc.
  * **GC Offlinizer** - downloads the geocache's associated images, spoilers etc. for later offline use. <wrap info>Available only with **[[https://www.locusmap.app/premium|Premium]]**</wrap>\\ [[manual:user_guide:geocaching:tools#geocaching_offlinizer|More info >>]]
  * **Load all waypoints** - appears only when the cache contains waypoints - it displays them all on the map
  * **Computed** - marks a mystery or multi-cache as computed
==== Tools ====
The bottom bar of the geocache detail panel contains tools common for all other points - navigation, sharing, info editing and management tools. But also geocache-specific add-on menu:\\ {{ :manual:user_guide:geocaching:geocaching9.jpg?nolink |}}
<WRAP center round tip>
Three buttons on the toolbar are configurable as **Quick buttons**. You can place Hint, Log your visit, Notes and Context menu buttons there. See **[[manual:user_guide:geocaching:settings#point_screen|geocaching settings >>]]**
</WRAP>

===== Logging =====
Geocaches can be logged in online or offline. You can trigger both from the geocache context menu:\\ {{ :manual:user_guide:geocaching:geocaching10.jpg?nolink |}}
==== Online ====
There are two possibilities:
  * **Log your visit** - logs your find directly at the Geocaching.com website
  * **Upload draft** - you fill in the logging form but the log doesn't list among your finds. It is still available for editing.

==== Offline ====
  * **Log visit offline** - logs your find within the app for a future upload on the Geocaching web

==== Log screen ====
All the options above use a unified logging screen:\\ {{ :manual:user_guide:geocaching:geocaching11.jpg?nolink |}}
Here you define the type of the log:\\ {{ :manual:user_guide:geocaching:geocaching12.jpg?nolink |}}
Then you can add a **comment**, define the log **time and date** (it is pre-filled by the actual date), add **images** and log **trackables** (only when logging online)

If you tap **SAVE** on the "Log online" or "Upload draft", the log is stored **offline** on the device for later use. All offline logs are listed in the **[[manual:user_guide:geocaching:tools#geocaching_tools1|Logs manager]]** accessible from the app main menu > All features > Geocaching tools.
===== Managing geocaches =====
Geocaches are managed the same way as other **[[manual:user_guide:points:management|user points]]** with a few specifics.
==== Folders ====

A folder with geocaches looks and offers the same controls as an ordinary [[manual:user_guide:points:management#points_folder|point folder]] except a few more options:
==== Sorting ====
Contains a wide choice of geocache parameters to sort by:\\ {{ :manual:user_guide:geocaching:geocaching13.jpg?nolink |}}\\ {{ :manual:user_guide:geocaching:geocaching14.jpg?nolink |}}\\ 
==== Filtering ====

**Basic GC filtering** - you can filter geocaches by name, GC code, icon (type), date and distance:\\ {{ :manual:user_guide:geocaching:geocaching15.jpg?nolink |}}\\ **Special filtering** offers setting of difficulty, terrain and a lot other parameters and attributes:\\ {{ :manual:user_guide:geocaching:geocaching16.jpg?nolink |}}\\ {{ :manual:user_guide:geocaching:geocaching17.jpg?nolink |}}\\ You can display the filtered results on map from the topbar menu. There you can also save filters for the future use in the **filter manager**:\\ {{ :manual:user_guide:geocaching:geocaching18.jpg?nolink |}}
==== Tools ====
{{ :manual:user_guide:geocaching:geocaching19.jpg?nolink |}}
Besides common functions like //Copy/Move/Export/Delete// or //Update elevation// the menu contains several GC-specific features:
  * **Update caches** - updates downloaded caches listings, logs etc. The button is present only if the [[manual:user_guide:geocaching:import#geocaching4locus_add-on|Geocaching4Locus addon]] is installed.
  * **Change icons** - you can change icons of multiple caches by this batch task
  * **GC Offlinizer** - downloads geocaches' associated images, spoilers etc. for later offline use. <wrap info>Available only with **[[https://www.locusmap.app/premium|Premium]]**</wrap>[[manual:user_guide:geocaching:tools#geocaching_offlinizer|How to use GC Offlinizer >>]]
  * **Load GCVote** - downloads geocache rating