Key:fee

From OpenStreetMap Wiki
Jump to navigation Jump to search
Public-images-osm logo.svg fee
Tenerife telescope C.jpg
Description
Yes or no, to indicate if money is charged to use this facility. Show/edit corresponding data item.
Group: properties
Used on these elements
may be used on nodesmay be used on waysmay be used on areas (and multipolygon relations)may be used on relations
Useful combination
Status: de facto

The fee tag specifies the nature of any fee for entry, access, service, use, or otherwise. Examples include car parking (amenity=parking), toilets (amenity=toilets), and tourist attractions and historic buildings (e.g., historic=castle).

Values

Value Meaning
yes A fee is generally charged.
no No fee is charged.
donation No fee is required, but voluntary contributions are accepted.
unknown

It is not possible to distinguish between other possible values as surveyed.

Surveying a more precise value is important.

fee=* should contain a (default) value that applies when no condition does.

Conditional restrictions syntax may be used in fee:conditional=* for more complex rules.

For example:

  • fee=yes + fee:conditional=no @ customers - to mark that fee is waived for customers
  • fee=no + fee:conditional=yes @ 08:00-08:20 - to mark something as free, except between 8:00 and 8:20
  • fee=yes + fee:conditional=no @ We - paid, but free on Wednesdays
  • fee=no + fee:conditional=yes @ stay > 2 hours - parking with stay up to two hours free[1]
  • fee=yes + fee:conditional=no @ stay < 2 hours - also, parking with stay up to two hours free (difference is what will be a default value, used by data consumers not supporting conditional restrictions)
  • fee=yes + fee:conditional=no @ stay < 90 minutes - parking with stay up 90 minutes free (some parking lots describe parking times in minutes)
  • fee=yes + fee:conditional=no @ age < 12 - to mark something as free for children under the age of 12.
  • fee=no + fee:conditional=yes @ stay > 2 hours AND Mo-Fr 07:00-19:00; yes @ stay > 2 hours AND Sa 07:00-13:00 - No fee, except if staying for more than 2 hours on Mon-Fri from 7:00-19:00 or on Sat from 07:00-13:00.
  • fee=no + fee:conditional=yes @ Mo-Fr 09:00-19:00; yes @ Sa 09:00-13:00 - No fee, except on Mon-Fri from 9:00-19:00 or on Sat from 09:00-13:00.
Note: although the syntax is similar to opening_hours=* there is a difference, for example:
Mo-Fr 09:00-19:00; Sa 09:00-13:00 (syntax in opening_hours)
yes @ Mo-Fr 09:00-19:00; Sa 09:00-13:00 (wrong syntax in fee:conditional).
yes @ Mo-Fr 09:00-19:00; yes @ Sa 09:00-13:00 (correct syntax in fee:conditional, after ";" the restriction-value must be repeated).
yes @ (Mo-Fr 09:00-19:00; Sa 09:00-13:00) (alternate syntax in fee:conditional, multiple conditions must be placed between parenthesis).

fee:disabled=* is also available to directly specify whether a fee applies to handicapped users; e.g., where a fee is waived for them.

Common tagging mistakes

Time when a fee is charged as a value of fee=*

Example: fee=Mo-Fr 08:00-17:00

Using opening_hours=*-style date/time ranges as a value of fee=* to specify when a fee is applicable is a somewhat common mistake. When a fee is only applicable some of the time, use fee:conditional=*, as noted above.

When you encounter a value like fee=Mo-Fr 08:00-17:00 and wish to use the correct syntax, one strategy is to replace it with fee=no and fee:conditional=yes @ (Mo-Fr 08:00-17:00).

Fee amount as a value of fee=*

Example: fee=$10

Set fee=yes and use either charge=* and/or charge:conditional=*. In this example, that would be fee=yes + charge=10.00 USD.

Membership fees or longer-term contracts

This key is mainly intended for amenities which charge per use, and where the fee can be paid on the spot when using the facility, such as:

  • entry fees to museums or parks
  • time-based fees for vehicle parking
  • paid public toilets

However, there are also amenities which charge fees as part of a membership or longer-term contract - such as sports clubs, self-storage facilities, fitness clubs, allotment gardens etc. Technically, the membership charge is also a "fee". However, these amenities should not be tagged with fee=yes, as visitors cannot just walk in and pay.

Instead, add membership=yes to indicate the amenity can only be used by persons who hold some kind of membership or entered into a longer-term contract.

See also

  • payment:*=* - to indicate the precise method of payment.
  • toll=* - to indicate that a road, bridge, ferry, or other way is tolled - that you must pay to use it. This key is used instead of fee=*.
  • charge=* - to indicate which fee is charged (other undocumented keys for the same purpose are fee:amount=* and fee:price=*)
  • internet_access:fee=*

References