Offline Usage

From Cachly Help Wiki
Jump to: navigation, search

Using Offline Mode of Cachly[edit]

Offline Lists are a way of saving caches and cache data offline for use without a wifi or cellular data connection. The offline tab presents a screen of lists of offline caches you have saved. There are a number of ways to create offline lists including:

When you are out in the field you can tap any cache in an offline list or on the icon on the map to get to the Cache Details screen. Here you can look at the cache information, navigate, log the cache and much more.

It's not enough to have offline lists if you will be somewhere you have no data connection. You will almost surely want maps also. You need to download the appropriate ones while you have data. Tap Download Offline Maps to get detailed instructions.

Managing Offline Lists[edit]

This screen shows all your offline lists and allows editing them and adding new ones. Each offline list entry name is preceded by a count of the number of caches in that list. Observant readers will note the "Online" tab. What the heck is "Online" doing on a screen about offline. If you are keen to know you can go here and find out.

OfflineScreen-4.3.png

Tapping the + on the right will prompt you to Create a list by entering a name for it. After entering a name, you can tap Save to complete creating a new empty list or tap Cancel to exit without creating a new list. The new list will appear at the top of your existing lists.

Editing Offline List Order[edit]

Tapping Edit lets you reorder your lists, delete them and sort them. When editing, tapping the red circle to the left of the name offers a Delete button. Tapping the Delete button will ask if you are sure about the delete. Tapping OK will complete the list deletion.

Tip: Swiping left on a list entry is a shortcut for deleting a single entry by offering you the Delete button.

When editing you can manually reorder your lists using the gray triple bars at the far right. Touch the bars and drag the list entry to where you want it. Finally, you can do a bulk reorder by tapping Sort. This lets you sort all the lists by Title, Date, or Cache Count. Tapping Done in the Offline Navigation Bar exits Edit mode.

List Options[edit]

Tapping the ••&bull action button at the right of a list entry line provides actions you can perform on that list.

  • Rename: Enter a new name for the list
  • Clear Current Selection: Clears the marker dot showing you the most recent visited list
  • Copy: Copy the contents of the current offline list into a different list that you select.
  • Merge: Combine the entries from this list into another selected list and remove this list.
  • Move: Move all the entries from this list to a selected list and retain this list with zero entries.
  • Export GPX: Export all the caches in the list as a GPX file.
  • Remove Caches: Remove all the caches from the list but retain the list name with zero entries.
  • Delete Cache Images: Delete any images associated with the caches in the list. This can free up space on your device if you are running short.
  • Delete: Delete the list

Using Offline List and Map Views[edit]

The primary reason for using this interface is to select an offline list to use for caching operations. Tapping the name of the list will open a screen offering Map and List views of the entries in the list. The top bar offers a back arrow that will return you to the previous view of all available offline lists. Like the Live View, there is a switch to go between Map and List View. The currently selected one will be highlighted in a darker color.

Offline Map View Offline List View
OfflineMapView-4.3.png OfflineListView-4.3.png

From the List View you can see all the caches in the Offline List. If you tap on one of them, you are taken to the Cache Details screen where you are ready to proceed with seeking that cache.

Both Map and List view provide for searching and filtering the caches in the list. The ••• action button at the far right offers slightly different actions for Map View and List View.

Tip: You can select the background map by tapping the Map Options Icon

Searching an offline list[edit]

Enter a string in the Search Offline List field and tap Search. The search will show any caches whose title, cache code, cache type, container type and owner username contain your search string. Only caches matching your string will be displayed on the Map or in the List according to the view. Clearing the search field will restore all caches in the list to visibility.

Tip: If you think some caches have disappeared, most likely clearing the search field will make them reappear.

Tip: Search for "trad" and you will get all traditional caches.

Available Actions in Offline Map View[edit]

The following actions are available when in Map View of an offline list.

  • Add Geocache: Add a user-defined cache entry that only exists local to Cachly. This can be useful for things like Lab Caches at an event.
  • Save to List: Save the caches to another offline or online list. You can choose to save All Caches or just Visible Caches.
  • Update Caches: Update the information for all caches or just visible caches in the offline list using the Live API. The update can pull down Basic information or perform a Full cache update.
  • Download Cache Images: Get images associated with the caches to be stored offline.
  • Highlight: Adds or Removes a colored highlight around Cache Icons in Map View and on the title in List View. You can set and clear highlight according to your needs. For example, you might highlight each cache you particularly want to find. Highlighting is automatically synced between devices using iCloud.
  • Export GPX: Exports Map View caches to an external GPX file. You can choose to export All, Visible, or Highlighted caches.
  • Delete Visible Caches: Delete just the visible caches. This can be handy for pruning away caches in the Map view you are not interested in before saving the rest to a new list.

Options Actions in Offline List View[edit]

In addition to the options in Offline Map View (immediately above) the following action is available when in Offline List View.

  • Sort Caches: Provides a dialog where you can choose a field to sort on and specify if the sort is ascending or descending.

Filtering an Offline List[edit]

