Cache attributes

From Opencaching.eu
Revision as of 09:37, 3 June 2019 by Andrixnet (talk | contribs) (Attrib matrix (initial edit))
Jump to navigation Jump to search


DRAFT, WORK IN PROGRESS

A geocache may have attached a number of attributes, giving more information about the cache, the hiding, the recommendations, requirements, permissions, hazards, other helpful information related with the search.

This document describes the existing cache attributes across Opencaching sites.

Attribute numbering rules

  • all OC attributes that have equivalent meaning to a GC attribute to use the same numeric ID; (while the meaning is equivalent, the exact wording of it's name need not be the same. examples are "bring your children / suitable for children / kids friendly / etc");
  • all OC attributes that have equivalent meaning to a negated GC attribute to use the same numeric ID added to 9000. (for example: "available 24/7" is ID 13. "NOT available 24/7" to be ID 9013.);
    • DE branch negated attributes use a separate flag and retain the ID without adding 9000.
  • OC attributes that have equivalent meaning on both PL and DE branches
  • existing DE branch only attributes to retain their IDs in the range 100 - 199;
  • all OC future and existing attributes that are PL branch specific to have numeric IDs in the range 200 - 299;
  • all OC future attributes that are DE branch specific to have numeric IDs in the range 300 - 399;
  • all OC special purpose attributes to have numeric IDs in the range 900 - 999;
  • all OC attributes that have the meaning of a negated OC attribute to use the same numeric ID on the least significant 3 digits, the fourth digit be the branch designator (according to applicability) and the fifth (most significant digit) be 9; (hypothetical generic example: "available during high tide" ID 241 - PL branch (UK), "NOT available during high tide" ID 9241 - PL branch)
  • all attributes have assigned a unique ACODE (according to OKAPI).
  • all "OC only" attributes have assigned a unique OCGS number, equal to their ID. (for GPX export purposes).

Attributes matrix

OC attributes mapping

Every OC installation has its own set of internal attributes.

Some attributes are common between OC sites; some attributes are common with GC; some attributes are OC only; some attributes are specific to only some OC sites but not all.

OKAPI also provides a unified interface for information exchange with third party apps (eg. c:geo) using GC compatibility and OC extensions (GPX export function).

opencaching-pl OCDE OKAPI GC
Category ID text_short text_long id gc_id icon name gc_inc ACODE OCGS ID YES NO IMAGE NAME
Common attributes between OC and GC
1 YES NO dogs Dogs
permission 9001 No dogs Dogs not allowed A86 1 YES NO dogs Dogs
requirement 2 Fee Access or parking fee 36 2 fee Access or parking fee 1 A26 2 YES fee Access or parking fee
requirement 3 Rappeling Climbing gear requried 49 3 rappeling Climbing gear 1 A53 3 YES rappelling Climbing gear
requirement 4 Boat Boat required 52 4 boat Watercraft 1 A57 4 YES boat Boat
requirement 5 Scuba Diving equipment required 51 5 scuba Diving equipment 1 A55 5 YES scuba Scuba gear
suitability 6 Children Suitable for children A70 6 YES NO kids Recommended for kids
59 6 kids Suited for children 1 A71 6 YES NO kids Recommended for kids
7 YES NO onehour Takes less than an hour
8 YES NO scenic Scenic view
information 9 Long hike Long walk or hike 25 9 hiking Long walk 1 A21 9 YES NO hiking Significant hike
information 10 Climbing Some climbing (no gear needed) 28 10 climbing Some climbing (no gear needed) 1 A24 10 YES NO climbing Difficult climbing
warning 11 Wading Swamp or marsh. May require wading 26 11 wading Swamp, marsh or wading 1 A22 11 YES wading May require wading
requirement 12 Swimming Swimming required 29 12 swimming Swimming required 1 A25 12 YES swimming May require swimming
availability 13 Available 24/7 Available 24/7 38 13 available Available 24 hours 1 A39 13 YES NO available Available at all times
availability 9013 NOT available 24/7 Available only during open hours 39 13 time Only available at specified times 0 A40 13 YES NO available Available at all times
A73 13 YES NO available Available at all times
recommendation 14 By night Recommended at night 40 14 day By day only 0 A42 14 YES NO night Recommended at night
recommendation 9014 By day NOT recommended at night A41 14 YES NO night Recommended at night
availability 15 Winter Available during winter 44 15 snow Snow-proof hiding place 1 A47 15 YES NO winter Available during winter
availability 9015 NOT in winter NOT available during winter A85 15 YES NO winter Available during winter
warning 17 Poison plants Poisonous plants 16 17 plants Poisonous plants 1 A66 17 YES NO poisonoak Poison plants
warning 18 Dangerous animals Dangerous animals 17 18 animals Dangerous animals 1 A67 18 YES dangerousanimals Dangerous Animals
warning 19 Ticks Ticks 14 19 ticks Ticks 1 A64 19 YES ticks Ticks
warning 20 Abandoned mine Abandoned mine(s) 15 20 mine Abandoned mines 1 A65 20 YES mine Abandoned mines
warning 21 Cliff Cliffs / falling rocks hazard 11 21 cliff Cliff / Rocks 1 A61 21 YES cliff Cliff / falling rocks
warning 22 Hunting Hunting grounds 12 22 hunting Hunting 1 A62 22 YES hunting Hunting
warning 23 Danger Dangerous area 9 23 danger Dangerous area 1 A59 23 YES danger Dangerous area
suitability 24 Wheelchair accessible Wheelchair accessible A18 24 YES NO wheelchair Wheelchair accessible
facility 25 Parking Parking area nearby 18 25 parking Parking area nearby 1 A33 25 YES NO parking Parking available
facility 26 Public transportation Public transportation 19 26 public Public transportation 1 A34 26 YES public Public transportation
facility 27 Drinking water Drinking water nearby 20 27 water Drinking water nearby 1 A35 27 YES NO water Drinking water nearby
facility 28 Restrooms Public restrooms nearby 21 28 restrooms Public restrooms nearby 1 A36 28 YES NO restrooms Public restrooms nearby
facility 29 Public phone Public phone nearby 22 29 phone Public phone nearby 1 A37 29 YES NO phone Telephone nearby
30 YES NO picnic Picnic tables nearby
31 YES NO camping Camping available
permission 32 Bycicles Bycicles allowed A27 32 YES NO bicycles Bicycles
33 YES NO motorcycles Motorcycles
34 YES NO quads Quads
35 YES NO jeeps Off-road vehicles
36 YES NO snowmobiles Snowmobiles
37 YES NO horses Horses
38 YES NO campfires Campfires
warning 39 Thorns Thorns 13 39 thorn Thorns 1 A63 39 YES thorn Thorns
requirement 40 Stealth Stealth required A74 40 YES NO stealth Stealth required
41 YES NO stroller Stroller accessible
42 YES ** firstaid Needs maintenance
43 YES cow Watch for livestock
requirement 44 Flashlight Flashlight required 48 44 flashlight Flashlight 1 A52 44 YES flashlight Flashlight required
45 YES *** landf Lost And Found Tour
permission 46 Truck / RV Truck / RV allowed A87 46 YES NO rv Truck Driver/RV
information 47 Field puzzle Puzzle can only be solved on-site 55 47 riddle Puzzle / Mystery 1 A15 47 YES NO field_puzzle Field Puzzle
requirement 48 UV light UV light required A84 48 YES UV UV Light Required
49 YES snowshoes Snowshoes
50 YES skiis Cross Country Skis
requirement 51 Special tool Special tool / equipment required 46 51 tools Special equipment 1 A56 51 YES s-tool Special Tool Required
availability 52 Night cache Night cache - can only be found at night 1 52 night Only at night 1 A43 52 YES NO nightcache Night Cache
information 53 Car Park and grab 24 53 car Near the parking area 1 A19 53 YES NO parkngrab Park and Grab
warning 54 Ruin Abandoned structure / ruin A83 54 YES NO abandonedbuilding Abandoned structure
55 YES NO hike_short Short hike (less than 1km)
56 YES NO hike_med Medium hike (1km-10km)
57 YES NO hike_long Long hike (+10km)
58 YES NO fuel Fuel Nearby
59 YES NO food Food Nearby
requirement 60 Wireless beacon Wireless beacon / Garmin Chirp™ A9 60 YES wirelessbeacon Wireless Beacon
61 YES *** partnership Partnership cache
60 62 calendar Only available during specified seasons 1 A45 62 YES NO seasonal Seasonal Access
availability 9062 All seasons Available all seasons 42 62 date All seasons 0 A44 62 YES NO seasonal Seasonal Access
63 YES NO touristOK Tourist Friendly
requirement 64 Treeclimbing Tree climbing required A87 64 YES NO treeclimbing Tree Climbing
65 YES NO frontyard Front Yard (Private Residence)
66 YES NO teamwork Teamwork Required
67 YES *** geotour GeoTour
OC only attributes
Common attributes between OCPL and OCDE projects
special 106 OC ONLY OPENCACHING only cache 6 106 oconly Only loggable at Opencaching 1 A1 106
7 107 wwwlink Hyperlink to another caching portal only 1 A82 107
requirement 108 Letterbox Letterbox 8 108 letter Letterbox (needs stamp) 1 A4 108
warning 110 Train Active railway nearby 10 110 train Active railway nearby 1 A60 110
information 123 Firstaid First aid available 23 123 firstaid First aid available 1 A38 123
information 127 Steep Hilly area 27 127 steep Hilly area 1 A23 127
information 130 Interestsign Point of interest 30 130 interestsign Point of interest 1 A30 130
information 131 Moving Moving target 31 131 moving Moving target 1 A11 131
information 132 Webcam Webcam 32 132 webcam Webcam 1 A12 132
availability 133 Indoor Indoors, withing enclosed space (building, cave, etc) 33 133 indoor Wihin enclosed rooms (caves, buildings etc.) 1 A31 133
availability 134 Under water Under water 34 134 submerged In the water 1 A32 134
requirement 135 No GPS No GPS required 35 135 nogps Without GPS (letterboxes, cistes, compass juggling ...) 1 A58 135
requirement 137 Overnight Overnight stay necessary 37 137 overnight Overnight stay necessary 1 A69 137
warning 142 Tide Not available during high tide 42 142 tide Not at high water level 1 A48 142
permission 143 Nature Nature preserve / Breeding season 43 143 naturschutz Breeding season / protected nature 1 A46 143
requirement 147 Compass Compass required 47 147 compass Compass 1 A49 147
requirement 150 Cave Cave equipment required 50 150 cave Cave equipment 1 A50 150
requirement 153 Aircraft Aircraft required 53 153 aircraft Aircraft 1 A75 153
requirement 154 Wiki Internet research required 54 154 wiki Investigation 1 A14 154
information 156 Math problem Mathematical problem 56 156 arith_prob Arithmetical problem 1 A16 156
information 157 Othercache Other cache type 57 157 othercache Other cache type 1 A13 157
requirement 158 Ask Ask owner for start conditions 58 158 ask Ask owner for start conditions 1 A17 158
61 161 safari Safari Cache 1 A72 161
OCPL only attributes
information 201 Quick and easy Quick and easy cache A68 201
information 202 GeoHotel GeoHotel for trackables A5 202
requirement 203 BYOP Bring your own pen A50 203
information 204 Magnetic Attached using magnet(s) A6 204
information 205 MP3 Information in MP3 file A7 205
information 206 Offset cache Container placed at an offset from given coordinates A8 206
information 207 USB Dead Drop USB container A10 207
information 208 Benchmark Benchmark - geodetic point A2 208
information 209 Wherigo Wherigo cartridge to play A3 209
information 210 Nature Hidden in natural surroundings A28 210
information 211 Monument Monument or historic site A29 211
requirement 212 Shovel Shovel required A51 212
permission 213 Walk Access only by walk A20 213
information 214 Handicaching Rated on Handicaching.com A76 214
information 215 Munzee Contains a Munzee A77 215
information 216 Ads Contains advertising A78 216
warning 217 Military training area Military training area, some access restrictions - check before visit A79 217
warning 218 Video surveillance Caution, area under video surveillance A80 218
suitability 219 Trackables Suitable to hold trackables A81 219
information 220 Historic Officially designated historical monument A88 220
Special purpose attributes
999 Password Log password

Notes:

  • Opencaching-PL implements all attributes as either ON or OFF; Inverse meaning is handled by a different attribute.
  • Opencaching-DE implements attributes with a unique internal ID and the same public ID and uses a flag to indicate normal (inc=1) / inverse (inc=0) meaning.
  • OKAPI defines an internal ACODE to map OC attributes to GC equivalent.
  • OKAPI defines an additional pseudo-Groundspeak ID ("OCGS" IDs) for Opencaching attributes which have no Groundspeak equivalent, used to store such attributes in GPX <groundspeak:attribute> elements. "OCGS" IDs are unique and do not overlap with Groundspeak attribute IDs.

GC attributes reference

Reference documented for establishing equivalences necessary for compatibility with third party apps using GPX file.

  • Attribute has only YES = attribute that can be set or unset;
  • Attribute has both YES and NO = attribute that can be set normally, set as it's inverse meaning or unset;


Cite error: <ref> tags exist for a group named "GC attributes", but no corresponding <references group="GC attributes"/> tag was found