|Deprecation of landuse=reservoir|
|Status:||Proposed (under way)|
|Definition:||An artificially-created or enlarged body of water created using a dam to store water for human use.|
This proposes that:
- The tag landuse=reservoir is deprecated, and replaced with natural=water + water=reservoir, which was approved in 2011.
- The key reservoir_type=* is deprecated, and replaced with alternate tagging as described in the table below.
- Definitions are adopted, as described in the following sections, for:
|landuse=reservoir||natural=water + water=reservoir|
|reservoir_type=water_storage||None. This tag can be safely removed.|
|reservoir_type=sewage||natural=water + water=wastewater|
Mappers should tag lakes, ponds, and reservoirs (which often have similar appearance on imagery) as natural=water. If they are able to further determine the specific type of waterbody, water=* can also be applied. Definitions for three of these values (reservoir, lake, and pond) are described below.
A reservoir is an artificially-created or enlarged body of water created using a dam to store water for human use. Dam, in this context, specifically refers to a man-made structure which allows for human control of the reservoir water level and downstream water flow. (See:).
Reservoirs include the following types:
- Dammed valleys rely on the natural topography to provide most of the body of the reservoir. A dam is typically located at a narrow part of a valley downstream of a natural basin. Sometimes additional side dams are required to contain the reservoir. In hilly regions, reservoirs may be constructed by enlarging existing lakes.
- Coastal reservoirs are fresh water storage reservoirs located on the sea coast near the river mouth to store the flood water of a river. Many coastal reservoirs were constructed in Asia and Europe.
- Bank-side reservoirs, where water is pumped or siphoned from a river to store the water. Such reservoirs are usually formed partly by excavation and sometimes by building an encircling or embankment.
Reservoirs are used for multiple purposes:
- Water supply. Many reservoirs are used to provide the raw water feed to a water treatment plant which delivers drinking water through water mains, or irrigation water used by agriculture.
- Hydroelectricity. A reservoir generating hydroelectricity includes turbines connected to the retained water body by large-diameter pipes. These generating sets may be at the base of the dam or some distance away.
- Controlling watersources. Reservoirs can be used to control water flow in downstream waterways:
- Water may be released from an upland reservoir so that it can be used downstream for drinking, irrigation, etc.
- Flood control and flow balancing reservoirs collect water at times of high flow, then release it slowly during the following weeks or months.
- Water may be released from a reservoir to supplement white water conditions for white-water sports, or to encourage natural migration behaviours in fish
- Recreation. Many reservoirs often allow some recreational uses, such as fishing and boating. Recreation is usually a secondary use of reservoirs that are used for hydroelectric generation or irrigation, however there are some cases of reservoirs which are purely recreational.
- Navigation. It is common on large navigable rivers (for example, the Mississippi River in the USA) to create a series of subsequent reservoirs with dams and locks to allow for waterborne navigation. The dam in this case removes rapids and creates a level surface for boats. In cases where these dam/lock systems meaningfully widen the river into a larger named water body, this should be tagged as a reservoir.
- Cooling. Also known as a cooling pond, a cooling reservoir is a man-made body of water primarily formed for the purpose of cooling heated water and/or to store and supply cooling water to a nearby power plant or industrial facility such as a petroleum refinery, pulp and paper mill, chemical plant, steel mill or smelter.
- Service reservoirs are used for storage of potable drinking water close to the point of distribution. While these are called "reservoirs" in water systems jargon, these are usually not open bodies of water, but rather a storage tank, cistern, basin or a water tower, and thus should be tagged instead as man_made=storage_tank, water=basin/landuse=basin or man_made=water_tower as appropriate.
- Bodies of water with dams that do not fit the description above should not be tagged as reservoirs, and should instead be tagged with water=lake or water=pond instead. This includes:
- Bodies of water with with beaver dams
- Ponds created for decorative or aesthetic landscaping purposes
- Structures which were historically used for water-powered machinery, such as a
- Bodies of water created by a weir (waterway=weir) are not reservoirs, as these structures do not have flow control. A reservoir may include weirs for grade separation between sections of a reservoir, however the most downstream outlet must be a dam with flow control.
Lakes and Ponds
A lake or a pond is a naturally-occurring or artificial inland body of water. There is no precise difference between a lake or a pond. The definitions below are provided as guidelines for mappers to make the determination of which tag to use. Note that some bodies of water may exhibit aspects of both lists; local mappers should make a determination which definition is the best fit.
- Are not a reservoir (see definition above)
- Not a basin (see landuse=basin, water=basin, and basin=*)
- Are usually larger than 8-20 hectares in size
- Often named with "lake" (or local language equivalent) in the name
- Have areas of deep water that receive no sunlight, preventing plant growth (see on Wikipedia)
- Not a reservoir (see definition above)
- Not a basin (see landuse=basin, water=basin, and basin=*)
- Lacking wave action at the shoreline
- Are usually no more than 8-20 hectares in size
- Often named with "pond" (or local language equivalent) in the name
- Shallow enough for sunlight to reach the bottom or to allow rooted plants to grow throughout it (see on Wikipedia)
- Some naturally-occurring lakes or ponds may have a regulating dam or weir at its outlet which does not meaningfully change the size of the water body, but rather was built to minimize seasonal variations in water level on the lake or outlet stream, or to provide hydroelectric power generation from an existing natural lake. These lakes and ponds are not reservoirs merely because of the presence of outflow regulating infrastructure. in Montana USA is one such example of this; while the added hydroelectric dam raised the lake level by 3 meters, this only represented a small increase in the size of the existing natural lake.
- water=stream_pool, and are not considered ponds. and , which are bodies of water that naturally occur along the course of the waterway, are covered by the existing tag
- Because the distinction between a lake and a pond is imprecise, "vanity naming" sometimes occurs. For example, a real estate developer may construct a pond as part of a housing development but name it as lake for marketing purposes.
- The question of how to tag a mailing discussion on this topic showed that there is disagreement as to whether quarry lakes should be tagged with water=lake or with some other key such as water=quarry_lake. Commenters noted that quarry lakes had unique characteristics that made them distinct from other types of lakes. However, other commenters noted the difficulty of determining the quarry origin of a lake, particularly for older or even ancient quarries. Because there does not appear to be a firm consensus either way, the question of how to tag these bodies of water is deliberately left unresolved by this proposal. is unresolved. A
Meaning of "Deprecated"
Specifically, in this context the term deprecated means:
- The OSM community recommends natural=water + water=reservoir as a drop-in replacement for landuse=reservoir
- The deprecation template will be added to the wiki page for landuse=reservoir
- The tag landuse=reservoir will be added to Deprecated features
- The tag landuse=reservoir will remain listed on Map features until it is no longer used.
- Data consumers are recommended to support both tags until such time as landuse=reservoir is no longer in use
|Under no circumstances should you automatically (or semi-automatically) change "deprecated" tags to something else in the database on a large scale without conforming to the Automated Edits code of conduct. Any such edits will be reverted.|
The 2011 proposal Water details approved the new key water=*. Specifically, it proposed the combination of natural=water + water=reservoir as the replacement for landuse=reservoir. The purpose of that proposal included the following rationale:
- "For areas tagged with natural=water it should be possible to mark which type of water body it is."
- "[...] reservoirs should be tagged consistently with other water bodies, using natural=water."
Since water=* was a new key, it was recommended in that proposal that mappers tag both water=reservoir and landuse=reservoir in order for data consumer to begin adopting the new tagging. Over time, a debate emerged as to whether landuse=reservoir was deprecated or whether this 2011 proposal intended to create a fully parallel tagging scheme for reservoirs. This proposal ends that ambiguity by affirming the intent of the 2011 proposal by declaring that landuse=reservoir is deprecated.
- A land tag should not be used to tag a water feature. Map features describes the landuse=* key as describing "the purpose for which an area of land is being used."
- Mappers should be able to tag visible water features with natural=water without having to determine in advance whether or not it is a reservoir. With landuse=reservoir, a mapper must first determine whether or not a body of water is a reservoir before deciding which tag to use.
- Mappers have preferred the use of water=reservoir over landuse=reservoir in recent years. Since 2016, usage of water=reservoir has increased by 241,066 while landuse=reservoir has decreased by 2,403. (data as of 12/19/20) This suggests that mappers are using water=reservoir for mapping new reservoirs, while slowly replacing existing usages of landuse=reservoir.
- Mappers have preferred since water=reservoir over landuse=reservoir since mid-2016, 2.5 years before the introduction of changes to iD editor presets in favor of the water=* tag. The iD preset change merely accelerated an existing mapper preference for water=* over alternative schemes.
- There is a need for formal definitions in order to clarify what exactly a water=reservoir is, and how it differs from water=lake and water=pond.
- Despite the lack of a clear distinction between lakes and ponds in the real world, mailing list discussions have indicated that there is community support for maintaining a distinction between them, even if that distinction involves a degree of subjective judgement on the part of mappers.
Data from taginfo API as of 18 Feb 2021
|# Areas||Change||Preference||Change||Usage Ratio||Change||# Areas|
These graphs shows the usage of the two tags over time. There is a clear trend towards the use of water=* tags. The first graph compares way tagging, and the second graph compares relation tagging.
|Tagging of water=reservoir vs landuse=reservoir over time|
|Tagging of water=reservoir vs landuse=reservoir over time|
iD 2.13.0 Preset Change
On December 11, 2018, a new issue was opened in the iD editor's issue tracker to change that editor's presets to use the water=* scheme rather than competing alternatives. This change took effect with version 2.13.0, released Jan 23, 2019.
The following listing demonstrates the various types of reservoirs described above.
- , a dammed valley and the largest reservoir in the United States.
- in Wales, a dammed valley in which additional side dams are required to contain the reservoir.
- , and are examples of a chain of reservoirs in the valley.
- in Singapore
- in China
- in Hong Kong
- in the United Kingdom
Flood control Reservoirs
- in Australia
- in North Wales
Reservoirs used for hydro-electric power generation
- in Nevada, USA
- and in Wales, United Kingdom
Reservoirs used for drinking water
- in Bulgaria
Reservoirs used for recreation
- in the state of Washington, USA.
- in Oregon, USA. While this reservoir was originally created for industrial purposes, it is now used for recreation.
- in the state of West Virginia, USA, which services the .
It is recommended that data consumers and renderers continue to support both landuse=reservoir and natural=water + water=reservoir until such time as landuse=reservoir use drops to insignificant levels.
|landuse=reservoir||Mark this tag as deprecated, and add it to Deprecated features|
|Update definitions on their respective wiki pages|
- Dec 2020 [tagging] Quarry lakes
- Dec 2020 [tagging] Feature Proposal - RFC - Reservoirs, lakes, and ponds
- Dec 2020 [tagging] The saga of landuse=reservoir vs water=reservoir - tagging mailing list, 2020 thread
- Nov 2020 [tagging] deprecate water=pond?
- Jul 2020 [tagging] Riverbanks
- Mar 2020 [tagging] Ponds are not observable on the ground
- Nov 2019 Changeset 76766631 discussion (author: pangoSE)
- Jul 2019 [JOSM ticket] Proposal to introduce the same retagging rule into JOSM
- Jun 2019 [talk] iD forces mistagging again
- Jun 2019 [talk-lt] iD redaktoriaus problemos (iD editor problems)
- Jun 2019 [tagging] landuse=reservoir vs water=reservoir
- Jun 2019 [iD github] iD is forcing retaging from landuse=reservoir to natural=water+water=reservoir
- Apr 2019 [talk] iD influencing tagging
- Oct 2018 [talk-it] landuse=reservoir
- Sep 2018 [tagging] My weirdly unnatural aversion to relations
- Jul 2018 [tagging] landuse=basin
- Mar 2017 [tagging] water=pool
- Jun 2016 [talk] Failed water proposal reversal
- Feb 2015 [tagging] How to tag a cistern?
- Jan 2015 [tagging] Adding water=fishpond to the wiki
- Jun 2013 [tagging] When was landuse=reservoir deprecated?
- Jun 2013 [JOSM ticket] Reservoir preset is using a deprecated tag
- Nov 2012 [talk-it] Tag:landuse=reservoir
- May 2012 [talk-lt] Vandens telkiniai (Water bodies)
- Jan 2012 [tagging] Health and other stories
- Sep 2011 [tagging] water=*
- May 2011 [tagging] Requirements for proposals and voting to be valid
- Apr 2011 [tagging] New proposal: water=* (voting announcement)
- Apr 2011 [tagging] New proposal: water=*
- Jan 2008 [talk] RFC - lake
Please comment on the discussion page.