Cache Hound User Guide
CacheHound is an android application for all geocachers, with the forward intention of assisting in providing a paperless geocaching experience.
The primary features are as follows:
To get the most functionality out of the application, the android device should have a data connection available (3g/wireless) and GPS switched on. However, CacheHound has been designed to be able to function without these, given the following limitations.
The application settings are available via the option menu on both the Waypoints and Map tabbed panes
The default setting is to use kilometres and metres. Checking the box will display distances in miles and feet.
When ticked, the direction to the waypoint on the list screen is shown as N, NE, E etc. Otherwise it is shown as an arrow (left/right/up/down only)
When selected, the (user-defined) name of the active filter is shown at the top of the waypoint list.
The waypoint location can be displayed and modified throughout the application in 3 different formats according to need. The default is DDD MM.MMM, e.g. N50° 55.345’
You can turn off active location detection to reduce battery consumption by deselecting this option
When importing waypoints from a gpx file, the directory specified here will be parsed for all compatible files. The default is /sdcard/download.
Entering your geocaching user name here will allow the application to determine any caches that are owned by you during the gpx import process. If there are logs attached to a cache then these are also checked to see whather you have previously found or DNF’d.
This is the main screen of the application, and shows the waypoints or geocaches currently loaded into the application according to the selected filter. Selecting a specific waypoint in the list will take you to the Cache Details Page
On pressing the menu key, the following options are available.
Option will take you to the nearest cache page at geocaching.com, and will use the last known location as the search centre. You are able to set a particular cache as the current location (see below).
Toggle switch to change whether or not to receive location updates. It may be a good idea to have this switched off when there is no 3g signal and you have manually set the current location.
Allows you to edit the parameters of the currently active filter. The changes are persistent and will remain after exiting the application. See Edit Filter
There are 6 different filters that may be selected from, all of which are completely configurable. There are 3 ‘standard’ filters, which are:
By default they all have a distance filter as well, but this may be edited to suit needs.
After gpx files have been imported, the newly loaded caches are highlighted with a yellow star on their icons. This option removes the yellow star.
Shows a list of all caches that have been newly logged by the user, ordered by the date/time they were entered. This will not show logs that were made directly on the geocaching website.
Will attempt to load all gpx, loc and compatible zip files in the current sync. directory. This will try and identify where cache data is older or newer than might already be in the database, and update, insert or ignore the details accordingly.
Deletes all cache data in the database.
update settings as per Settings
The Edit Filter screen is where you can customise any of the 6 compound filters that are provided. The filter being edited is the one that is currently active. You will need to choose a filter first before editing it.
This can be modified as required to provide an appropriate description of the filter options.
Putting a value in here will limit the caches displayed to those within the specified distance of the current location, using the current distance units. E.g. a value of 5 will be either 5 miles or 5 kilometres. If location detection is off, the distance will be measured from the last known location, or from the waypoint chosen as the new centre point.
Choose between name and distance. There are situations where the current location is not available, which may result in an indeterminate distance order.
By tapping on the cache state header, a drop down list is shown with 4 states, Available, Unavailable, Archived, or Favourite. Each state has 3 options, on tapping the associated button. For description of the options see below.
By tapping on the Cache Type header, a drop down list is shown with a number of cache types, e.g. traditional, multi-cache etc. Each type has 3 options, on tapping the associated button. For description of the options see below.
By tapping on the Container Size header, a drop down list shows container sizes, e.g. Micro, Regular, Large etc. Each size has 3 options, on tapping the associated button. For description of the options see below.
By tapping on the Found State header, a drop down list shows found states, i.e. Unfound, Found, Did Not Find and Mine. Each size has 3 options, on tapping the associated button. For description of the options see below.
For each of the filter state above, the options are to Include, Exclude, or Ignore. The explanation of each option is thus:
For the cache state, the settings may be as follows
Unavailable and Archived only
Note that for there is no option to select non-cache types at the moment, e.g. Parking Areas, Reference Points etc. These can be included in the filter results by using Ignores and Excludes. For example, if every cache type was set to Ignore, then you will see all waypoint types. If every cache type was set to Exclude, then the list will only include non-cache waypoints.
When a long key press on a waypoint in the filtered list is made, the following options are available.
Taking this option will take you to the Navigate Screen
This will make the application think you are at the coordinates of the selected waypoint. Note that if you are still receiving location alerts then the centre point will change as soon as a new location is made available. If the current filter is distance based, then the list will be resorted with the specified waypoint at the top. This is very useful if you have location detection switched off, as it will enable you to determine the next closest waypoints.
You may classify any cache as a favourite, by selecting this option.
This option currently gives you the ability to edit the waypoint name, and the latitude and longitude only. You could use this to set the final coordinates for a multi-cache or puzzle (or you can add a child waypoint).
Tags are a means to set various characteristics about the waypoint.
The cache/waypoint can be marked as one of these states as needed to avoid needs to delete or reload the data.
The cache or waypoint may be toggled between these values as necessary without needing to create a ‘proper’ log. Found etc. may also be applied to non-cache waypoints.
This tag is set when a cache when a cache is loaded from a gpx file, and is removed before a new gpx file is loaded. You can manually set/unset the tag for an individual waypoint here.
Any cache may be tagged as a favourite, and can then be filtered on. The resulting set of caches can then be marked as favourites on the geocaching website.
Marking a waypoint as Locked should prevent it from being deleted or modified. This is currently not functioning.
Delete the waypoint and all associated information from the database, including logs and notes etc.
The trackable pane will initially display all geocoins and travel bugs that are logged into each geocache in the loaded gpx files. The list displays the trackable code, its name, and the name of the cache where it is currently located.
Where a TB is shown in bold it indicates it is in the possession of the user, and is not in any cache. Any such inventory trackable may be included in a ‘drop off’ log as part of a normal cache log. The tracking code is displayed where this has been captured by the user, for example during pick up, grab, or discovered logs.
This option will bring up a dialog window allowing you to enter either the Trackable reference number, or its tracking code to check on the details of a particular trackable.
The option allows you to enter details of a trackable that does not exist in the cachehound database. You can enter its Reference , Tracking Code, and name, all fields being optional, although it makes no sense to have to not have the Tracking code as a minimum, which may be the only information you know about a trackable in the field. Any new trackable entered will appear as if it is in your trackable repository. See the section on logging for an example of how to log picking up a trackable from a place you did not expect it.
This shows a list of all logs related to trackables that currently exist in the database (Retrieve,Drop Off, Visit, Grab, Note). Where the log is related to a cache, the subject cache will be displayed in the list.
by selecting a specific trackable in the trackable list the following options are available:
provides a direct link to the trackable web page.
Takes the user to the compass page for the cache containing the trackable.
Takes the user to the Cache Details page
Allows the user to make trackable logs not related to caches.
The user can change any of the trackable details as necessary, e.g. change name after an online lookup to discover what it is from the tracking code.
Any Trackable may be deleted from the database as necessary.
This page shows all of the waypoints as selected by the active filter on a map. Unless there is an active data connection there may be no background images. It should be noted that for map purposes any distances specified by the filter are effectively ignored, so you will still see a waypoint if you scroll the map to 50 miles away, even if your active filter has a 20 mile limit on the list pane. The waypoints are dynamically loaded as you scroll and pan around the map. Note that if you pan out a long way it might take a long time to load the data, especially if you have a large number.
If you are navigating to a specified cache, this cache will be highlighted. If there is any location data being received then there will be a line drawn on the map from your current location to the target location.
If you have moved the current map window such that your current position is not shown choosing this option will centre the map at your current location.
If the waypoint that you are navigating towards is currently off-screen, choosing this option will centre the map at your target location.
Switching this on or off is as per the list pane option. When notification is off the map will not constantly centre itself to your current location.
This option is as per the List pane, allowing you to configure which waypoints are displayed for the active filter.
Option as per List pane, where you can choose from any of the 6 filters you may have defined.
This option will toggle the view between Google Map and Satellite imagery. You can also use ‘S’ on the keyboard to do this.
This option will cause the map to be reloaded with the waypoints according to the current filter.
This will take you to the standard settings for the application.
Each waypoint icon can be selected, which causes the waypoint to be centred on the map and a balloon popup to be displayed. Pressing the close icon will cause the balloon to close, as will selecting an alternative waypoint.. A press on the popup will take you to the cache details page, otherwise there are three separate keys. Navigate will open the Navigate page. Hint will briefly show any hint for the current waypoint at the bottom of the map, and Log Find will take you to the main cache logging page.
The cache details page is where you can find the recorded details about the cache (or waypoint), and record logged finds, DNFs etc. It has a main details pane, and up to 3 other panes depending on the detail available.
This shows the textual description of the waypoint in HTML format as loaded via the gpx or loc file. If the details were loaded via a loc file, there may be very little detail here at all. Where there are images in the descriptions, these will be downloaded and cached if the user has a data connection available.
At the bottom of the detail page is a button where you can show and hide any cache hint if it exists.
This shows a list of all of the logs available for the chosen waypoint. To make finding information easier, it is possible to edit or delete any of the logs, irrespective of who entered them. For example, a plain ‘TFTC’ log is probably not of help if you are having problems finding a cache, so you can delete it.
Any logs listed here where the finder is declared as ‘cachehound’ is a log made using this application, which may be uploaded to the groundspeak geocaching website as part of a field notes file.
This shows the list of trackables that are registered as being in the cache. This list will be modified by choosing to pick up or drop off trackables as part of a cache logging action.
Each geocache may have extra waypoints, e.g. multi-caches, parking locations etc. These will be listed here IF the waypoint id follows the format of the standard groundspeak gpx export, i.e. XXYYYYY, where YYYYY is the same as the matching geocache GCYYYYY.
For each waypoint in the list, you can choose the following options on a long keypress.
Choosing this option will take you to the Navigate page so that you can find the sub waypoint easily.
Edit will allow you to change the coordinates or waypoint type, along with the description and/or comment. Not that at this point you will not be able to change the waypoint ID
Delete the waypoint if there is no need for it, e.g. a reference point that you have passed, or a parking area you do not need.
This pane will be displayed if you have chosen to add a user note to the cache via the Add Note menu option. If there are notes then you will have the option to edit or delete them.
Across all of the Cache details panes there is a common options menu, which has the following options (slightly different if the details are that of a waypoint rather than a cache.
Selecting this option will take you to the compass screen allowing you to navigate towards the waypoint, if you have positioning sensors enabled.
This is the main access point for writing log entries, depending on the waypoint type. See Writing and Editing Logs.
You can choose to add notes to a cache or waypoint, which is essentially a free format text area, for writing multi cache clues etc. See Writing and Editing Notes
For any cache you can add or remove waypoints as required. For example you may wish to enter the final coordinates of a puzzle as a child waypoint, or extract textual location data in the cache description or logs as a ‘proper’ waypoint.
Choosing write new log, or edit log from a context menu, takes the user to the Log page. The edit page will be populated with the selected log, with the following options being available.
When completed and saved, the log will be available to be included in a field note export. If there have been any trackables included in the log, then a textual description of each trackable movement will be appended to the log text.
If there are trackables in your inventory, or there are trackables in a cache, you have the option of logging them as part of a cache log, or independently.
If there are trackables in your inventory, then there will be a drop off button (showing number of trackables in inventory), and if there are trackables in the cache there will be a pick up button (showing number of trackables in cache)
Choosing the Pick Up option will present a dialog screen like this, where you can add the tracking code, and then retrieve or discover it. A text description of your action will be added automatically to your cache log text.
Similarly, choosing the Drop Off button will allow you to either set a trackable from your repository as visited (trackable remains in repository) or dropped off (trackable added to cache trackables).
Copyright First Light Associates 2011 http://firstlightandroid.net