Cache attributes

From Opencaching.eu
Revision as of 10:40, 3 June 2019 by Andrixnet (talk | contribs)
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
Category ID text_short text_long id gc_id icon name gc_inc ACODE OCGS
Common attributes between OC and GC
permission 9001 No dogs Dogs not allowed A86
requirement 2 Fee Access or parking fee 36 2 fee Access or parking fee 1 A26
requirement 3 Rappeling Climbing gear requried 49 3 rappeling Climbing gear 1 A53
requirement 4 Boat Boat required 52 4 boat Watercraft 1 A57
requirement 5 Scuba Diving equipment required 51 5 scuba Diving equipment 1 A55
suitability 6 Children Suitable for children A70
59 6 kids Suited for children 1 A71
information 9 Long hike Long walk or hike 25 9 hiking Long walk 1 A21
information 10 Climbing Some climbing (no gear needed) 28 10 climbing Some climbing (no gear needed) 1 A24
warning 11 Wading Swamp or marsh. May require wading 26 11 wading Swamp, marsh or wading 1 A22
requirement 12 Swimming Swimming required 29 12 swimming Swimming required 1 A25
availability 13 Available 24/7 Available 24/7 38 13 available Available 24 hours 1 A39
availability 9013 NOT available 24/7 Available only during open hours 39 13 time Only available at specified times 0 A40
A73
recommendation 14 By night Recommended at night 40 14 day By day only 0 A42
recommendation 9014 By day NOT recommended at night A41
availability 15 Winter Available during winter 44 15 snow Snow-proof hiding place 1 A47
availability 9015 NOT in winter NOT available during winter A85
warning 17 Poison plants Poisonous plants 16 17 plants Poisonous plants 1 A66
warning 18 Dangerous animals Dangerous animals 17 18 animals Dangerous animals 1 A67
warning 19 Ticks Ticks 14 19 ticks Ticks 1 A64
warning 20 Abandoned mine Abandoned mine(s) 15 20 mine Abandoned mines 1 A65
warning 21 Cliff Cliffs / falling rocks hazard 11 21 cliff Cliff / Rocks 1 A61
warning 22 Hunting Hunting grounds 12 22 hunting Hunting 1 A62
warning 23 Danger Dangerous area 9 23 danger Dangerous area 1 A59
suitability 24 Wheelchair accessible Wheelchair accessible A18
facility 25 Parking Parking area nearby 18 25 parking Parking area nearby 1 A33
facility 26 Public transportation Public transportation 19 26 public Public transportation 1 A34
facility 27 Drinking water Drinking water nearby 20 27 water Drinking water nearby 1 A35
facility 28 Restrooms Public restrooms nearby 21 28 restrooms Public restrooms nearby 1 A36
facility 29 Public phone Public phone nearby 22 29 phone Public phone nearby 1 A37
permission 32 Bycicles Bycicles allowed A27
warning 39 Thorns Thorns 13 39 thorn Thorns 1 A63
requirement 40 Stealth Stealth required A74
requirement 44 Flashlight Flashlight required 48 44 flashlight Flashlight 1 A52
permission 46 Truck / RV Truck / RV allowed A87
information 47 Field puzzle Puzzle can only be solved on-site 55 47 riddle Puzzle / Mystery 1 A15
requirement 48 UV light UV light required A84
requirement 51 Special tool Special tool / equipment required 46 51 tools Special equipment 1 A56
availability 52 Night cache Night cache - can only be found at night 1 52 night Only at night 1 A43
information 53 Car Park and grab 24 53 car Near the parking area 1 A19
warning 54 Ruin Abandoned structure / ruin A83
requirement 60 Wireless beacon Wireless beacon / Garmin Chirp™ A9
60 62 calendar Only available during specified seasons 1 A45
availability 9062 All seasons Available all seasons 42 62 date All seasons 0 A44
requirement 64 Treeclimbing Tree climbing required A87
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