Filters: Difference between revisions
Sandbox test edit via tools/wiki-edit-tmp.php |
|||
| (33 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
==General Information== | |||
Many [[:Category:Tools|tools]] and [[top list]]s 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=== | |||
Some tools split their filters into more than one block. Each block has a different job, and the block header in the UI tells you which is which. Two conventions are used: | |||
* '''Filter (Pre) / Filter (Post).''' The ''Pre'' block is applied to your own finds and determines what the tool considers "done" already. The ''Post'' block is applied to the geocaches the tool then suggests as candidates. Used on [[MapMatrix|D/T Matrix]], [[MapHiddenDate|Map hidden date]], [[MapCounties|Map counties]] and [[MapRegions|Map regions]]. | |||
* '''Filters (Player) / Filter (Geocaches).''' The ''Player'' block decides which players are included; the ''Geocaches'' block decides which geocaches qualify. Used on [[MapCompare|Map Compare]], [[HiddenPerDate|Hidden per date]] and [[LogsPerDate|Logs per date]]. | |||
[[MapMatrix|D/T Matrix]] is a typical Pre/Post case: it covers all 81 difficulty/terrain combinations. Restricting the ''Pre'' block to D 1.0–3.0 / T 1.0–3.5 limits the matrix the tool is trying to fill to 30 cells. The ''Post'' block then narrows which geocaches are suggested for the cells you haven't filled in. | |||
==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 [[authenticate]]d user's own profile name. | |||
On comparison tools (such as [[MapCompare|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 list]]s. 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 list]]s 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. | |||
On a few tools — notably [[PocketQueries|Pocket Queries]] — the country/region list is sourced from [[Geocaching.com]]'s own data rather than from Project-GC's, so the available options match what geocaching.com itself uses. The label is still ''Location''. | |||
===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 list]]s 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 [[D/T|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 [[ForgottenFavorites|Forgotten Favorites]] and [[FTFList|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|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 list]]s default to ''include everything''. | |||
== | ===Premium-only geocaches=== | ||
Include or exclude [[premium member only|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]] [https://www.geocaching.com/plan/lists/BMAFMJR BMAFMJR], which lists travelling, [[Antipode cache|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== | ===Route=== | ||
Restrict to geocaches within a given distance of a linear route built in the [[RouteBuilder|Route Builder]] tool. | |||
== | ==Other== | ||
===Custom filter=== | |||
Restrict the result to geocaches matching an advanced filter built with [[CustomFilters|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 [[MapCompare|Map Compare]], chooses which geocaches to display based on who has found them (''found by neither'', ''by exactly one'', ''by both''), with a separate checkbox to treat the user's owned geocaches as finds. | |||
'' | * '''Include''' — on [[SolvedMysteries|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 [[NeededFoundDates|Needed Found Dates]]. | |||
* '''GC code''' — on [[LogDiff|Log Diff]], restricts the result to log differences on a specific geocache. | |||
* '''Max. number of geocache hides''' — on hides-based [[top list]]s such as [[TopLogsReceived|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. | |||
[[Category:Tools]] | |||
Latest revision as of 08:01, 29 May 2026
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
Some tools split their filters into more than one block. Each block has a different job, and the block header in the UI tells you which is which. Two conventions are used:
- Filter (Pre) / Filter (Post). The Pre block is applied to your own finds and determines what the tool considers "done" already. The Post block is applied to the geocaches the tool then suggests as candidates. Used on D/T Matrix, Map hidden date, Map counties and Map regions.
- Filters (Player) / Filter (Geocaches). The Player block decides which players are included; the Geocaches block decides which geocaches qualify. Used on Map Compare, Hidden per date and Logs per date.
D/T Matrix is a typical Pre/Post case: it covers all 81 difficulty/terrain combinations. Restricting the Pre block to D 1.0–3.0 / T 1.0–3.5 limits the matrix the tool is trying to fill to 30 cells. The Post block then narrows which geocaches are suggested for the cells you haven't filled in.
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.
On a few tools — notably Pocket Queries — the country/region list is sourced from Geocaching.com's own data rather than from Project-GC's, so the available options match what geocaching.com itself uses. The label is still Location.
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 which geocaches to display based on who has found them (found by neither, by exactly one, by both), with a separate checkbox to treat the user's owned geocaches as finds.
- 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.