Filtering in the Live View is limited to the filters offered by geocaching.com. Cachly can offer a much wider range of filters for offline lists because all of the data is already local to your device. Filter definition is triggered by tapping on the funnel to the right of the search field. This opens a filter management view.

Tip: You can tell filtering is being done when the funnel icon is dark green.

When filters are active, you will see an extra action in the Map and List View Action Button options -- Delete Filtered Caches.

Filter Management View

FilterScreen.jpg

Initially all filters are disabled. You can come here and Disable Filters whenever you want an unfiltered view of all the caches in the offline list.

However, we are interested in defining a filter so tap Add Filter to get started. We will return to the concept of Filter Templates once we learn how to create a filter. After tapping Add Filter you will see:

Sample Create Filter
CreateFilter.jpg

First you select the property you want to filter on. There are a lot of choices as you will soon see. The first in the list alphabetically is Archived which is what you see above. If you tap the Yes/No line, the setting will flip back and forth. Leave it on Yes. If you now tap Done, you will have a simple filter that limits visible caches in the offline list to just Archived ones. The switch to the right of the filter lets you disable just that filter. As mentioned, earlier the Disable Filters will turn them all off.

Sample Created Filter to show Archived Caches
CreatedFilter.png


Lets add a second filter to the one we have. Tap Add Filter and then tap the > at the right of the Type line to bring up a list of all filter types. Scroll down and choose the Is Premium filter, That will give us:

Sample Filter for Premium and Archived Caches
2Filters.png

If both are set to Yes, only Archived Premium caches will be shown from the offline list. With two or more filters, the Logic line below the filters becomes useful. By default, it is set to AND so all filters must be true for a cache to be shown. Tapping it will change the AND to OR and then any one of the filters that is true will cause the cache to be shown.

Offline Filter Types[edit]

The full list of things you can filter on is:

Archived: Yes/No
Attributes: Multi-valued reflecting attributes you want filtered on
Available: Yes/No
Cache Note: String to match in cache note
Cache Type: Traditional, Multi, etc.
Caches I Own: Your caches
Container Size: Micro, small, etc.
Country: String to match in countrie(s) name
DNF: Yes/No
Date Downloaded: Date range when downloaded to Cachly
Date Found: Date range when found by you
Date Last Found: Date range when last found
Date Last Updated: Date cache information last updated from geocaching.com
Date Placed: Date range placed
Description: String search of description text
Difficulty: 1.0 to 5.0. A single difficulty or a range.
Distance: Distance from cache
FTF: Only show FTF eligible caches
Favorited: Yes/No
Favorites: Favorite range filter
Found: Yes/No
GC Code: String matching on GC Code
Has Attributes: Yes/No
Has Cache Note: Yes/No
Has Corrected Coordinates: Yes/No
Has Images: Yes/No
Has Logs: Yes/No
Has Trackables: Yes/No
Has Waypoints: Yes/No
Highlighted: Yes/No
Hint: String search of hint text
Is Premium: Yes/No
Log Text: String search of log text
Name: String search of cache name
Owner: String search of cache owner name
Placed By: String search of person placing the cache
State: String to match in States list
Terrain: 1.0 to 5.0. A single terrain level or a range.

Advanced: Some filters provide an extra action labeled Invert Filter. Use this when you want the filter to be for the exact opposite of what you have set it up to do. In some cases, this can save a lot of time. For example, if you want all but Traditional caches, it is faster to set the filter for Traditional and Invert it instead of manually turning on all the cache types except traditional.

Filter Templates[edit]

Filters apply only to the offline list you create them in. Given that some filters can be quite complex, you would like to be able to define them once and use them with more than one offline list. That is where Filter Templates come in.

Let's first define a moderately complex but useful set of filters to find all solved puzzles that you have not yet found.

It would look like this:

SolvedPuzzles.jpg

Now let's define a named Filter Template for this set of of filters. Filter template creation is at the bottom of the filters view.

CreateTemplate.JPG

Tap Save New Template to name it. A good name would be Solved Puzzles. Entering the name now makes this the Current template as you can see:

SavedTemplate.jpg


If you later go to some other offline list, you can tap on Current Template and see a list of saved filter templates and you can choose the one that meets your needs without having to define it again. If you have a current template and don't want one, just tap Clear when selecting a current template and any previous filters for the list will be restored. Templates can also be deleted by a swipe left.

Advanced: Some of you may wonder what happens when you have a set of filters from a current filter template and you define some others. These supplement the Current template filtering.

Interaction of Template with User filter settings: Edge Cases[edit]

Someone will always wonder how applying a template interacts with manually set filters. Here is what happens for some cases:

Q: You have a current template but have contradictory settings in user-added filter. A: Templates will override any list specific filters and use template filters instead.

Q: The current template has attributes and user adds a separate filter with extra attributes. A: Same as previous answer. The template filter completely overrides.

Q: The current template was defined with AND but OR is then toggled on (and vice-versa). A: AND/OR is not part of the template so the user setting is used.