{{ :manual:user_guide:ic_gc_download_pq_alt.png?nolink|}}====== Import of Geocaches ======

----
Before the geocache hunt starts it is necessary to get the geocaches into Locus Map. There are several ways how to do it and some of them need help from external add-ons:
===== Search and download =====
<wrap info>**Available only with [[manual:user_guide:premium|Locus Map Premium]]**</wrap>

The simplest way how to get geocaches into the app. For a quick overview, check the video tutorial:\\ {{youtube>JFqlBZn60gs?full}}\\ 

Detailed instructions:
  * go to the main menu > All features > Geocaching > Geocaching tools > **Search for geocaches** (the first search triggers logging in to the [[https://Geocaching.com|Geocaching.com]] website and permission to share its data with Locus Map):\\ {{ :manual:user_guide:geocaching:geocaching22.jpg?nolink |}}
  * 1) select the **location** around which to search the geocaches - the screen center is the default. If you want another, tap the **[[manual:user_guide:tools:location|location selector]]** button.
  * 2) set the **number of geocaches** from 10 to 500
  * 3) optionally set the geocache **filter** (available only to GC Premium members):\\ {{ :manual:user_guide:geocaching:geocaching23.jpg?nolink |}}
  * 4) tap **SEARCH**
==== Filters ====
You can edit the current filter, the GC Live map filter and also add a new filter for various use cases:\\ {{ :manual:user_guide:geocaching:geocaching35.jpg?nolink |}}
<WRAP round important>**Basic members of Geocaching.com** are limited to downloading only traditional and event caches with short descriptions.</WRAP>
===== Search by GC code =====
<wrap info>**Available only with [[manual:user_guide:premium|Locus Map Premium]]**</wrap>\\ 
Each geocache has a unique code. You can find the geocache by it - just fill it in the code field and tap **SEARCH**. The geocache is displayed on the map.\\ {{ :manual:user_guide:geocaching:geocaching34.jpg?nolink |}}
===== GC Live map =====
<wrap info>**Available only with [[manual:user_guide:premium|Locus Map Premium]]**</wrap>\\ 
The quickest way how to display geocaches on the map - with a streamed layer:\\ {{ :manual:user_guide:content_panel30.gif?nolink |}}
More at the **[[manual:user_guide:mainscr_lpanel#gc_live_map|content panel >>]]**
===== My lists and Pocket Queries =====
<wrap info>**Available only with [[manual:user_guide:premium|Locus Map Premium]] and to [[https://payments.geocaching.com/?upgrade=true|Geocaching.com Premium]] members**</wrap>

  * go to the main menu > All features > Geocaching > Geocaching tools > **My lists & PQ**
==== My lists ====
Create **[[https://www.geocaching.com/plan/lists|Lists of geocaches]]** at [[https://Geocaching.com|Geocaching.com]] to organize your geocaching outings and goals. 

This way you can download geocaches from the lists into the app:\\ {{ :manual:user_guide:geocaching:geocaching24.jpg?nolink |}}
==== Pocket Query ====

...also known as **PQ** or just **query**, is a GPX file with geocaches that was rendered at [[https://Geocaching.com|Geocaching.com]] according to instructions from the user. For example, it is possible to define all geocaches with difficulty grade 3 within a circle of a certain radius around given GPS coordinates.
=== How to make Pocket Queries ===

{{youtube>JdUToGF1Kkc?full}}\\ 

<WRAP round info >
  * Pocket Query can contain <1000 geocaches only.
  * Locus Map can also handle .zip files - check this to reduce the query file size.
</WRAP>

This way you can download geocaches from the Pocket Query into the app:\\ {{ :manual:user_guide:geocaching:geocaching25.jpg?nolink |}}


{{:manual:user_guide:ic_launcher_addon_gc4locus.png?nolink&64 |}}===== Geocaching4Locus Add-on =====


Another option that adds more **geocache downloading functions** into Locus Map, created by a partner developer.
==== Setup ====

  * **Download and install** it from [[https://play.google.com/store/apps/details?id=com.arcao.geocaching4locus|Google Play Store]]
  * **Start Geocaching4Locus** - Menu > All features > Geocaching > Geocaching4Locus\\ {{ :manual:user_guide:geocaching:g4l01.jpg?nolink |}}
  * Geocaching4Locus menu appears, select **Settings > Account > Sign in**
  * **Enter your Geocaching.com username and password and confirm**
  * Authorize Geocaching4Locus by tapping **Allow access**
  * Make sure that **Locus settings > Miscellaneous > Connect with add-ons** is turned ON:\\ {{ :manual:user_guide:geocaching:g4l03.jpg?nolink |}}

After installation and setup the following options appear across Locus Map:

==== Nearest caches ====
The option to find the nearest geocaches around a selected location can be found in several places:
  * Menu > All features > Geocaching > Nearest caches\\ {{ :manual:user_guide:geocaching:g4l04.jpg?nolink |}}\\ Set coords or tap **GPS** to get your location 
  * Tap any point ([[manual:user_guide:points|user point]] or [[manual:user_guide:points:locus_maps_pois|LoPoint]]) on map > detail screen > bottom panel > {{:manual:user_guide:ic_addons_alt.png?nolink&30|}} add-on button > nearest caches\\ {{ :manual:user_guide:geocaching:g4l05.jpg?nolink |}}\\ This searches for **geocaches nearby the point**.
  * Long-tap any place on map > address detail screen > bottom panel > {{:manual:user_guide:ic_addons_alt.png?nolink&30|}} add-on button > nearest caches - searches for **geocaches around the the selected place on the map** (the [[manual:user_guide:settings:control#tap_and_hold_to_display_address|on-screen address search]] must be enabled):\\ {{ :manual:user_guide:geocaching:g4l06.jpg?nolink |}}
  * in **Geocaching4Locus menu**:\\ {{ :manual:user_guide:geocaching:g4l02.jpg?nolink |}}

What to do next:
  * set **number of geocaches** to download and **filter** of caches (optional)\\ {{ :manual:user_guide:geocaching:g4l07.jpg?nolink |}}
  * Tap the download button
  * Select a **folder** for your caches, check **Show on the map after import** and tap **Import**. You may need to **empty the import folder** before downloading caches to save place in your device memory so check the option. Locus Map Premium users may also let Locus **update the elevation** of the imported caches.
  * Geocaches appear on the map.
<WRAP round important>**Basic members of Geocaching.com** are limited to downloading only traditional and event caches with lite descriptions.</WRAP>
==== Live map ====

{{ :manual:user_guide:geocaching:geocaching20.jpg?nolink |}}

With this feature, the geocaches appear above the map in real-time without import - you have to be **online**.

<WRAP round important>
  * Make sure you have **[[manual:user_guide:settings:misc#connect_with_add-ons|Connect with add-ons]]** setting ON.
  * **Geocaching.com Basic** members see traditional and event caches only.
</WRAP>
==== Import GC ====

Each geocache has its own unique GC code. Use this feature to import a particular geocache by its GC code.\\ {{ :manual:user_guide:geocaching:geocaching21.jpg?nolink |}}

<WRAP round info>For more information check [[http://geocaching4locus.eu/manual/|manual of Geocaching4Locus]].</WRAP>

{{:manual:user_guide:ic_gc_download_pq_alt.png?nolink |}}


===== Other third-party add-ons =====
==== GSAK for Locus ====
GSAK is a geocache management program where you can edit the final waypoints, add notes or other auxiliary points, or import/export geocaches.

This add-on provides a link between GSAK where the geocaches are stored and Locus Map. With this add-on, you can view all geocaches, you have stored in GSAK, display their listing, and more. And all this offline without an internet connection.

<WRAP center round download>
**[[https://play.google.com/store/apps/details?id=ch.bubendorf.locusaddon.gsakdatabase|More information and download >>]]**
</WRAP>

==== GeoGet4Locus ====

The add-on allows you to import caches from db3 files from GeoGet for further work in the Locus Map application. If you use one file, the application will start loading the cache immediately. In the case of multiple files in a folder, the add-on will first offer the option of which file to import.

<WRAP center round download>
**[[https://play.google.com/store/apps/details?id=cz.geoget.locusaddon|More information and download >>]]**
</WRAP>
===== Cooperating apps =====

==== C:GEO ====
C:geo is an open source, full-featured, always ready-to-go unofficial client for geocaching.com and offers basic support for other geocaching platforms (such as Opencaching).

<WRAP center round download>
**[[https://play.google.com/store/apps/details?id=cgeo.geocaching|More information and download >>]]**
</WRAP>