User:Project-GC.com/Filters-draft

From Project-GC
Revision as of 07:34, 29 May 2026 by magma1447 (3305483) (talk | contribs) (Sandbox test edit via tools/wiki-edit-tmp.php)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

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. Filters marked (paid) below require a paid membership.

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.

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 cache 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 caches inside a particular country, region or county. Available in most top lists and tools that work with caches. 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 (km)

An alternative to Location that takes an address (or a pair of coordinates) and a radius in kilometres. Only caches within that radius are included. Available in many top lists and map tools.

Geocache filters

Geocache name

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

Cache type / size

Restrict the result to specific cache 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 caches that have (or do not have) one or more selected attributes. (paid) on most tools and top lists.

Elevation

Restrict the result to caches within a given elevation range above sea level. (paid)

Corrected coordinates

Filter on whether the user has corrected coordinates on a cache (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 cache's hidden date.
  • Published date — the date the cache was published. (paid)
  • Log date — the user's "found it" log date. (paid)
  • Event date — for events.
  • Last found date — when the cache was most recently found.

Calendar day

Restrict to caches 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 cache's hidden date. (paid)
  • Published calendar day — by the publish date. (paid)
  • Log calendar day — by your "found it" log date. (paid)

Weekday

Restrict to caches 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 cache'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 caches 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 caches.

Disabled / archived / past events

Include or exclude caches 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 caches on the well-known bookmark list BMAFMJR, which lists travelling, antipode and locationless caches that would otherwise distort certain results. (paid) on most tools; the default (include vs exclude) varies.

List filters

Bookmark list

Restrict the result to caches 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: caches that are on the chosen bookmark list are removed from the result. (paid)

Virtual GPS

Restrict the result to caches that appear in a selected Virtual GPS list. (paid)

Route

Restrict to caches within a given distance of a linear route built in the Route Builder tool. (paid)

Other

Custom filter

Restrict the result to caches matching an advanced filter built with Custom Filters. (paid)

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 caches contribute to the total.
  • Extreme categories and Restrict to location level — on the Extremes tools.