Key:charge: Difference between revisions

From OpenStreetMap Wiki
Jump to navigation Jump to search
(→‎Usage: Adapt to use seen on taginfo. Include 'per unit'.)
Line 18: Line 18:
== Usage ==
== Usage ==


Values for this key have the following notation:
Values for this key commonly have the following notation:


'''charge =''' <span style="background:#CCFFFF">&lt;amount&gt;</span> <span style="background:#FFCCFF">&lt;currency&gt;</span><span style="background:#FFFFCC">['''/'''&lt;time unit&gt;]</span>
'''charge =''' <span style="background:#CCFFFF">&lt;amount&gt;</span> <span style="background:#FFCCFF">&lt;currency&gt;</span></span><span style="background:#CCFFDD">['''/'''&lt;unit&gt;]</span><span style="background:#FFFFCC">['''/'''&lt;time unit&gt;]</span>


The '''<span style="background:#CCFFFF">amount</span>''' should include any cents (or whichever unit a currency uses) if charged, so if for example, the fee charged is $2.95, then tag this as {{value|2.95 USD}} and do not round the amount up to {{value|3 USD}}. Always use the decimal point as {{Wikipedia|en|Decimal separator|decimal separator|text=no}} for such amounts.
The '''<span style="background:#CCFFFF">amount</span>''' should include any cents (or whichever unit a currency uses) if charged, so if for example, the fee charged is $2.95, then tag this as {{value|2.95 USD}} and do not round the amount up to {{value|3 USD}}. Always use the decimal point as {{Wikipedia|en|Decimal separator|decimal separator|text=no}} for such amounts.
Line 47: Line 47:
'''''For other currencies, see {{Wikipedia|en|ISO 4217#Active codes|this list}}.'''''
'''''For other currencies, see {{Wikipedia|en|ISO 4217#Active codes|this list}}.'''''


In some cases the charge levied is per some '''<span style="background:#CCFFDD">unit</span>'''. Some examples of these seen in use include {{value|person}} (charge per person), {{value|kWh}} (charge per kilowatt-hour of energy), {{value|1.5 litre}} (charge per litre of some fluid such as water). The various vehicle categories defined in {{Key|access}}, such as {{value|motorcar}} or {{value|hgv}} ({{Wikipedia|en|Heavy goods vehicles|text=no}}) can also be used.
The optional '''<span style="background:#FFFFCC">time unit</span>''' should not be abbreviated (use {{value|hour}} instead of {{value|h}}).

The optional '''<span style="background:#FFFFCC">time unit</span>''' should not be abbreviated (use {{value|hour}} instead of {{value|h}}). In addition to discrete durations in units like minutes, hours, days, and weeks, other values such as {{value|night}} and {{value|day}} are used as well.


== Examples ==
== Examples ==

Revision as of 16:53, 17 August 2021

Public-images-osm logo.svg charge
Dollarnote hq.jpg
Description
How much is charged for use of or access to a 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: in use

charge=* is used to specify the amount of the charge to use or access a facility. It is mostly used in combination with fee=yes or toll=yes.

Usage

Values for this key commonly have the following notation:

charge = <amount> <currency>[/<unit>][/<time unit>]

The amount should include any cents (or whichever unit a currency uses) if charged, so if for example, the fee charged is $2.95, then tag this as 2.95 USD and do not round the amount up to 3 USD. Always use the decimal point as  decimal separator for such amounts.

If the amount charged is a whole number omitting the cents (or any other subdivision) is permissible. So a fee of exactly €5 may be written as either 5 EUR or 5.00 EUR. Some mappers prefer the latter because it explicitly conveys that no rounding of the amount has occurred. For currency that has no subdivision, such as Japanese Yen or Korean Won, no decimal part is used at all.

The currency should be specified using its  ISO 4217 code. Do not use currency signs such as $, , ¥, , or £.

ISO 4217 codes for a few common currencies
Currency Code to use
Euro EUR
Japanese Yen JPY
Pound Sterling GBP
Swiss Franc CHF
US Dollar USD

For other currencies, see this list on Wikipedia.

In some cases the charge levied is per some unit. Some examples of these seen in use include person (charge per person), kWh (charge per kilowatt-hour of energy), 1.5 litre (charge per litre of some fluid such as water). The various vehicle categories defined in access=*, such as motorcar or hgv ( Heavy goods vehicles) can also be used.

The optional time unit should not be abbreviated (use hour instead of h). In addition to discrete durations in units like minutes, hours, days, and weeks, other values such as night and day are used as well.

Examples

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.
  • fee:amount=* or fee:price=* - other variants of this tag.
  • Sophox query for highest fees based on this key and cross-referencing exchange rates in Wikidata.
  • fine=* to indicate a fine for violating a traffic regulation