Key:charge: Difference between revisions

From OpenStreetMap Wiki
Jump to navigation Jump to search
(→‎Usage: Adapt to use seen on taginfo. Include 'per unit'.)
m (taglists compatibility)
Line 3: Line 3:
|status=in use
|status=in use
|description=How much is charged for use of or access to a facility.
|description=How much is charged for use of or access to a facility.
|image=File:Dollarnote_hq.jpg
|image=File:Dollarnote hq.jpg
|group=Properties
|group=Properties
|onNode=yes
|onNode=yes
Line 9: Line 9:
|onArea=yes
|onArea=yes
|onRelation=yes
|onRelation=yes
|combination=* {{Tag|fee}}
|combination=
* {{Tag|toll}}
* {{Key|fee}}
* {{Tag|payment}}
* {{Key|toll}}
* {{Key|payment}}
|implies=
|implies=
}}
}}

{{Tag|charge}} is used to specify the amount of the charge to use or access a facility. It is mostly used in combination with {{Tag|fee|yes}} or {{Tag|toll|yes}}.
{{Key|charge}} is used to specify the amount of the charge to use or access a facility. It is mostly used in combination with {{Tag|fee|yes}} or {{Tag|toll|yes}}.


== Usage ==
== Usage ==
Line 22: Line 24:
'''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>
'''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.


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 {{value|5 EUR}} or {{value|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.
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 {{Value|5 EUR}} or {{Value|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 '''<span style="background:#FFCCFF">currency</span>''' should be specified using its {{Wikipedia|en|ISO 4217#Active codes|ISO 4217|text=no}} code. Do not use currency signs such as {{value|$}}, {{value|€}}, {{value|¥}}, {{value|円}}, or {{value|£}}.
The '''<span style="background:#FFCCFF">currency</span>''' should be specified using its {{Wikipedia|en|ISO 4217#Active codes|ISO 4217|text=no}} code. Do not use currency signs such as {{Value|$}}, {{Value|€}}, {{Value|¥}}, {{Value|円}}, or {{Value|£}}.


<!-- This table is just a quick example of some of the most common currencies. Please don't make it larger; the full list is available on Wikipedia. -->
<!-- This table is just a quick example of some of the most common currencies. Please don't make it larger; the full list is available on Wikipedia. -->
Line 34: Line 36:
! Currency !! Code to use
! Currency !! Code to use
|-
|-
| Euro || {{value|EUR}}
| Euro || {{Value|EUR}}
|-
|-
| Japanese Yen || {{value|JPY}}
| Japanese Yen || {{Value|JPY}}
|-
|-
| Pound Sterling || {{value|GBP}}
| Pound Sterling || {{Value|GBP}}
|-
|-
| Swiss Franc || {{value|CHF}}
| Swiss Franc || {{Value|CHF}}
|-
|-
| US Dollar || {{value|USD}}
| US Dollar || {{Value|USD}}
|}
|}


'''''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.
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}}). 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.
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 ==

* {{Tag|fee||yes}} plus {{Tag|charge||2.00 USD}}
* {{Tag|fee||yes}} plus {{Tag|charge||2.00 USD}}
* {{Tag|fee||yes}} plus {{Tag|charge||2.00 USD/hour}}
* {{Tag|fee||yes}} plus {{Tag|charge||2.00 USD/hour}}
Line 63: Line 64:
* {{Key|fee:amount}} or {{Key|fee:price}} - other variants of this tag.
* {{Key|fee:amount}} or {{Key|fee:price}} - other variants of this tag.
* [[SPARQL examples#Highest fees|Sophox query for highest fees]] based on this key and cross-referencing exchange rates in Wikidata.
* [[SPARQL examples#Highest fees|Sophox query for highest fees]] based on this key and cross-referencing exchange rates in Wikidata.
* {{tag|fine}} to indicate a fine for violating a traffic regulation
* {{Key|fine}} to indicate a fine for violating a traffic regulation


[[Category:Keys indicating rates]]
[[Category:Keys indicating rates]]

Revision as of 00:01, 16 June 2022

Key:charge - Other languages
v · d · e
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
More details at taginfo
Tools for this tag

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
Retrieved from "https://wiki.openstreetmap.org/w/index.php?title=Key:charge&oldid=2342190"