User:Project-GC.com/Filters-draft

General Information

Many tools and top lists on Project-GC let the user narrow the result by applying filters. Each tool only exposes the filters that are meaningful for it, so not every filter on this page is available everywhere. Whether a filter requires a paid membership is also decided per tool, so the same filter can be free on one page and paid on another — see the documentation of the individual tool for that.

Some filters share a common mechanic but appear in the UI under several names. The most common example is Date range, which is exposed as Hidden date, Published date, Log date and a few more — they all behave the same way, only the underlying date column differs. Where this is the case the section lists the variants you may see.

Multiple filter sections

Many pages now have more than one block of filters, and the blocks have different jobs. The original behaviour — one set of filters that simply narrows the result — is still the most common, but newer tools also use a second block as a display or target filter.

A good example is D/T Matrix. There are 81 possible difficulty/terrain combinations. The first filter section narrows the working set of geocaches (e.g. only geocaches in my country, rated D 1.0–3.0 / T 1.0–3.5). The second filter section says which combinations the user actually cares about (e.g. the 30 combinations inside the 1.0–3.0 / 1.0–3.5 range). The first changes which geocaches are considered, the second changes what the tool is trying to fill in.

The filters themselves are the same in both blocks — it's how the tool uses them that differs. The tool's own documentation page will say what each block does.

Profile filters

Profile name

This filter highlights a user in a top list, and is the user whose finds the tool operates on. The button with a blue silhouette and a pencil fills the box with the authenticated user's own profile name.

On comparison tools (such as Map Compare) this filter appears as Compare profile name and adds a second box labelled Compare with for the other user (or users). Users with a paid membership can use the table icon to add several Compare with rows at once for multi-compare.

On tools that operate on a geocache owner (rather than a finder) the same widget is shown with the label Cache owner.

Only players from

Available on some top lists. Limits the result to users whose calculated home location is in a specific country or region.

Location filters

Location

Limits the result to geocaches inside a particular country, region or county. Available in most top lists and tools that work with geocaches. Depending on the tool, only a subset of the levels may be available (e.g. only Country, or Country/region). Some tools also relabel this filter to Country, Region or County to clarify what's expected.

Location (Geocaching.com)

A variant of Location that uses Geocaching.com's own country/region data instead of Project-GC's. Used in places that need to match what geocaching.com itself shows, such as the Pocket Queries interface where the label appears as Location (Geocaching.com; PQs).

Center/radius

An alternative to Location that takes an address (or a pair of coordinates) and a radius. Only geocaches within that radius are included. The unit can be chosen as kilometres or miles and defaults to the user's preferred unit. Available in many top lists and map tools.

Geocache filters

Geocache name

Find geocaches whose name begins with, contains or ends with a given string. For example, all geocaches starting with Church Micro. The match is case-sensitive.

Cache type / size

Restrict the result to specific geocache types and/or sizes. Some tools split this into separate Type and Size filters.

Difficulty / Terrain

Restrict the result to a range (or set) of difficulty and/or terrain ratings. A few tools expose this as just Difficulty.

Attribute

Restrict the result to geocaches that have (or do not have) one or more selected attributes.

Elevation

Restrict the result to geocaches within a given elevation range above sea level.

Corrected coordinates

Filter on whether the user has corrected coordinates on a geocache (typically a mystery). Used on tools that care about the difference between posted and solved coordinates, such as Forgotten Favorites and FTF List.

Date and time filters

Date range

Pick an inclusive date range using From and To. Either field can be left empty for an open-ended range.

The same mechanic is exposed in the UI under several names, depending on which date the tool is filtering on:

• Hidden date — the geocache's hidden date.
• Published date — the date the geocache was published.
• Log date — the user's "found it" log date.
• Event date — for events.
• Last found date — when the geocache was most recently found.

Calendar day

Restrict to geocaches whose date falls on a specific day-of-year (independent of year). Useful for working on a calendar grid.

Exposed in the UI as:

• Hidden calendar day — by the geocache's hidden date.
• Published calendar day — by the publish date.
• Log calendar day — by your "found it" log date.

Weekday

Restrict to geocaches whose date falls on one or more weekdays (Mon–Sun). Useful when working on a weekday grid.

Exposed in the UI as:

• Hidden weekday — by the geocache's hidden date.
• Published weekday — by the publish date.
• Log weekday — by your "found it" log date.

Log, ownership and status filters

Found / Hidden

Include or exclude geocaches the chosen user has found, not found or hidden. The defaults (include vs exclude) depend on the tool — for example, many "Map …" tools default to exclude finds, while top lists default to include everything.

Premium-only geocaches

Include or exclude Premium-only geocaches.

Disabled / archived / past events

Include or exclude geocaches that are disabled, archived or (on some tools) past events. Each status has its own checkbox. The default (include vs exclude) varies between tools.

Travelling geocaches

Include or exclude geocaches on the well-known bookmark list BMAFMJR, which lists travelling, antipode and locationless geocaches that would otherwise distort certain results. The default (include vs exclude) varies between tools.

List filters

Bookmark list

Restrict the result to geocaches that are on a specific bookmark list. Select the owner of the bookmark list, then pick the desired list.

Ignore bookmark list

The same widget as Bookmark list but inverted: geocaches that are on the chosen bookmark list are removed from the result.

Virtual GPS

Restrict the result to geocaches that appear in a selected Virtual GPS list.

Route

Restrict to geocaches within a given distance of a linear route built in the Route Builder tool.

Other

Custom filter

Restrict the result to geocaches matching an advanced filter built with Custom Filters.

Tool-specific filters

A handful of filters only appear on a single tool or top list. They aren't grouped here in detail; the documentation page of the tool itself is the best place to read about them. Some examples:

• Show — on Map Compare, chooses between None, One, Both and Owned as found.
• Include — on Solved Mysteries, chooses which kinds of solved mysteries to include.
• Loop (or Loop number) — on tools that support working on the next loop of a grid, such as Needed Found Dates.
• GC code — on Log Diff, restricts the result to log differences on a specific geocache.
• Max. number of geocache hides — on hides-based top lists such as Logs Received, limits how many of each owner's geocaches contribute to the total.
• Extreme categories and Restrict to location level — on the Extremes tools.