Cache Hound User Guide

CacheHound

User Documentation


CacheHound

User Documentation

Feature Overview

General Usage

Settings

List Pane

Page Menu Options

Search Online

Location Notification On/Off

Edit Filter

Choose Filter

Clear all ‘new’

Show Current Logs.

Sync. SD Card

Delete all caches

Settings

Edit Filter Screen

Filter State Options

Examples

Context Menu Options

Navigate

Set As Current Centre Point

Add To/Remove From Favourites

Edit

Assign Tags

Delete

Trackable Pane

Page Menu Options

Online Lookup

New Trackable

Show Current Logs

Context Menu Options

Web Details

Navigate to cache

Cache Details

Add Log

Edit

Delete

Map Pane

Page Menu Options

Show Current Location

Show Target Location

Location Notification On/Off

Edit Filter

Choose Filter

Satellite/Map  View

Refresh Waypoints

Settings

Context Options

Cache Details Page

Details Pane

Log Pane

Trackables Pane

Waypoints Pane

Navigate

Edit

Delete

Notes Pane

Options Menu

Navigate

Write New Log

Add/Edit Note

Add New Waypoint

Writing and Editing Logs

Logging Trackables

Writing and Editing Notes

Feature Overview

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:


General Usage

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.

Settings

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.


List Pane

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

Page Menu Options

On pressing the menu key, the following options are available.

Search Online

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).

Location Notification On/Off

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.

Edit Filter

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

Choose 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.

Clear all ‘new’

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.

Show Current Logs.

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.

Sync. SD Card

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.

Delete all caches

Deletes all cache data in the database.

Settings

update settings as per Settings

Edit Filter Screen

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.

Filter State Options

For each of the filter state above, the options are to Include, Exclude, or Ignore.  The explanation of each option is thus:

        Examples

For the cache state, the settings may be as follows

Available

Unavailable

Archived

Result

Ignore

Ignore

Ignore

All states

Include

Ignore

Ignore

Only available

Ignore

Ignore

Exclude

Not Archived

Ignore

Include

Include

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.

Context Menu Options

When a long key press on a waypoint in the filtered list is made, the following options are available.

 Navigate

Taking this option will take you to the Navigate Screen

Set As Current Centre Point

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.

Add To/Remove From Favourites

You may classify any cache as a favourite, by selecting this option.

Edit

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).

Assign Tags

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

Delete the waypoint and all associated information from the database, including logs and notes etc.


Trackable Pane

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.

Page Menu Options

Online Lookup

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.

New 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.

Show Current Logs

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.

Context Menu Options

by selecting a specific trackable in the trackable list the following options are available:

Web Details

provides a direct link to the trackable web page.

Navigate to cache

Takes the user to the compass page for the cache containing the trackable.

Cache Details

Takes the user to the Cache Details page

Add Log

Allows the user to make trackable logs not related to caches.

Edit

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.

Delete

Any Trackable may be deleted from the database as necessary.

Map Pane

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.

Page Menu Options

Show Current 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.

Show Target Location

If the waypoint that you are navigating towards is currently off-screen,  choosing this option will centre the map at your target location.

Location Notification On/Off

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.

Edit Filter

This option is as per the List pane, allowing you to configure which waypoints are displayed for the active filter.

Choose Filter

Option as per List pane, where you can choose from any of the 6 filters you may have defined.

Satellite/Map  View

This option will toggle the view between Google Map and Satellite imagery.  You can also use ‘S’ on the keyboard to do this.

Refresh Waypoints

This option will cause the map to be reloaded with the waypoints according to the current filter.

Settings

This will take you to the standard settings for the application.

Context Options

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.

Cache Details 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.

Details Pane

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.

Log Pane

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.

Trackables Pane

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.

Waypoints Pane

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.

Navigate

Choosing this option will take you to the Navigate page so that you can find the sub waypoint easily.

Edit

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

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.

Notes Pane

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.  

 Options Menu

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.

Navigate

Selecting this option will take you to the compass screen allowing you to navigate towards the waypoint, if you have positioning sensors enabled.

Write New Log

This is the main access point for writing log entries, depending on the waypoint type. See Writing and Editing Logs.

Add/Edit Note

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

Add New Waypoint

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.

Writing and Editing Logs

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.

Logging Trackables

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.

Trackables in Cache Log

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).

 

Writing and Editing Notes

Copyright First Light Associates 2011                                                http://firstlightandroid.net