{{ :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 [[manual:user_guide:geocaching:import#search_and_download|processed by the app]], by **[[manual:user_guide:geocaching:import#geocaching4locus_add-on|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|Library]]** 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. Tap {{:manual:user_guide:ic_progress_rotate.png?nolink&20|}} to refresh the rating.
* **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 and the **option to display the WPT on the map**.
==== Logs ====
You can maximize logs into a dialog with a **list of logs** divided into two categories - **All** and **From friends**.\\ {{ :manual:user_guide:geocaching:geocaching36.jpg?nolink |}} To update the logs, tap {{:manual:user_guide:ic_progress_rotate.png?nolink&20|}}:\\ {{ :manual:user_guide:geocaching:geocaching37.jpg?nolink |}}
==== Trackables ====
When you see there are trackables in a cache,\\ {{ :manual:user_guide:geocaching:geocaching38.jpg?nolink |}}tap to see the name\\ {{ :manual:user_guide:geocaching:geocaching39.jpg?nolink |}}and detail:\\ {{ :manual:user_guide:geocaching:geocaching40.jpg?nolink |}}. Tap LOG to open the logging form and log the trackable directly:\\ {{ :manual:user_guide:geocaching:geocaching41.jpg?nolink |}}
==== Waypoints ====
The box indicates the **number of waypoints** for the cache (displayed/available):\\ {{ :manual:user_guide:geocaching:geocaching42.jpg?nolink |}}
Tap the arrow to open the **waypoints list**:\\ {{ :manual:user_guide:geocaching:geocaching43.jpg?nolink |}}
- tapping opens the **waypoint detail** panel
- **show-all-on-map** button
- single waypoint **displaying** buttons
- tap to open the **add waypoint** menu:\\ {{ :manual:user_guide:geocaching:geocaching44.jpg?nolink |}}
The new waypoint can be added in a few ways:
* **general** - adding a new WP without any relations to the cache or other WPTs
* **clipboard** - adds a WPT with coordinates copied into the phone's clipboard
* **projection** - from the cache and from adjoining WPTs. The WPT is created based on defined distance and azimuth:\\ {{ :manual:user_guide:geocaching:geocaching45.jpg?nolink |}}
----
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. Listing is visible only to Geocaching Premium members
* **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 Library with the cache. Tapping opens the folder detail.
* **Downloaded** - date of the cache download to Locus
* ** Last updated** - date of the last info update within the app
* **Coordinates** - geocache lat/lon coords. Long-press copies them into the clipboard.
===== 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 menus:
==== Geocache 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 the 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.
* **Update geocache** - reloads fresh data about the geocache from Geocaching.com.
* **GC Offlinizer** - downloads the geocache's associated images, spoilers, etc. for later offline use. Available only with **[[https://www.locusmap.app/premium|Premium]]**\\ [[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
* **Images** - this item only emerges when the geocache listing contains **images**, and/or there are **spoilers** available. When images are downloaded with the **GC offlinizer**, the images are also available offline.
==== Add-on menu ====
This menu is only available when [[..:add-ons#add-ons_from_other_developers|geocaching add-ons]] are installed:\\ {{ :manual:user_guide:geocaching:geocaching9.jpg?nolink |}}
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 >>]]**
===== 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 isn't listed 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 with 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 Library folder with geocaches looks and offers the same controls as an ordinary **[[manual:user_guide:my_library#structure_of_folders|point folder]]**, except a few more options:
==== Sorting ====
Contains a **wide choice of geocache parameters** to **[[manual:user_guide:my_library#sorting|sort by]]**:\\ {{ :manual:user_guide:mylib18.jpg }}
==== Filtering ====
On the **basic level**, you can filter geocaches by name, GC code, date, and distance, see **[[manual:user_guide:my_library#filtering|point filtering >>]]**.
**Special filtering** offers setting of the type, difficulty, terrain, and a lot of other parameters and attributes:\\ {{ :manual:user_guide:mylib22.jpg |}}\\ {{ :manual:user_guide:geocaching:geocaching17.jpg?nolink |}}\\ You can display the filtered results on the map from the topbar menu. There you can also save filters for future use in the **filter manager**:\\ {{ :manual:user_guide:mylib26.jpg |}}
==== Tools ====
Available only with **[[https://www.locusmap.app/premium|Premium]]**
The tool menu emerges when you turn the folder into the **[[manual:user_guide:my_library#select|select]]** mode.
{{ :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 geocaches** - updates downloaded caches' listings, logs, etc.
* **GC Offlinizer** - downloads geocaches' associated images, spoilers, etc. for later offline use. **[[manual:user_guide:geocaching:tools#geocaching_offlinizer|More on how to use GC Offlinizer >>]]**
* **Load GCVote** - downloads geocache rating