diff --git a/.github/workflows/deploy_prod.yml b/.github/workflows/deploy_prod.yml
index 1532d8e8dc..55e513bc97 100644
--- a/.github/workflows/deploy_prod.yml
+++ b/.github/workflows/deploy_prod.yml
@@ -73,9 +73,8 @@ jobs:
git add *
if git status | grep -q "Changes to be committed"
then
- git commit -am "Deploying a new version"
+ git commit -am "Deploying a new version of mapcomplete"
git push
else
echo "No changes to commit"
fi
-
diff --git a/Docs/BuiltinIndex.md b/Docs/BuiltinIndex.md
index 5cc6210d4b..33cd738c5b 100644
--- a/Docs/BuiltinIndex.md
+++ b/Docs/BuiltinIndex.md
@@ -11,13 +11,14 @@
- [Existing builtin tagrenderings](#existing-builtin-tagrenderings)
+ [images](#images)
+ [luminous_or_lit](#luminous_or_lit)
+ + [reviews](#reviews)
+ + [website](#website)
+ + [phone](#phone)
+ + [email](#email)
+ [wikipedia](#wikipedia)
+ [bench.*bench-questions](#bench*bench-questions)
+ [opening_hours](#opening_hours)
+ [artwork.*artwork-question](#artwork*artwork-question)
- + [website](#website)
- + [phone](#phone)
- + [email](#email)
+ [description](#description)
+ [payment-options](#payment-options)
+ [payment-options-advanced](#payment-options-advanced)
@@ -33,7 +34,6 @@
+ [internet](#internet)
+ [internet-fee](#internet-fee)
+ [internet-ssid](#internet-ssid)
- + [reviews](#reviews)
+ [questions](#questions)
+ [climbing.website](#climbingwebsite)
+ [climbing.fee](#climbingfee)
@@ -58,6 +58,7 @@
+ [minimap](#minimap)
+ [mastodon](#mastodon)
+ [contact](#contact)
+ + [diets](#diets)
+ [etymology.wikipedia-etymology](#etymologywikipedia-etymology)
+ [toilet.relevant-questions](#toiletrelevant-questions)
+ [denominations-notes](#denominations-notes)
@@ -91,6 +92,7 @@
- advertising
- ambulancestation
+ - animal_shelter
- artwork
- atm
- barrier
@@ -134,6 +136,7 @@
- hackerspace
- hotel
- hydrant
+ - ice_cream
- indoors
- information_board
- kerbs
@@ -155,6 +158,7 @@
- rainbow_crossings
- reception_desk
- recycling
+ - route_marker
- shops
- shower
- slow_roads
@@ -191,6 +195,139 @@
+### reviews
+
+
+
+
+
+ - animal_shelter
+ - cafe_pub
+ - dogpark
+ - fitness_centre
+ - food
+ - hackerspace
+ - hotel
+ - pharmacy
+ - shops
+ - veterinary
+
+
+
+
+### website
+
+
+
+
+
+ - animal_shelter
+ - bicycle_library
+ - bicycle_rental
+ - bike_cafe
+ - bike_shop
+ - bike_themed_object
+ - cafe_pub
+ - car_rental
+ - climbing_club
+ - climbing_gym
+ - dentist
+ - doctors
+ - elongated_coin
+ - fitness_centre
+ - food
+ - governments
+ - hackerspace
+ - hotel
+ - kindergarten_childcare
+ - nature_reserve
+ - observation_tower
+ - pharmacy
+ - physiotherapist
+ - playground
+ - recycling
+ - school
+ - shops
+ - sports_centre
+ - tertiary_education
+ - vending_machine
+ - veterinary
+
+
+
+
+### phone
+
+
+
+
+
+ - animal_shelter
+ - bicycle_library
+ - bicycle_rental
+ - bike_cafe
+ - bike_shop
+ - bike_themed_object
+ - cafe_pub
+ - car_rental
+ - climbing_club
+ - climbing_gym
+ - dentist
+ - doctors
+ - fitness_centre
+ - food
+ - governments
+ - hackerspace
+ - hotel
+ - kindergarten_childcare
+ - pharmacy
+ - physiotherapist
+ - recycling
+ - school
+ - shops
+ - sports_centre
+ - tertiary_education
+ - vending_machine
+ - veterinary
+
+
+
+
+### email
+
+
+
+
+
+ - animal_shelter
+ - bicycle_library
+ - bicycle_rental
+ - bike_cafe
+ - bike_shop
+ - bike_themed_object
+ - cafe_pub
+ - car_rental
+ - climbing_club
+ - climbing_gym
+ - dentist
+ - doctors
+ - fitness_centre
+ - food
+ - governments
+ - hackerspace
+ - hotel
+ - kindergarten_childcare
+ - pharmacy
+ - physiotherapist
+ - recycling
+ - school
+ - shops
+ - sports_centre
+ - tertiary_education
+
+
+
+
### wikipedia
@@ -234,6 +371,7 @@
- dentist
- fitness_centre
- food
+ - ice_cream
- kindergarten_childcare
- pharmacy
- postoffices
@@ -259,116 +397,6 @@
-### website
-
-
-
-
-
- - bicycle_library
- - bicycle_rental
- - bike_cafe
- - bike_shop
- - bike_themed_object
- - cafe_pub
- - car_rental
- - climbing_club
- - climbing_gym
- - dentist
- - doctors
- - elongated_coin
- - fitness_centre
- - food
- - governments
- - hackerspace
- - hotel
- - kindergarten_childcare
- - nature_reserve
- - observation_tower
- - pharmacy
- - physiotherapist
- - playground
- - recycling
- - school
- - shops
- - sports_centre
- - tertiary_education
- - vending_machine
- - veterinary
-
-
-
-
-### phone
-
-
-
-
-
- - bicycle_library
- - bicycle_rental
- - bike_cafe
- - bike_shop
- - bike_themed_object
- - cafe_pub
- - car_rental
- - climbing_club
- - climbing_gym
- - dentist
- - doctors
- - fitness_centre
- - food
- - governments
- - hackerspace
- - hotel
- - kindergarten_childcare
- - pharmacy
- - physiotherapist
- - recycling
- - school
- - shops
- - sports_centre
- - tertiary_education
- - vending_machine
- - veterinary
-
-
-
-
-### email
-
-
-
-
-
- - bicycle_library
- - bicycle_rental
- - bike_cafe
- - bike_shop
- - bike_themed_object
- - cafe_pub
- - car_rental
- - climbing_club
- - climbing_gym
- - dentist
- - doctors
- - fitness_centre
- - food
- - governments
- - hackerspace
- - hotel
- - kindergarten_childcare
- - pharmacy
- - physiotherapist
- - recycling
- - school
- - shops
- - sports_centre
- - tertiary_education
-
-
-
-
### description
@@ -395,6 +423,7 @@
- cafe_pub
- climbing_gym
- food
+ - ice_cream
- observation_tower
- questions
- questions
@@ -517,6 +546,7 @@
- food
- hackerspace
- hotel
+ - ice_cream
- observation_tower
- sports_centre
- transit_stops
@@ -604,25 +634,6 @@
-### reviews
-
-
-
-
-
- - cafe_pub
- - dogpark
- - fitness_centre
- - food
- - hackerspace
- - hotel
- - pharmacy
- - shops
- - veterinary
-
-
-
-
### questions
@@ -900,6 +911,18 @@
- hospital
+ - ice_cream
+
+
+
+
+### diets
+
+
+
+
+
+ - ice_cream
diff --git a/Docs/BuiltinLayers.md b/Docs/BuiltinLayers.md
index adbc40ebfb..ae5a72b213 100644
--- a/Docs/BuiltinLayers.md
+++ b/Docs/BuiltinLayers.md
@@ -133,7 +133,7 @@ MapComplete has a few data layers available in the theme which have special prop
-
+
Highlights the currently selected element. Override this layer to have different colors
@@ -176,7 +176,7 @@ Elements must have the all of following tags to be shown on this layer:
-
+
Meta layer showing the current location of the user. Add this to your theme and override the icon to change the appearance of the current location. The object will always have `id=gps` and will have _all_ the properties included in the [`Coordinates`-object](https://developer.mozilla.org/en-US/docs/Web/API/GeolocationCoordinates) (except latitude and longitude) returned by the browser, such as `speed`, `altitude`, `heading`, ....
@@ -219,7 +219,7 @@ Elements must have the all of following tags to be shown on this layer:
-
+
Meta layer which contains the previous locations of the user as single points. This is mainly for technical reasons, e.g. to keep match the distance to the modified object
@@ -264,7 +264,7 @@ Elements must have the all of following tags to be shown on this layer:
-
+
Meta layer showing the home location of the user. The home location can be set in the [profile settings](https://www.openstreetmap.org/profile/edit) of OpenStreetMap.
@@ -512,7 +512,7 @@ Elements must have the all of following tags to be shown on this layer:
-
{renderings}{first_preset}
' height="100px">
+
This layer defines how to render the 'last click'-location. By default, it will show a marker with the possibility to add a new point (if there are some presets) and/or to add a new note (if the 'note' layer attribute is set). If none are possible, this layer won't show up
@@ -641,7 +641,7 @@ action.0 | only_if_action_is_possible | has_note_layer=yes\|has_presets=yes
-
+
If the import-button moves OSM points, the imported way points or conflates, a preview is shown. This layer defines how this preview is rendered. This layer cannot be included in a theme.
@@ -682,7 +682,7 @@ Elements must have the all of following tags to be shown on this layer:
-
+
Layer rendering the little scissors for the minimap in the 'splitRoadWizard'
@@ -723,7 +723,7 @@ Elements must have the all of following tags to be shown on this layer:
-
+
Layer rendering the way to split in the 'splitRoadWizard'. This one is used instead of the variable rendering by the themes themselves, as they might not always be very visible
@@ -871,7 +871,7 @@ This tagrendering has no question and is thus read-only
-
+
Layer used as template in the importHelper
@@ -1417,6 +1417,7 @@ The following layers are included in MapComplete:
- [address](./Layers/address.md)
- [advertising](./Layers/advertising.md)
- [ambulancestation](./Layers/ambulancestation.md)
+ - [animal_shelter](./Layers/animal_shelter.md)
- [artwork](./Layers/artwork.md)
- [atm](./Layers/atm.md)
- [bank](./Layers/bank.md)
@@ -1477,6 +1478,7 @@ The following layers are included in MapComplete:
- [hospital](./Layers/hospital.md)
- [hotel](./Layers/hotel.md)
- [hydrant](./Layers/hydrant.md)
+ - [ice_cream](./Layers/ice_cream.md)
- [icons](./Layers/icons.md)
- [id_presets](./Layers/id_presets.md)
- [import_candidate](./Layers/import_candidate.md)
@@ -1514,6 +1516,7 @@ The following layers are included in MapComplete:
- [range](./Layers/range.md)
- [reception_desk](./Layers/reception_desk.md)
- [recycling](./Layers/recycling.md)
+ - [route_marker](./Layers/route_marker.md)
- [school](./Layers/school.md)
- [selected_element](./Layers/selected_element.md)
- [shelter](./Layers/shelter.md)
diff --git a/Docs/BuiltinQuestions.md b/Docs/BuiltinQuestions.md
index 75fb484541..8a72bf24cc 100644
--- a/Docs/BuiltinQuestions.md
+++ b/Docs/BuiltinQuestions.md
@@ -870,6 +870,8 @@ The question is *Does this shop have a sugar free offering?*
- *This shop has no sugar free offering* corresponds with `diet:sugar_free=no`
+This tagrendering has labels `diets`
+
### lactose_free
@@ -888,6 +890,8 @@ The question is *Does {title()} have a lactose-free offering?*
- *No lactose free offering* corresponds with `diet:lactose_free=no`
+This tagrendering has labels `diets`
+
### gluten_free
@@ -904,6 +908,8 @@ The question is *Does this shop have a gluten free offering?*
- *This shop has a big gluten free offering* corresponds with `diet:gluten_free=yes`
- *This shop has a limited gluten free offering* corresponds with `diet:gluten_free=limited`
- *This shop has no gluten free offering* corresponds with `diet:gluten_free=no`
-
+
+
+This tagrendering has labels `diets`
This document is autogenerated from [assets/layers/questions/questions.json](https://github.com/pietervdvn/MapComplete/blob/develop/assets/layers/questions/questions.json)
diff --git a/Docs/CalculatedTags.md b/Docs/CalculatedTags.md
index 7ffa0d21a1..d23c292044 100644
--- a/Docs/CalculatedTags.md
+++ b/Docs/CalculatedTags.md
@@ -319,7 +319,7 @@ For example to get all objects which overlap or embed from a layer, use `_contai
Also see [enclosingFeatures](#enclosingFeatures) which can be used to get all objects which fully contain this feature
- 0. ...layerIds - one or more layer ids of the layer from which every feature is checked for overlap
+ 0. ...layerIds - one or more layer ids of the layer from which every feature is checked for overlap)
### enclosingFeatures
@@ -329,7 +329,7 @@ Also see [enclosingFeatures](#enclosingFeatures) which can be used to get all ob
The result is a list of features: `{feat: Polygon}[]`
This function will never return the feature itself.
- 0. ...layerIds - one or more layer ids of the layer from which every feature is checked for overlap
+ 0. ...layerIds - one or more layer ids of the layer from which every feature is checked for overlap)
### intersectionsWith
@@ -341,7 +341,7 @@ Returns a `{feat: GeoJson, intersections: [number,number][]}` where `feat` is th
If the current feature is a point, this function will return an empty list.
Points from other layers are ignored - even if the points are parts of the current linestring.
- 0. ...layerIds - one or more layer ids of the layer from which every feature is checked for intersection
+ 0. ...layerIds - one or more layer ids of the layer from which every feature is checked for intersection)
### closest
diff --git a/Docs/Layers/address.md b/Docs/Layers/address.md
index 4fcf609d2b..e3f6ceeb73 100644
--- a/Docs/Layers/address.md
+++ b/Docs/Layers/address.md
@@ -5,7 +5,7 @@
-
+
Addresses
diff --git a/Docs/Layers/advertising.md b/Docs/Layers/advertising.md
index 65cba18312..b7f9e844f8 100644
--- a/Docs/Layers/advertising.md
+++ b/Docs/Layers/advertising.md
@@ -5,7 +5,7 @@
-
+
We will complete data from advertising features with reference, operator and lit
diff --git a/Docs/Layers/all_streets.md b/Docs/Layers/all_streets.md
index f32a27ced3..61edb5228b 100644
--- a/Docs/Layers/all_streets.md
+++ b/Docs/Layers/all_streets.md
@@ -15,6 +15,7 @@ Layer to mark any street as cyclestreet
- This layer is shown at zoomlevel **18** and higher
+ - Not rendered on the map by default. If you want to rendering this on the map, override `mapRenderings`
diff --git a/Docs/Layers/all_vending_machine.md b/Docs/Layers/all_vending_machine.md
index bcbd673804..bf7e6ce66f 100644
--- a/Docs/Layers/all_vending_machine.md
+++ b/Docs/Layers/all_vending_machine.md
@@ -5,7 +5,7 @@
-
+
Layer showing vending machines
@@ -175,7 +175,7 @@ The question is *Which methods of payment are accepted here?*
- Unselecting this answer will add payment:qr_code=no
- *Coins are accepted here* corresponds with `payment:coins=yes`
- Unselecting this answer will add payment:coins=no
- - *Banknotes are accepted here* corresponds with `payment:notes=yes`
+ - *Bank notes are accepted here* corresponds with `payment:notes=yes`
- Unselecting this answer will add payment:notes=no
- *Debit cards are accepted here* corresponds with `payment:debit_cards=yes`
- Unselecting this answer will add payment:debit_cards=no
diff --git a/Docs/Layers/ambulancestation.md b/Docs/Layers/ambulancestation.md
index 493eb314a6..1a2a40e71c 100644
--- a/Docs/Layers/ambulancestation.md
+++ b/Docs/Layers/ambulancestation.md
@@ -5,7 +5,7 @@
-
+
An ambulance station is an area for storage of ambulance vehicles, medical equipment, personal protective equipment, and other medical supplies.
diff --git a/Docs/Layers/animal_shelter.md b/Docs/Layers/animal_shelter.md
new file mode 100644
index 0000000000..6258ac0e66
--- /dev/null
+++ b/Docs/Layers/animal_shelter.md
@@ -0,0 +1,266 @@
+[//]: # (WARNING: this file is automatically generated. Please find the sources at the bottom and edit those sources)
+
+ animal_shelter
+================
+
+
+
+
+
+An animal shelter is a facility where animals in trouble are brought and facility's staff (volunteers or not) feeds them and cares of them, rehabilitating and healing them if necessary. This definition includes kennels for abandoned dogs, catteries for abandoned cats, shelters for other abandoned pets and wildlife recovery centres.
+
+
+
+
+
+
+ - This layer is shown at zoomlevel **0** and higher
+
+
+This is a special layer - data is not sourced from OpenStreetMap
+
+
+
+ Supported attributes
+----------------------
+
+
+
+Warning:
+
+this quick overview is incomplete
+
+
+
+attribute | type | values which are supported by this layer
+----------- | ------ | ------------------------------------------
+[
](https://taginfo.openstreetmap.org/keys/id#values) [id](https://wiki.openstreetmap.org/wiki/Key:id) | Multiple choice |
+[
](https://taginfo.openstreetmap.org/keys/name#values) [name](https://wiki.openstreetmap.org/wiki/Key:name) | [string](../SpecialInputElements.md#string) |
+[
](https://taginfo.openstreetmap.org/keys/website#values) [website](https://wiki.openstreetmap.org/wiki/Key:website) | [url](../SpecialInputElements.md#url) |
+[
](https://taginfo.openstreetmap.org/keys/phone#values) [phone](https://wiki.openstreetmap.org/wiki/Key:phone) | [phone](../SpecialInputElements.md#phone) |
+[
](https://taginfo.openstreetmap.org/keys/email#values) [email](https://wiki.openstreetmap.org/wiki/Key:email) | [email](../SpecialInputElements.md#email) |
+[
](https://taginfo.openstreetmap.org/keys/purpose#values) [purpose](https://wiki.openstreetmap.org/wiki/Key:purpose) | Multiple choice | [adoption](https://wiki.openstreetmap.org/wiki/Tag:purpose%3Dadoption) [sanctuary](https://wiki.openstreetmap.org/wiki/Tag:purpose%3Dsanctuary) [release](https://wiki.openstreetmap.org/wiki/Tag:purpose%3Drelease)
+[
](https://taginfo.openstreetmap.org/keys/opening_hours#values) [opening_hours](https://wiki.openstreetmap.org/wiki/Key:opening_hours) | [opening_hours](../SpecialInputElements.md#opening_hours) |
+
+
+
+
+### just_created
+
+
+
+This element shows a 'thank you' that the contributor has recently created this element
+
+This tagrendering has no question and is thus read-only
+
+
+
+
+
+ - *You just created this element! Thanks for sharing this info with the world and helping people worldwide.* corresponds with `id~.+`
+
+
+This tagrendering is only visible in the popup if the following condition is met: `_backend~.+&_last_edit:passed_time<300&|_version_number=1`
+
+
+
+### images
+
+
+
+This block shows the known images which are linked with the `image`-keys, but also via `mapillary` and `wikidata` and shows the button to upload new images
+
+This tagrendering has no question and is thus read-only
+
+
+
+
+
+### reviews
+
+
+
+Shows the reviews module (including the possibility to leave a review)
+
+This tagrendering has no question and is thus read-only
+
+
+
+
+
+### 2
+
+
+
+The question is *What is the name of this animal shelter?*
+
+This rendering asks information about the property [name](https://wiki.openstreetmap.org/wiki/Key:name)
+
+This is rendered with `This animal shelter is named {name}`
+
+
+
+
+
+### website
+
+
+
+The question is *What is the website of {title()}?*
+
+This rendering asks information about the property [website](https://wiki.openstreetmap.org/wiki/Key:website)
+
+This is rendered with `{website}`
+
+
+
+
+
+ - *{contact:website}* corresponds with `contact:website~.+`
+ - This option cannot be chosen as answer
+
+
+This tagrendering has labels `contact`
+
+
+
+### phone
+
+
+
+The question is *What is the phone number of {title()}?*
+
+This rendering asks information about the property [phone](https://wiki.openstreetmap.org/wiki/Key:phone)
+
+This is rendered with `{phone}`
+
+
+
+
+
+ - *{contact:phone}* corresponds with `contact:phone~.+`
+ - This option cannot be chosen as answer
+
+
+This tagrendering has labels `contact`
+
+
+
+### email
+
+
+
+The question is *What is the email address of {title()}?*
+
+This rendering asks information about the property [email](https://wiki.openstreetmap.org/wiki/Key:email)
+
+This is rendered with `{email}`
+
+
+
+
+
+ - *{contact:email}* corresponds with `contact:email~.+`
+ - This option cannot be chosen as answer
+
+
+This tagrendering has labels `contact`
+
+
+
+### 6
+
+
+
+The question is *What is the purpose of the animal shelter?*
+
+
+
+
+
+ - *Animals are kept here until adopted by a new owner* corresponds with `purpose=adoption`
+ - *Animals are taken care of for the rest of their lives* corresponds with `purpose=sanctuary`
+ - *Injured animals are rehabilitated here until they can be released in nature again * corresponds with `purpose=release`
+
+
+
+
+### 7
+
+
+
+The question is *When is this animal shelter opened?*
+
+This rendering asks information about the property [opening_hours](https://wiki.openstreetmap.org/wiki/Key:opening_hours)
+
+This is rendered with `{opening_hours_table()}`
+
+
+
+
+
+### leftover-questions
+
+
+
+This tagrendering has no question and is thus read-only
+
+
+
+
+
+### minimap
+
+
+
+Shows a small map with the feature. Added by default to every popup
+
+This tagrendering has no question and is thus read-only
+
+
+
+
+
+### move-button
+
+
+
+This tagrendering has no question and is thus read-only
+
+
+
+
+
+### delete-button
+
+
+
+This tagrendering has no question and is thus read-only
+
+
+
+
+
+### last_edit
+
+
+
+Gives some metainfo about the last edit and who did edit it - rendering only
+
+This tagrendering has no question and is thus read-only
+
+
+
+This tagrendering is only visible in the popup if the following condition is met: `_last_edit:contributor~.+&_last_edit:changeset~.+`
+
+
+
+### all-tags
+
+
+
+This tagrendering has no question and is thus read-only
+
+
+
+This document is autogenerated from [assets/layers/animal_shelter/animal_shelter.json](https://github.com/pietervdvn/MapComplete/blob/develop/assets/layers/animal_shelter/animal_shelter.json)
diff --git a/Docs/Layers/artwork.md b/Docs/Layers/artwork.md
index 1763fb0fdb..a3305b91c6 100644
--- a/Docs/Layers/artwork.md
+++ b/Docs/Layers/artwork.md
@@ -5,7 +5,7 @@
-
+
An open map of statues, busts, graffitis and other artwork all over the world
diff --git a/Docs/Layers/atm.md b/Docs/Layers/atm.md
index 31a14538e0..05be8bb76d 100644
--- a/Docs/Layers/atm.md
+++ b/Docs/Layers/atm.md
@@ -5,7 +5,7 @@
-
+
ATMs to withdraw money
diff --git a/Docs/Layers/bank.md b/Docs/Layers/bank.md
index 50ac7d42d3..7c7aace31d 100644
--- a/Docs/Layers/bank.md
+++ b/Docs/Layers/bank.md
@@ -5,7 +5,7 @@
-
+
A financial institution to deposit money
diff --git a/Docs/Layers/banks_with_atm.md b/Docs/Layers/banks_with_atm.md
index a426960d3f..2e84bbf598 100644
--- a/Docs/Layers/banks_with_atm.md
+++ b/Docs/Layers/banks_with_atm.md
@@ -5,7 +5,7 @@
-
+
A financial institution to deposit money
diff --git a/Docs/Layers/barrier.md b/Docs/Layers/barrier.md
index 8fc3407629..53622361db 100644
--- a/Docs/Layers/barrier.md
+++ b/Docs/Layers/barrier.md
@@ -5,7 +5,7 @@
-
+
Obstacles while cycling, such as bollards and cycle barriers
diff --git a/Docs/Layers/bench.md b/Docs/Layers/bench.md
index e9869f60e9..1db6bcca51 100644
--- a/Docs/Layers/bench.md
+++ b/Docs/Layers/bench.md
@@ -5,7 +5,7 @@
-
+
A bench is a wooden, metal, stone, … surface where a human can sit. This layers visualises them and asks a few questions about them.
diff --git a/Docs/Layers/bench_at_pt.md b/Docs/Layers/bench_at_pt.md
index b2ad3bb869..96931184c8 100644
--- a/Docs/Layers/bench_at_pt.md
+++ b/Docs/Layers/bench_at_pt.md
@@ -5,7 +5,7 @@
-
+
A layer showing all public-transport-stops which do have a bench
diff --git a/Docs/Layers/bicycle_library.md b/Docs/Layers/bicycle_library.md
index d926e49a50..112fcfd392 100644
--- a/Docs/Layers/bicycle_library.md
+++ b/Docs/Layers/bicycle_library.md
@@ -5,7 +5,7 @@
-
+
A facility where bicycles can be lent for longer period of times
diff --git a/Docs/Layers/bicycle_rental.md b/Docs/Layers/bicycle_rental.md
index 46e5d474c0..99a5562d1c 100644
--- a/Docs/Layers/bicycle_rental.md
+++ b/Docs/Layers/bicycle_rental.md
@@ -5,7 +5,7 @@
-
+
Bicycle rental stations
diff --git a/Docs/Layers/bicycle_rental_non_docking.md b/Docs/Layers/bicycle_rental_non_docking.md
index c9b127d217..1da8c8824a 100644
--- a/Docs/Layers/bicycle_rental_non_docking.md
+++ b/Docs/Layers/bicycle_rental_non_docking.md
@@ -5,7 +5,7 @@
-
+
Bicycle rental stations
diff --git a/Docs/Layers/bicycle_tube_vending_machine.md b/Docs/Layers/bicycle_tube_vending_machine.md
index 2859ae3448..3075f49852 100644
--- a/Docs/Layers/bicycle_tube_vending_machine.md
+++ b/Docs/Layers/bicycle_tube_vending_machine.md
@@ -5,7 +5,7 @@
-
+
A layer showing vending machines for bicycle tubes (either purpose-built bicycle tube vending machines or classical vending machines with bicycle tubes and optionally additional bicycle related objects such as lights, gloves, locks, …)
diff --git a/Docs/Layers/bike_cafe.md b/Docs/Layers/bike_cafe.md
index 70c2655116..d49dbb77d8 100644
--- a/Docs/Layers/bike_cafe.md
+++ b/Docs/Layers/bike_cafe.md
@@ -5,7 +5,7 @@
-
+
A bike café is a café geared towards cyclists, for example with services such as a pump, with lots of bicycle-related decoration, …
diff --git a/Docs/Layers/bike_cleaning.md b/Docs/Layers/bike_cleaning.md
index 3f0fe2e66a..b560466c07 100644
--- a/Docs/Layers/bike_cleaning.md
+++ b/Docs/Layers/bike_cleaning.md
@@ -5,7 +5,7 @@
-
+
A layer showing facilities where one can clean their bike
diff --git a/Docs/Layers/bike_parking.md b/Docs/Layers/bike_parking.md
index a2c6c332d5..f8e2e8f0eb 100644
--- a/Docs/Layers/bike_parking.md
+++ b/Docs/Layers/bike_parking.md
@@ -5,7 +5,7 @@
-
+
A layer showing where you can park your bike
diff --git a/Docs/Layers/bike_repair_station.md b/Docs/Layers/bike_repair_station.md
index 1c1c2713bc..afd544ece2 100644
--- a/Docs/Layers/bike_repair_station.md
+++ b/Docs/Layers/bike_repair_station.md
@@ -5,7 +5,7 @@
-
+
A layer showing bicycle pumps and bicycle repair tool stands
diff --git a/Docs/Layers/bike_shop.md b/Docs/Layers/bike_shop.md
index 3608947d1d..bbf7b79bb2 100644
--- a/Docs/Layers/bike_shop.md
+++ b/Docs/Layers/bike_shop.md
@@ -5,7 +5,7 @@
-
+
A shop specifically selling bicycles or related items
diff --git a/Docs/Layers/bike_themed_object.md b/Docs/Layers/bike_themed_object.md
index c6588d2263..682acd27ff 100644
--- a/Docs/Layers/bike_themed_object.md
+++ b/Docs/Layers/bike_themed_object.md
@@ -5,7 +5,7 @@
-
+
A layer with bike-themed objects but who don't match any other layer
diff --git a/Docs/Layers/binocular.md b/Docs/Layers/binocular.md
index dbfa085bfd..bc53537c00 100644
--- a/Docs/Layers/binocular.md
+++ b/Docs/Layers/binocular.md
@@ -5,7 +5,7 @@
-
+
Binoculars
diff --git a/Docs/Layers/birdhide.md b/Docs/Layers/birdhide.md
index b1bb1be288..f6c40ec95b 100644
--- a/Docs/Layers/birdhide.md
+++ b/Docs/Layers/birdhide.md
@@ -5,7 +5,7 @@
-
+
A birdhide
diff --git a/Docs/Layers/cafe_pub.md b/Docs/Layers/cafe_pub.md
index 4e78bc0086..a82a76ab4d 100644
--- a/Docs/Layers/cafe_pub.md
+++ b/Docs/Layers/cafe_pub.md
@@ -5,7 +5,7 @@
-
+
A layer showing cafés and pubs where one can gather around a drink. The layer asks for some relevant questions
diff --git a/Docs/Layers/car_rental.md b/Docs/Layers/car_rental.md
index 178aaeb937..ab2072c23a 100644
--- a/Docs/Layers/car_rental.md
+++ b/Docs/Layers/car_rental.md
@@ -5,7 +5,7 @@
-
+
Places where you can rent a car
diff --git a/Docs/Layers/caravansites.md b/Docs/Layers/caravansites.md
index 0b19a91c4f..1ac600f979 100644
--- a/Docs/Layers/caravansites.md
+++ b/Docs/Layers/caravansites.md
@@ -5,7 +5,7 @@
-
+
camper sites
@@ -15,6 +15,7 @@ camper sites
- This layer is shown at zoomlevel **10** and higher
+ - Not rendered on the map by default. If you want to rendering this on the map, override `mapRenderings`
diff --git a/Docs/Layers/charging_station.md b/Docs/Layers/charging_station.md
index 100e02f9bb..9cf3465cd5 100644
--- a/Docs/Layers/charging_station.md
+++ b/Docs/Layers/charging_station.md
@@ -5,7 +5,7 @@
-
+
A charging station
@@ -206,7 +206,7 @@ This is rendered with `Access is {access}`
- This option cannot be chosen as answer
- *Only customers of the place this station belongs to can use this charging station
E.g. a charging station operated by hotel which is only usable by their guests* corresponds with `access=customers`
- *A key must be requested to access this charging station
E.g. a charging station operated by hotel which is only usable by their guests, which receive a key from the reception to unlock the charging station* corresponds with `access=key`
- - *Not accessible to the general public (e.g. only accessible to the owners, employees, …)* corresponds with `access=private`
+ - *Not accessible to the general public (e.g. only accessible to the owners, employees, ...)* corresponds with `access=private`
- *This charging station is accessible to the public during certain hours or conditions. Restrictions might apply, but general use is allowed.* corresponds with `access=permissive`
@@ -620,7 +620,7 @@ This is rendered with `Schuko wall plu
- - *Schuko wall plug without ground pin (CEE7/4 type F) outputs at most 3.6 kw A* corresponds with `socket:schuko:output=3.6 kW`
+ - *Schuko wall plug without ground pin (CEE7/4 type F) outputs at most 3.6 kW A* corresponds with `socket:schuko:output=3.6 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:schuko~.+&socket:schuko!=0`
@@ -689,8 +689,8 @@ This is rendered with `European wall p
- - *European wall plug with ground pin (CEE7/4 type E) outputs at most 3 kw A* corresponds with `socket:typee:output=3 kW`
- - *European wall plug with ground pin (CEE7/4 type E) outputs at most 22 kw A* corresponds with `socket:typee:output=22 kW`
+ - *European wall plug with ground pin (CEE7/4 type E) outputs at most 3 kW A* corresponds with `socket:typee:output=3 kW`
+ - *European wall plug with ground pin (CEE7/4 type E) outputs at most 22 kW A* corresponds with `socket:typee:output=22 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:typee~.+&socket:typee!=0`
@@ -759,7 +759,7 @@ This is rendered with `Chademo
- - *
Chademo outputs at most 50 kw A* corresponds with `socket:chademo:output=50 kW`
+ - *
Chademo outputs at most 50 kW A* corresponds with `socket:chademo:output=50 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:chademo~.+&socket:chademo!=0`
@@ -829,8 +829,8 @@ This is rendered with `
Type 1 with cab
- - *Type 1 with cable (J1772) outputs at most 3.7 kw A* corresponds with `socket:type1_cable:output=3.7 kW`
- - *Type 1 with cable (J1772) outputs at most 7 kw A* corresponds with `socket:type1_cable:output=7 kW`
+ - *Type 1 with cable (J1772) outputs at most 3.7 kW A* corresponds with `socket:type1_cable:output=3.7 kW`
+ - *Type 1 with cable (J1772) outputs at most 7 kW A* corresponds with `socket:type1_cable:output=7 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:type1_cable~.+&socket:type1_cable!=0`
@@ -900,10 +900,10 @@ This is rendered with `Type 1 witho
- - *Type 1 without cable (J1772) outputs at most 3.7 kw A* corresponds with `socket:type1:output=3.7 kW`
- - *Type 1 without cable (J1772) outputs at most 6.6 kw A* corresponds with `socket:type1:output=6.6 kW`
- - *Type 1 without cable (J1772) outputs at most 7 kw A* corresponds with `socket:type1:output=7 kW`
- - *Type 1 without cable (J1772) outputs at most 7.2 kw A* corresponds with `socket:type1:output=7.2 kW`
+ - *Type 1 without cable (J1772) outputs at most 3.7 kW A* corresponds with `socket:type1:output=3.7 kW`
+ - *Type 1 without cable (J1772) outputs at most 6.6 kW A* corresponds with `socket:type1:output=6.6 kW`
+ - *Type 1 without cable (J1772) outputs at most 7 kW A* corresponds with `socket:type1:output=7 kW`
+ - *Type 1 without cable (J1772) outputs at most 7.2 kW A* corresponds with `socket:type1:output=7.2 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:type1~.+&socket:type1!=0`
@@ -974,10 +974,10 @@ This is rendered with `Type 1 CCS
- - *Type 1 CCS (aka Type 1 Combo) outputs at most 50 kw A* corresponds with `socket:type1_combo:output=50 kW`
- - *Type 1 CCS (aka Type 1 Combo) outputs at most 62.5 kw A* corresponds with `socket:type1_combo:output=62.5 kW`
- - *Type 1 CCS (aka Type 1 Combo) outputs at most 150 kw A* corresponds with `socket:type1_combo:output=150 kW`
- - *Type 1 CCS (aka Type 1 Combo) outputs at most 350 kw A* corresponds with `socket:type1_combo:output=350 kW`
+ - *Type 1 CCS (aka Type 1 Combo) outputs at most 50 kW A* corresponds with `socket:type1_combo:output=50 kW`
+ - *Type 1 CCS (aka Type 1 Combo) outputs at most 62.5 kW A* corresponds with `socket:type1_combo:output=62.5 kW`
+ - *Type 1 CCS (aka Type 1 Combo) outputs at most 150 kW A* corresponds with `socket:type1_combo:output=150 kW`
+ - *Type 1 CCS (aka Type 1 Combo) outputs at most 350 kW A* corresponds with `socket:type1_combo:output=350 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:type1_combo~.+&socket:type1_combo!=0`
@@ -1047,9 +1047,9 @@ This is rendered with `Tesla Superchar
- - *Tesla Supercharger outputs at most 120 kw A* corresponds with `socket:tesla_supercharger:output=120 kW`
- - *Tesla Supercharger outputs at most 150 kw A* corresponds with `socket:tesla_supercharger:output=150 kW`
- - *Tesla Supercharger outputs at most 250 kw A* corresponds with `socket:tesla_supercharger:output=250 kW`
+ - *Tesla Supercharger outputs at most 120 kW A* corresponds with `socket:tesla_supercharger:output=120 kW`
+ - *Tesla Supercharger outputs at most 150 kW A* corresponds with `socket:tesla_supercharger:output=150 kW`
+ - *Tesla Supercharger outputs at most 250 kW A* corresponds with `socket:tesla_supercharger:output=250 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:tesla_supercharger~.+&socket:tesla_supercharger!=0`
@@ -1120,8 +1120,8 @@ This is rendered with `Type 2 (men
- - *Type 2 (mennekes) outputs at most 11 kw A* corresponds with `socket:type2:output=11 kW`
- - *Type 2 (mennekes) outputs at most 22 kw A* corresponds with `socket:type2:output=22 kW`
+ - *Type 2 (mennekes) outputs at most 11 kW A* corresponds with `socket:type2:output=11 kW`
+ - *Type 2 (mennekes) outputs at most 22 kW A* corresponds with `socket:type2:output=22 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:type2~.+&socket:type2!=0`
@@ -1192,7 +1192,7 @@ This is rendered with `Type 2 CCS
- - *Type 2 CCS (mennekes) outputs at most 50 kw A* corresponds with `socket:type2_combo:output=50 kW`
+ - *Type 2 CCS (mennekes) outputs at most 50 kW A* corresponds with `socket:type2_combo:output=50 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:type2_combo~.+&socket:type2_combo!=0`
@@ -1263,8 +1263,8 @@ This is rendered with `Type 2 with cab
- - *Type 2 with cable (mennekes) outputs at most 11 kw A* corresponds with `socket:type2_cable:output=11 kW`
- - *Type 2 with cable (mennekes) outputs at most 22 kw A* corresponds with `socket:type2_cable:output=22 kW`
+ - *Type 2 with cable (mennekes) outputs at most 11 kW A* corresponds with `socket:type2_cable:output=11 kW`
+ - *Type 2 with cable (mennekes) outputs at most 22 kW A* corresponds with `socket:type2_cable:output=22 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:type2_cable~.+&socket:type2_cable!=0`
@@ -1277,18 +1277,18 @@ This tagrendering has labels `technical`
-The question is *What voltage do the plugs with Tesla Supercharger CCS (a branded Type 2 CSS) 
offer?*
+The question is *What voltage do the plugs with Tesla Supercharger CCS (a branded type2_css) 
offer?*
This rendering asks information about the property [socket:tesla_supercharger_ccs:voltage](https://wiki.openstreetmap.org/wiki/Key:socket:tesla_supercharger_ccs:voltage)
-This is rendered with `Tesla Supercharger CCS (a branded Type 2 CSS) 
outputs {socket:tesla_supercharger_ccs:voltage} volt`
+This is rendered with `Tesla Supercharger CCS (a branded type2_css) 
outputs {socket:tesla_supercharger_ccs:voltage} volt`
- - *Tesla Supercharger CCS (a branded Type 2 CSS) outputs 500 volt* corresponds with `socket:tesla_supercharger_ccs:voltage=500 V`
- - *Tesla Supercharger CCS (a branded Type 2 CSS) outputs 920 volt* corresponds with `socket:tesla_supercharger_ccs:voltage=920 V`
+ - *Tesla Supercharger CCS (a branded type2_css) outputs 500 volt* corresponds with `socket:tesla_supercharger_ccs:voltage=500 V`
+ - *Tesla Supercharger CCS (a branded type2_css) outputs 920 volt* corresponds with `socket:tesla_supercharger_ccs:voltage=920 V`
This tagrendering is only visible in the popup if the following condition is met: `socket:tesla_supercharger_ccs~.+&socket:tesla_supercharger_ccs!=0`
@@ -1325,17 +1325,17 @@ This tagrendering has labels `technical`
-The question is *What power output does a single plug of type Tesla Supercharger CCS (a branded Type 2 CSS) 
offer?*
+The question is *What power output does a single plug of type Tesla Supercharger CCS (a branded type2_css) 
offer?*
This rendering asks information about the property [socket:tesla_supercharger_ccs:output](https://wiki.openstreetmap.org/wiki/Key:socket:tesla_supercharger_ccs:output)
-This is rendered with `Tesla Supercharger CCS (a branded Type 2 CSS) 
outputs at most {socket:tesla_supercharger_ccs:output}`
+This is rendered with `Tesla Supercharger CCS (a branded type2_css) 
outputs at most {socket:tesla_supercharger_ccs:output}`
- - *Tesla Supercharger CCS (a branded Type 2 CSS) outputs at most 50 kw A* corresponds with `socket:tesla_supercharger_ccs:output=50 kW`
+ - *Tesla Supercharger CCS (a branded type2_css) outputs at most 50 kW A* corresponds with `socket:tesla_supercharger_ccs:output=50 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:tesla_supercharger_ccs~.+&socket:tesla_supercharger_ccs!=0`
@@ -1348,17 +1348,17 @@ This tagrendering has labels `technical`
-The question is *What voltage do the plugs with Tesla Supercharger (Destination) 
offer?*
+The question is *What voltage do the plugs with Tesla Supercharger (destination) 
offer?*
This rendering asks information about the property [socket:tesla_destination:voltage](https://wiki.openstreetmap.org/wiki/Key:socket:tesla_destination:voltage)
-This is rendered with `Tesla Supercharger (Destination) 
outputs {socket:tesla_destination:voltage} volt`
+This is rendered with `Tesla Supercharger (destination) 
outputs {socket:tesla_destination:voltage} volt`
- - *Tesla Supercharger (Destination) outputs 480 volt* corresponds with `socket:tesla_destination:voltage=480 V`
+ - *Tesla Supercharger (destination) outputs 480 volt* corresponds with `socket:tesla_destination:voltage=480 V`
This tagrendering is only visible in the popup if the following condition is met: `socket:tesla_destination~.+&socket:tesla_destination!=0`
@@ -1371,18 +1371,18 @@ This tagrendering has labels `technical`
-The question is *What current do the plugs with Tesla Supercharger (Destination) 
offer?*
+The question is *What current do the plugs with Tesla Supercharger (destination) 
offer?*
This rendering asks information about the property [socket:tesla_destination:current](https://wiki.openstreetmap.org/wiki/Key:socket:tesla_destination:current)
-This is rendered with `Tesla Supercharger (Destination) 
outputs at most {socket:tesla_destination:current}A`
+This is rendered with `Tesla Supercharger (destination) 
outputs at most {socket:tesla_destination:current}A`
- - *Tesla Supercharger (Destination) outputs at most 125 A* corresponds with `socket:tesla_destination:current=125 A`
- - *Tesla Supercharger (Destination) outputs at most 350 A* corresponds with `socket:tesla_destination:current=350 A`
+ - *Tesla Supercharger (destination) outputs at most 125 A* corresponds with `socket:tesla_destination:current=125 A`
+ - *Tesla Supercharger (destination) outputs at most 350 A* corresponds with `socket:tesla_destination:current=350 A`
This tagrendering is only visible in the popup if the following condition is met: `socket:tesla_destination~.+&socket:tesla_destination!=0`
@@ -1395,19 +1395,19 @@ This tagrendering has labels `technical`
-The question is *What power output does a single plug of type Tesla Supercharger (Destination) 
offer?*
+The question is *What power output does a single plug of type Tesla Supercharger (destination) 
offer?*
This rendering asks information about the property [socket:tesla_destination:output](https://wiki.openstreetmap.org/wiki/Key:socket:tesla_destination:output)
-This is rendered with `Tesla Supercharger (Destination) 
outputs at most {socket:tesla_destination:output}`
+This is rendered with `Tesla Supercharger (destination) 
outputs at most {socket:tesla_destination:output}`
- - *Tesla Supercharger (Destination) outputs at most 120 kw A* corresponds with `socket:tesla_destination:output=120 kW`
- - *Tesla Supercharger (Destination) outputs at most 150 kw A* corresponds with `socket:tesla_destination:output=150 kW`
- - *Tesla Supercharger (Destination) outputs at most 250 kw A* corresponds with `socket:tesla_destination:output=250 kW`
+ - *Tesla Supercharger (destination) outputs at most 120 kW A* corresponds with `socket:tesla_destination:output=120 kW`
+ - *Tesla Supercharger (destination) outputs at most 150 kW A* corresponds with `socket:tesla_destination:output=150 kW`
+ - *Tesla Supercharger (destination) outputs at most 250 kW A* corresponds with `socket:tesla_destination:output=250 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:tesla_destination~.+&socket:tesla_destination!=0`
@@ -1420,7 +1420,7 @@ This tagrendering has labels `technical`
-The question is *What voltage do the plugs with Tesla Supercharger (Destination) (A Type 2 with cable branded as Tesla) 
offer?*
+The question is *What voltage do the plugs with Tesla supercharger (destination) (A Type 2 with cable branded as tesla) 
offer?*
This rendering asks information about the property [socket:tesla_destination:voltage](https://wiki.openstreetmap.org/wiki/Key:socket:tesla_destination:voltage)
@@ -1430,8 +1430,8 @@ This is rendered with `Tesla superchar
- - *Tesla Supercharger (Destination) (A Type 2 with cable branded as Tesla) outputs 230 volt* corresponds with `socket:tesla_destination:voltage=230 V`
- - *Tesla Supercharger (Destination) (A Type 2 with cable branded as Tesla) outputs 400 volt* corresponds with `socket:tesla_destination:voltage=400 V`
+ - *Tesla supercharger (destination) (A Type 2 with cable branded as tesla) outputs 230 volt* corresponds with `socket:tesla_destination:voltage=230 V`
+ - *Tesla supercharger (destination) (A Type 2 with cable branded as tesla) outputs 400 volt* corresponds with `socket:tesla_destination:voltage=400 V`
This tagrendering is only visible in the popup if the following condition is met: `socket:tesla_destination~.+&socket:tesla_destination!=0`
@@ -1444,18 +1444,18 @@ This tagrendering has labels `technical`
-The question is *What current do the plugs with Tesla Supercharger (Destination) (A Type 2 with cable branded as Tesla) 
offer?*
+The question is *What current do the plugs with Tesla supercharger (destination) (A Type 2 with cable branded as tesla) 
offer?*
This rendering asks information about the property [socket:tesla_destination:current](https://wiki.openstreetmap.org/wiki/Key:socket:tesla_destination:current)
-This is rendered with `Tesla Supercharger (Destination) (A Type 2 with cable branded as Tesla) 
outputs at most {socket:tesla_destination:current}A`
+This is rendered with `Tesla supercharger (destination) (A Type 2 with cable branded as tesla) 
outputs at most {socket:tesla_destination:current}A`
- - *Tesla Supercharger (Destination) (A Type 2 with cable branded as tesla) outputs at most 16 A* corresponds with `socket:tesla_destination:current=16 A`
- - *Tesla Supercharger (Destination) (A Type 2 with cable branded as Tesla) outputs at most 32 A* corresponds with `socket:tesla_destination:current=32 A`
+ - *Tesla supercharger (destination) (A Type 2 with cable branded as tesla) outputs at most 16 A* corresponds with `socket:tesla_destination:current=16 A`
+ - *Tesla supercharger (destination) (A Type 2 with cable branded as tesla) outputs at most 32 A* corresponds with `socket:tesla_destination:current=32 A`
This tagrendering is only visible in the popup if the following condition is met: `socket:tesla_destination~.+&socket:tesla_destination!=0`
@@ -1468,18 +1468,18 @@ This tagrendering has labels `technical`
-The question is *What power output does a single plug of type Tesla Supercharger (Destination) (A Type 2 with cable branded as Tesla) 
offer?*
+The question is *What power output does a single plug of type Tesla supercharger (destination) (A Type 2 with cable branded as tesla) 
offer?*
This rendering asks information about the property [socket:tesla_destination:output](https://wiki.openstreetmap.org/wiki/Key:socket:tesla_destination:output)
-This is rendered with `Tesla Supercharger (Destination) (A Type 2 with cable branded as Tesla) 
outputs at most {socket:tesla_destination:output}`
+This is rendered with `Tesla supercharger (destination) (A Type 2 with cable branded as tesla) 
outputs at most {socket:tesla_destination:output}`
- - *Tesla Supercharger (Destination) (A Type 2 with cable branded as Tesla) outputs at most 11 kw A* corresponds with `socket:tesla_destination:output=11 kW`
- - *Tesla Supercharger (Destination) (A Type 2 with cable branded as Tesla) outputs at most 22 kw A* corresponds with `socket:tesla_destination:output=22 kW`
+ - *Tesla supercharger (destination) (A Type 2 with cable branded as tesla) outputs at most 11 kW A* corresponds with `socket:tesla_destination:output=11 kW`
+ - *Tesla supercharger (destination) (A Type 2 with cable branded as tesla) outputs at most 22 kW A* corresponds with `socket:tesla_destination:output=22 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:tesla_destination~.+&socket:tesla_destination!=0`
@@ -1549,8 +1549,8 @@ This is rendered with `USB to char
- - *USB to charge phones and small electronics outputs at most 5w A* corresponds with `socket:USB-A:output=5W`
- - *USB to charge phones and small electronics outputs at most 10w A* corresponds with `socket:USB-A:output=10W`
+ - *USB to charge phones and small electronics outputs at most 5W A* corresponds with `socket:USB-A:output=5W`
+ - *USB to charge phones and small electronics outputs at most 10W A* corresponds with `socket:USB-A:output=10W`
This tagrendering is only visible in the popup if the following condition is met: `socket:USB-A~.+&socket:USB-A!=0`
@@ -1730,7 +1730,7 @@ The question is *Does one have to pay to use this charging station?*
- *Free to use, but one has to authenticate* corresponds with `fee=no&authentication:none=no`
- *Free to use* corresponds with `fee=no`
- This option cannot be chosen as answer
- - *Paid use, but free for customers of the hotel/pub/hospital/… who operates the charging station* corresponds with `fee=yes&fee:conditional=no @ customers`
+ - *Paid use, but free for customers of the hotel/pub/hospital/... who operates the charging station* corresponds with `fee=yes&fee:conditional=no @ customers`
- *Paid use* corresponds with `fee=yes`
@@ -2132,15 +2132,15 @@ connection_type.1 | Has a Schuko wall p
connection_type.2 | Has a European wall plug with ground pin (CEE7/4 type E) 
connector | socket:typee~.+
connection_type.3 | Has a Chademo 
connector | socket:chademo~.+
connection_type.4 | Has a Type 1 with cable (J1772) 
connector | socket:type1_cable~.+
-connection_type.5 | Has a Type 1 without cable (J1772) 
connector | socket:type1~.+
-connection_type.6 | Has a Type 1 CCS (aka Type 1 Combo) 
connector | socket:type1_combo~.+
+connection_type.5 | Has a Type 1 without cable (J1772) 
connector | socket:type1~.+
+connection_type.6 | Has a Type 1 CCS (aka Type 1 Combo) 
connector | socket:type1_combo~.+
connection_type.7 | Has a Tesla Supercharger 
connector | socket:tesla_supercharger~.+
connection_type.8 | Has a Type 2 (mennekes) 
connector | socket:type2~.+
connection_type.9 | Has a Type 2 CCS (mennekes) 
connector | socket:type2_combo~.+
connection_type.10 | Has a Type 2 with cable (mennekes) 
connector | socket:type2_cable~.+
connection_type.11 | Has a Tesla Supercharger CCS (a branded type2_css) 
connector | socket:tesla_supercharger_ccs~.+
connection_type.12 | Has a Tesla Supercharger (destination) 
connector | socket:tesla_destination~.+
-connection_type.13 | Has a Tesla Supercharger (Destination) (A Type 2 with cable branded as tesla) 
connector | socket:tesla_destination~.+
+connection_type.13 | Has a Tesla supercharger (destination) (A Type 2 with cable branded as tesla) 
connector | socket:tesla_destination~.+
connection_type.14 | Has a USB to charge phones and small electronics 
connector | socket:USB-A~.+
connection_type.15 | Has a Bosch Active Connect with 3 pins and cable 
connector | socket:bosch_3pin~.+
connection_type.16 | Has a Bosch Active Connect with 5 pins and cable 
connector | socket:bosch_5pin~.+
diff --git a/Docs/Layers/charging_station_ebikes.md b/Docs/Layers/charging_station_ebikes.md
index 98e83f35e6..e09d73cb7e 100644
--- a/Docs/Layers/charging_station_ebikes.md
+++ b/Docs/Layers/charging_station_ebikes.md
@@ -5,7 +5,7 @@
-
+
A charging station
@@ -204,7 +204,7 @@ This is rendered with `Access is {access}`
- This option cannot be chosen as answer
- *Only customers of the place this station belongs to can use this charging station
E.g. a charging station operated by hotel which is only usable by their guests* corresponds with `access=customers`
- *A key must be requested to access this charging station
E.g. a charging station operated by hotel which is only usable by their guests, which receive a key from the reception to unlock the charging station* corresponds with `access=key`
- - *Not accessible to the general public (e.g. only accessible to the owners, employees, …)* corresponds with `access=private`
+ - *Not accessible to the general public (e.g. only accessible to the owners, employees, ...)* corresponds with `access=private`
- *This charging station is accessible to the public during certain hours or conditions. Restrictions might apply, but general use is allowed.* corresponds with `access=permissive`
@@ -618,7 +618,7 @@ This is rendered with `Schuko wall plu
- - *Schuko wall plug without ground pin (CEE7/4 type F) outputs at most 3.6 kw A* corresponds with `socket:schuko:output=3.6 kW`
+ - *Schuko wall plug without ground pin (CEE7/4 type F) outputs at most 3.6 kW A* corresponds with `socket:schuko:output=3.6 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:schuko~.+&socket:schuko!=0`
@@ -687,8 +687,8 @@ This is rendered with `European wall p
- - *European wall plug with ground pin (CEE7/4 type E) outputs at most 3 kw A* corresponds with `socket:typee:output=3 kW`
- - *European wall plug with ground pin (CEE7/4 type E) outputs at most 22 kw A* corresponds with `socket:typee:output=22 kW`
+ - *European wall plug with ground pin (CEE7/4 type E) outputs at most 3 kW A* corresponds with `socket:typee:output=3 kW`
+ - *European wall plug with ground pin (CEE7/4 type E) outputs at most 22 kW A* corresponds with `socket:typee:output=22 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:typee~.+&socket:typee!=0`
@@ -757,7 +757,7 @@ This is rendered with `Chademo
- - *
Chademo outputs at most 50 kw A* corresponds with `socket:chademo:output=50 kW`
+ - *
Chademo outputs at most 50 kW A* corresponds with `socket:chademo:output=50 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:chademo~.+&socket:chademo!=0`
@@ -827,8 +827,8 @@ This is rendered with `
Type 1 with cab
- - *Type 1 with cable (J1772) outputs at most 3.7 kw A* corresponds with `socket:type1_cable:output=3.7 kW`
- - *Type 1 with cable (J1772) outputs at most 7 kw A* corresponds with `socket:type1_cable:output=7 kW`
+ - *Type 1 with cable (J1772) outputs at most 3.7 kW A* corresponds with `socket:type1_cable:output=3.7 kW`
+ - *Type 1 with cable (J1772) outputs at most 7 kW A* corresponds with `socket:type1_cable:output=7 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:type1_cable~.+&socket:type1_cable!=0`
@@ -898,10 +898,10 @@ This is rendered with `Type 1 witho
- - *Type 1 without cable (J1772) outputs at most 3.7 kw A* corresponds with `socket:type1:output=3.7 kW`
- - *Type 1 without cable (J1772) outputs at most 6.6 kw A* corresponds with `socket:type1:output=6.6 kW`
- - *Type 1 without cable (J1772) outputs at most 7 kw A* corresponds with `socket:type1:output=7 kW`
- - *Type 1 without cable (J1772) outputs at most 7.2 kw A* corresponds with `socket:type1:output=7.2 kW`
+ - *Type 1 without cable (J1772) outputs at most 3.7 kW A* corresponds with `socket:type1:output=3.7 kW`
+ - *Type 1 without cable (J1772) outputs at most 6.6 kW A* corresponds with `socket:type1:output=6.6 kW`
+ - *Type 1 without cable (J1772) outputs at most 7 kW A* corresponds with `socket:type1:output=7 kW`
+ - *Type 1 without cable (J1772) outputs at most 7.2 kW A* corresponds with `socket:type1:output=7.2 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:type1~.+&socket:type1!=0`
@@ -972,10 +972,10 @@ This is rendered with `Type 1 CCS
- - *Type 1 CCS (aka Type 1 Combo) outputs at most 50 kw A* corresponds with `socket:type1_combo:output=50 kW`
- - *Type 1 CCS (aka Type 1 Combo) outputs at most 62.5 kw A* corresponds with `socket:type1_combo:output=62.5 kW`
- - *Type 1 CCS (aka Type 1 Combo) outputs at most 150 kw A* corresponds with `socket:type1_combo:output=150 kW`
- - *Type 1 CCS (aka Type 1 Combo) outputs at most 350 kw A* corresponds with `socket:type1_combo:output=350 kW`
+ - *Type 1 CCS (aka Type 1 Combo) outputs at most 50 kW A* corresponds with `socket:type1_combo:output=50 kW`
+ - *Type 1 CCS (aka Type 1 Combo) outputs at most 62.5 kW A* corresponds with `socket:type1_combo:output=62.5 kW`
+ - *Type 1 CCS (aka Type 1 Combo) outputs at most 150 kW A* corresponds with `socket:type1_combo:output=150 kW`
+ - *Type 1 CCS (aka Type 1 Combo) outputs at most 350 kW A* corresponds with `socket:type1_combo:output=350 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:type1_combo~.+&socket:type1_combo!=0`
@@ -1045,9 +1045,9 @@ This is rendered with `Tesla Superchar
- - *Tesla Supercharger outputs at most 120 kw A* corresponds with `socket:tesla_supercharger:output=120 kW`
- - *Tesla Supercharger outputs at most 150 kw A* corresponds with `socket:tesla_supercharger:output=150 kW`
- - *Tesla Supercharger outputs at most 250 kw A* corresponds with `socket:tesla_supercharger:output=250 kW`
+ - *Tesla Supercharger outputs at most 120 kW A* corresponds with `socket:tesla_supercharger:output=120 kW`
+ - *Tesla Supercharger outputs at most 150 kW A* corresponds with `socket:tesla_supercharger:output=150 kW`
+ - *Tesla Supercharger outputs at most 250 kW A* corresponds with `socket:tesla_supercharger:output=250 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:tesla_supercharger~.+&socket:tesla_supercharger!=0`
@@ -1118,8 +1118,8 @@ This is rendered with `Type 2 (men
- - *Type 2 (mennekes) outputs at most 11 kw A* corresponds with `socket:type2:output=11 kW`
- - *Type 2 (mennekes) outputs at most 22 kw A* corresponds with `socket:type2:output=22 kW`
+ - *Type 2 (mennekes) outputs at most 11 kW A* corresponds with `socket:type2:output=11 kW`
+ - *Type 2 (mennekes) outputs at most 22 kW A* corresponds with `socket:type2:output=22 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:type2~.+&socket:type2!=0`
@@ -1190,7 +1190,7 @@ This is rendered with `Type 2 CCS
- - *Type 2 CCS (mennekes) outputs at most 50 kw A* corresponds with `socket:type2_combo:output=50 kW`
+ - *Type 2 CCS (mennekes) outputs at most 50 kW A* corresponds with `socket:type2_combo:output=50 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:type2_combo~.+&socket:type2_combo!=0`
@@ -1261,8 +1261,8 @@ This is rendered with `Type 2 with cab
- - *Type 2 with cable (mennekes) outputs at most 11 kw A* corresponds with `socket:type2_cable:output=11 kW`
- - *Type 2 with cable (mennekes) outputs at most 22 kw A* corresponds with `socket:type2_cable:output=22 kW`
+ - *Type 2 with cable (mennekes) outputs at most 11 kW A* corresponds with `socket:type2_cable:output=11 kW`
+ - *Type 2 with cable (mennekes) outputs at most 22 kW A* corresponds with `socket:type2_cable:output=22 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:type2_cable~.+&socket:type2_cable!=0`
@@ -1275,18 +1275,18 @@ This tagrendering has labels `technical`
-The question is *What voltage do the plugs with Tesla Supercharger CCS (a branded Type 2 CSS) 
offer?*
+The question is *What voltage do the plugs with Tesla Supercharger CCS (a branded type2_css) 
offer?*
This rendering asks information about the property [socket:tesla_supercharger_ccs:voltage](https://wiki.openstreetmap.org/wiki/Key:socket:tesla_supercharger_ccs:voltage)
-This is rendered with `Tesla Supercharger CCS (a branded Type 2 CSS) 
outputs {socket:tesla_supercharger_ccs:voltage} volt`
+This is rendered with `Tesla Supercharger CCS (a branded type2_css) 
outputs {socket:tesla_supercharger_ccs:voltage} volt`
- - *Tesla Supercharger CCS (a branded Type 2 CSS) outputs 500 volt* corresponds with `socket:tesla_supercharger_ccs:voltage=500 V`
- - *Tesla Supercharger CCS (a branded Type 2 CSS) outputs 920 volt* corresponds with `socket:tesla_supercharger_ccs:voltage=920 V`
+ - *Tesla Supercharger CCS (a branded type2_css) outputs 500 volt* corresponds with `socket:tesla_supercharger_ccs:voltage=500 V`
+ - *Tesla Supercharger CCS (a branded type2_css) outputs 920 volt* corresponds with `socket:tesla_supercharger_ccs:voltage=920 V`
This tagrendering is only visible in the popup if the following condition is met: `socket:tesla_supercharger_ccs~.+&socket:tesla_supercharger_ccs!=0`
@@ -1323,17 +1323,17 @@ This tagrendering has labels `technical`
-The question is *What power output does a single plug of type Tesla Supercharger CCS (a branded Type 2 CSS) 
offer?*
+The question is *What power output does a single plug of type Tesla Supercharger CCS (a branded type2_css) 
offer?*
This rendering asks information about the property [socket:tesla_supercharger_ccs:output](https://wiki.openstreetmap.org/wiki/Key:socket:tesla_supercharger_ccs:output)
-This is rendered with `Tesla Supercharger CCS (a branded Type 2 CSS) 
outputs at most {socket:tesla_supercharger_ccs:output}`
+This is rendered with `Tesla Supercharger CCS (a branded type2_css) 
outputs at most {socket:tesla_supercharger_ccs:output}`
- - *Tesla Supercharger CCS (a branded Type 2 CSS) outputs at most 50 kw A* corresponds with `socket:tesla_supercharger_ccs:output=50 kW`
+ - *Tesla Supercharger CCS (a branded type2_css) outputs at most 50 kW A* corresponds with `socket:tesla_supercharger_ccs:output=50 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:tesla_supercharger_ccs~.+&socket:tesla_supercharger_ccs!=0`
@@ -1346,17 +1346,17 @@ This tagrendering has labels `technical`
-The question is *What voltage do the plugs with Tesla Supercharger (Destination) 
offer?*
+The question is *What voltage do the plugs with Tesla Supercharger (destination) 
offer?*
This rendering asks information about the property [socket:tesla_destination:voltage](https://wiki.openstreetmap.org/wiki/Key:socket:tesla_destination:voltage)
-This is rendered with `Tesla Supercharger (Destination) 
outputs {socket:tesla_destination:voltage} volt`
+This is rendered with `Tesla Supercharger (destination) 
outputs {socket:tesla_destination:voltage} volt`
- - *Tesla Supercharger (Destination) outputs 480 volt* corresponds with `socket:tesla_destination:voltage=480 V`
+ - *Tesla Supercharger (destination) outputs 480 volt* corresponds with `socket:tesla_destination:voltage=480 V`
This tagrendering is only visible in the popup if the following condition is met: `socket:tesla_destination~.+&socket:tesla_destination!=0`
@@ -1369,18 +1369,18 @@ This tagrendering has labels `technical`
-The question is *What current do the plugs with Tesla Supercharger (Destination) 
offer?*
+The question is *What current do the plugs with Tesla Supercharger (destination) 
offer?*
This rendering asks information about the property [socket:tesla_destination:current](https://wiki.openstreetmap.org/wiki/Key:socket:tesla_destination:current)
-This is rendered with `Tesla Supercharger (Destination) 
outputs at most {socket:tesla_destination:current}A`
+This is rendered with `Tesla Supercharger (destination) 
outputs at most {socket:tesla_destination:current}A`
- - *Tesla Supercharger (Destination) outputs at most 125 A* corresponds with `socket:tesla_destination:current=125 A`
- - *Tesla Supercharger (Destination) outputs at most 350 A* corresponds with `socket:tesla_destination:current=350 A`
+ - *Tesla Supercharger (destination) outputs at most 125 A* corresponds with `socket:tesla_destination:current=125 A`
+ - *Tesla Supercharger (destination) outputs at most 350 A* corresponds with `socket:tesla_destination:current=350 A`
This tagrendering is only visible in the popup if the following condition is met: `socket:tesla_destination~.+&socket:tesla_destination!=0`
@@ -1393,19 +1393,19 @@ This tagrendering has labels `technical`
-The question is *What power output does a single plug of type Tesla Supercharger (Destination) 
offer?*
+The question is *What power output does a single plug of type Tesla Supercharger (destination) 
offer?*
This rendering asks information about the property [socket:tesla_destination:output](https://wiki.openstreetmap.org/wiki/Key:socket:tesla_destination:output)
-This is rendered with `Tesla Supercharger (Destination) 
outputs at most {socket:tesla_destination:output}`
+This is rendered with `Tesla Supercharger (destination) 
outputs at most {socket:tesla_destination:output}`
- - *Tesla Supercharger (Destination) outputs at most 120 kw A* corresponds with `socket:tesla_destination:output=120 kW`
- - *Tesla Supercharger (Destination) outputs at most 150 kw A* corresponds with `socket:tesla_destination:output=150 kW`
- - *Tesla Supercharger (Destination) outputs at most 250 kw A* corresponds with `socket:tesla_destination:output=250 kW`
+ - *Tesla Supercharger (destination) outputs at most 120 kW A* corresponds with `socket:tesla_destination:output=120 kW`
+ - *Tesla Supercharger (destination) outputs at most 150 kW A* corresponds with `socket:tesla_destination:output=150 kW`
+ - *Tesla Supercharger (destination) outputs at most 250 kW A* corresponds with `socket:tesla_destination:output=250 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:tesla_destination~.+&socket:tesla_destination!=0`
@@ -1418,7 +1418,7 @@ This tagrendering has labels `technical`
-The question is *What voltage do the plugs with Tesla Supercharger (Destination) (A Type 2 with cable branded as Tesla) 
offer?*
+The question is *What voltage do the plugs with Tesla supercharger (destination) (A Type 2 with cable branded as tesla) 
offer?*
This rendering asks information about the property [socket:tesla_destination:voltage](https://wiki.openstreetmap.org/wiki/Key:socket:tesla_destination:voltage)
@@ -1428,8 +1428,8 @@ This is rendered with `Tesla superchar
- - *Tesla Supercharger (Destination) (A Type 2 with cable branded as Tesla) outputs 230 volt* corresponds with `socket:tesla_destination:voltage=230 V`
- - *Tesla Supercharger (Destination) (A Type 2 with cable branded as Tesla) outputs 400 volt* corresponds with `socket:tesla_destination:voltage=400 V`
+ - *Tesla supercharger (destination) (A Type 2 with cable branded as tesla) outputs 230 volt* corresponds with `socket:tesla_destination:voltage=230 V`
+ - *Tesla supercharger (destination) (A Type 2 with cable branded as tesla) outputs 400 volt* corresponds with `socket:tesla_destination:voltage=400 V`
This tagrendering is only visible in the popup if the following condition is met: `socket:tesla_destination~.+&socket:tesla_destination!=0`
@@ -1442,18 +1442,18 @@ This tagrendering has labels `technical`
-The question is *What current do the plugs with Tesla Supercharger (Destination) (A Type 2 with cable branded as Tesla) 
offer?*
+The question is *What current do the plugs with Tesla supercharger (destination) (A Type 2 with cable branded as tesla) 
offer?*
This rendering asks information about the property [socket:tesla_destination:current](https://wiki.openstreetmap.org/wiki/Key:socket:tesla_destination:current)
-This is rendered with `Tesla Supercharger (Destination) (A Type 2 with cable branded as Tesla) 
outputs at most {socket:tesla_destination:current}A`
+This is rendered with `Tesla supercharger (destination) (A Type 2 with cable branded as tesla) 
outputs at most {socket:tesla_destination:current}A`
- - *Tesla Supercharger (Destination) (A Type 2 with cable branded as tesla) outputs at most 16 A* corresponds with `socket:tesla_destination:current=16 A`
- - *Tesla Supercharger (Destination) (A Type 2 with cable branded as Tesla) outputs at most 32 A* corresponds with `socket:tesla_destination:current=32 A`
+ - *Tesla supercharger (destination) (A Type 2 with cable branded as tesla) outputs at most 16 A* corresponds with `socket:tesla_destination:current=16 A`
+ - *Tesla supercharger (destination) (A Type 2 with cable branded as tesla) outputs at most 32 A* corresponds with `socket:tesla_destination:current=32 A`
This tagrendering is only visible in the popup if the following condition is met: `socket:tesla_destination~.+&socket:tesla_destination!=0`
@@ -1466,18 +1466,18 @@ This tagrendering has labels `technical`
-The question is *What power output does a single plug of type Tesla Supercharger (Destination) (A Type 2 with cable branded as Tesla) 
offer?*
+The question is *What power output does a single plug of type Tesla supercharger (destination) (A Type 2 with cable branded as tesla) 
offer?*
This rendering asks information about the property [socket:tesla_destination:output](https://wiki.openstreetmap.org/wiki/Key:socket:tesla_destination:output)
-This is rendered with `Tesla Supercharger (Destination) (A Type 2 with cable branded as Tesla) 
outputs at most {socket:tesla_destination:output}`
+This is rendered with `Tesla supercharger (destination) (A Type 2 with cable branded as tesla) 
outputs at most {socket:tesla_destination:output}`
- - *Tesla Supercharger (Destination) (A Type 2 with cable branded as Tesla) outputs at most 11 kw A* corresponds with `socket:tesla_destination:output=11 kW`
- - *Tesla Supercharger (Destination) (A Type 2 with cable branded as Tesla) outputs at most 22 kw A* corresponds with `socket:tesla_destination:output=22 kW`
+ - *Tesla supercharger (destination) (A Type 2 with cable branded as tesla) outputs at most 11 kW A* corresponds with `socket:tesla_destination:output=11 kW`
+ - *Tesla supercharger (destination) (A Type 2 with cable branded as tesla) outputs at most 22 kW A* corresponds with `socket:tesla_destination:output=22 kW`
This tagrendering is only visible in the popup if the following condition is met: `socket:tesla_destination~.+&socket:tesla_destination!=0`
@@ -1547,8 +1547,8 @@ This is rendered with `USB to char
- - *USB to charge phones and small electronics outputs at most 5w A* corresponds with `socket:USB-A:output=5W`
- - *USB to charge phones and small electronics outputs at most 10w A* corresponds with `socket:USB-A:output=10W`
+ - *USB to charge phones and small electronics outputs at most 5W A* corresponds with `socket:USB-A:output=5W`
+ - *USB to charge phones and small electronics outputs at most 10W A* corresponds with `socket:USB-A:output=10W`
This tagrendering is only visible in the popup if the following condition is met: `socket:USB-A~.+&socket:USB-A!=0`
@@ -1728,7 +1728,7 @@ The question is *Does one have to pay to use this charging station?*
- *Free to use, but one has to authenticate* corresponds with `fee=no&authentication:none=no`
- *Free to use* corresponds with `fee=no`
- This option cannot be chosen as answer
- - *Paid use, but free for customers of the hotel/pub/hospital/… who operates the charging station* corresponds with `fee=yes&fee:conditional=no @ customers`
+ - *Paid use, but free for customers of the hotel/pub/hospital/... who operates the charging station* corresponds with `fee=yes&fee:conditional=no @ customers`
- *Paid use* corresponds with `fee=yes`
diff --git a/Docs/Layers/climbing.md b/Docs/Layers/climbing.md
deleted file mode 100644
index eac07bd893..0000000000
--- a/Docs/Layers/climbing.md
+++ /dev/null
@@ -1,285 +0,0 @@
-[//]: # (WARNING: this file is automatically generated. Please find the sources at the bottom and edit those sources)
-
- climbing
-==========
-
-
-
-
-
-A dummy layer which contains tagrenderings, shared among the climbing layers
-
-
-
-
-
-
- - This layer is shown at zoomlevel **19** and higher
- - Elements don't have a title set and cannot be toggled nor will they show up in the dashboard. If you import this layer in your theme, override `title` to make this toggleable.
- - Not visible in the layer selection by default. If you want to make this layer toggable, override `name`
- - Not rendered on the map by default. If you want to rendering this on the map, override `mapRenderings`
-
-
-This is a special layer - data is not sourced from OpenStreetMap
-
-
-
- Supported attributes
-----------------------
-
-
-
-Warning:
-
-this quick overview is incomplete
-
-
-
-attribute | type | values which are supported by this layer
------------ | ------ | ------------------------------------------
-[
](https://taginfo.openstreetmap.org/keys/id#values) [id](https://wiki.openstreetmap.org/wiki/Key:id) | Multiple choice |
-[
](https://taginfo.openstreetmap.org/keys/url#values) [url](https://wiki.openstreetmap.org/wiki/Key:url) | [url](../SpecialInputElements.md#url) |
-[
](https://taginfo.openstreetmap.org/keys/climbing:length#values) [climbing:length](https://wiki.openstreetmap.org/wiki/Key:climbing:length) | [pfloat](../SpecialInputElements.md#pfloat) |
-[
](https://taginfo.openstreetmap.org/keys/climbing:grade:french:min#values) [climbing:grade:french:min](https://wiki.openstreetmap.org/wiki/Key:climbing:grade:french:min) | [string](../SpecialInputElements.md#string) |
-[
](https://taginfo.openstreetmap.org/keys/climbing:grade:french:max#values) [climbing:grade:french:max](https://wiki.openstreetmap.org/wiki/Key:climbing:grade:french:max) | [string](../SpecialInputElements.md#string) |
-[
](https://taginfo.openstreetmap.org/keys/climbing:boulder#values) [climbing:boulder](https://wiki.openstreetmap.org/wiki/Key:climbing:boulder) | Multiple choice | [yes](https://wiki.openstreetmap.org/wiki/Tag:climbing:boulder%3Dyes) [no](https://wiki.openstreetmap.org/wiki/Tag:climbing:boulder%3Dno) [limited](https://wiki.openstreetmap.org/wiki/Tag:climbing:boulder%3Dlimited)
-[
](https://taginfo.openstreetmap.org/keys/climbing:toprope#values) [climbing:toprope](https://wiki.openstreetmap.org/wiki/Key:climbing:toprope) | Multiple choice | [yes](https://wiki.openstreetmap.org/wiki/Tag:climbing:toprope%3Dyes) [no](https://wiki.openstreetmap.org/wiki/Tag:climbing:toprope%3Dno)
-[
](https://taginfo.openstreetmap.org/keys/climbing:sport#values) [climbing:sport](https://wiki.openstreetmap.org/wiki/Key:climbing:sport) | Multiple choice | [yes](https://wiki.openstreetmap.org/wiki/Tag:climbing:sport%3Dyes) [no](https://wiki.openstreetmap.org/wiki/Tag:climbing:sport%3Dno)
-[
](https://taginfo.openstreetmap.org/keys/climbing:traditional#values) [climbing:traditional](https://wiki.openstreetmap.org/wiki/Key:climbing:traditional) | Multiple choice | [yes](https://wiki.openstreetmap.org/wiki/Tag:climbing:traditional%3Dyes) [no](https://wiki.openstreetmap.org/wiki/Tag:climbing:traditional%3Dno)
-[
](https://taginfo.openstreetmap.org/keys/climbing:bolts:max#values) [climbing:bolts:max](https://wiki.openstreetmap.org/wiki/Key:climbing:bolts:max) | [pnat](../SpecialInputElements.md#pnat) |
-[
](https://taginfo.openstreetmap.org/keys/charge#values) [charge](https://wiki.openstreetmap.org/wiki/Key:charge) | [string](../SpecialInputElements.md#string) | [](https://wiki.openstreetmap.org/wiki/Tag:charge%3D)
-
-
-
-
-### just_created
-
-
-
-This element shows a 'thank you' that the contributor has recently created this element
-
-This tagrendering has no question and is thus read-only
-
-
-
-
-
- - *You just created this element! Thanks for sharing this info with the world and helping people worldwide.* corresponds with `id~.+`
-
-
-This tagrendering is only visible in the popup if the following condition is met: `_backend~.+&_last_edit:passed_time<300&|_version_number=1`
-
-
-
-### website
-
-
-
-The question is *Is there a (unofficial) website with more informations (e.g. topos)?*
-
-This rendering asks information about the property [url](https://wiki.openstreetmap.org/wiki/Key:url)
-
-This is rendered with `{url}`
-
-
-
-This tagrendering is only visible in the popup if the following condition is met: `leisure!~^(sports_centre)$&sport=climbing`
-
-
-
-### average_length
-
-
-
-The question is *What is the (average) length of the routes in meters?*
-
-This rendering asks information about the property [climbing:length](https://wiki.openstreetmap.org/wiki/Key:climbing:length)
-
-This is rendered with `The routes are {canonical(climbing:length)} long on average`
-
-
-
-
-
-### min_difficulty
-
-
-
-The question is *What is the grade of the easiest route here, according to the french classification system?*
-
-This rendering asks information about the property [climbing:grade:french:min](https://wiki.openstreetmap.org/wiki/Key:climbing:grade:french:min)
-
-This is rendered with `The lowest grade is {climbing:grade:french:min} according to the french/belgian system`
-
-
-
-
-
-### max_difficulty
-
-
-
-The question is *What is the highest grade route here, according to the french classification system?*
-
-This rendering asks information about the property [climbing:grade:french:max](https://wiki.openstreetmap.org/wiki/Key:climbing:grade:french:max)
-
-This is rendered with `The highest grade is {climbing:grade:french:max} according to the french/belgian system`
-
-
-
-This tagrendering is only visible in the popup if the following condition is met: `climbing!~^(route)$&climbing:sport=yes|sport=climbing`
-
-
-
-### bouldering
-
-
-
-The question is *Is bouldering possible here?*
-
-
-
-
-
- - *Bouldering is possible here* corresponds with `climbing:boulder=yes`
- - *Bouldering is not possible here* corresponds with `climbing:boulder=no`
- - *Bouldering is possible, although there are only a few problems* corresponds with `climbing:boulder=limited`
- - *There are {climbing:boulder} boulder problems* corresponds with `climbing:boulder~.+`
- - This option cannot be chosen as answer
-
-
-
-
-### toprope
-
-
-
-The question is *Is toprope climbing possible here?*
-
-
-
-
-
- - *Toprope climbing is possible here* corresponds with `climbing:toprope=yes`
- - *Toprope climbing is not possible here* corresponds with `climbing:toprope=no`
- - *There are {climbing:toprope} toprope routes* corresponds with `climbing:toprope~.+`
- - This option cannot be chosen as answer
-
-
-
-
-### sportclimbing
-
-
-
-The question is *Is sport climbing possible here on fixed anchors?*
-
-
-
-
-
- - *Sport climbing is possible here* corresponds with `climbing:sport=yes`
- - *Sport climbing is not possible here* corresponds with `climbing:sport=no`
- - *There are {climbing:sport} sport climbing routes* corresponds with `climbing:sport~.+`
- - This option cannot be chosen as answer
-
-
-
-
-### trad_climbing
-
-
-
-The question is *Is traditional climbing possible here?*
-
-
-
-
-
- - *Traditional climbing is possible here* corresponds with `climbing:traditional=yes`
- - *Traditional climbing is not possible here* corresponds with `climbing:traditional=no`
- - *There are {climbing:traditional} traditional climbing routes* corresponds with `climbing:traditional~.+`
- - This option cannot be chosen as answer
-
-
-
-
-### max_bolts
-
-
-
-The question is *How many bolts do routes in {title()} have at most?*
-
-This rendering asks information about the property [climbing:bolts:max](https://wiki.openstreetmap.org/wiki/Key:climbing:bolts:max)
-
-This is rendered with `The sport climbing routes here have at most {climbing:bolts:max} bolts.This is without relays and indicates how much quickdraws a climber needs
`
-
-
-
-
-
-### fee
-
-
-
-The question is *Is a fee required to climb here?*
-
-This rendering asks information about the property [charge](https://wiki.openstreetmap.org/wiki/Key:charge)
-
-This is rendered with `A fee of {charge} should be paid for climbing here`
-
-
-
-
-
- - *Climbing here is free of charge* corresponds with `fee=no`
- - *Paying a fee is required to climb here* corresponds with `fee=yes`
-
-
-
-
-### leftover-questions
-
-
-
-This tagrendering has no question and is thus read-only
-
-
-
-
-
-### minimap
-
-
-
-Shows a small map with the feature. Added by default to every popup
-
-This tagrendering has no question and is thus read-only
-
-
-
-
-
-### last_edit
-
-
-
-Gives some metainfo about the last edit and who did edit it - rendering only
-
-This tagrendering has no question and is thus read-only
-
-
-
-This tagrendering is only visible in the popup if the following condition is met: `_last_edit:contributor~.+&_last_edit:changeset~.+`
-
-
-
-### all-tags
-
-
-
-This tagrendering has no question and is thus read-only
-
-
-
-This document is autogenerated from [assets/layers/climbing/climbing.json](https://github.com/pietervdvn/MapComplete/blob/develop/assets/layers/climbing/climbing.json)
diff --git a/Docs/Layers/climbing_area.md b/Docs/Layers/climbing_area.md
index 45c92d534a..b4504f5ac1 100644
--- a/Docs/Layers/climbing_area.md
+++ b/Docs/Layers/climbing_area.md
@@ -5,7 +5,7 @@
-
+
An area where climbing is possible, e.g. a crag, site, boulder, … Contains aggregation of routes
diff --git a/Docs/Layers/climbing_club.md b/Docs/Layers/climbing_club.md
index 00a84787b5..989cf099c5 100644
--- a/Docs/Layers/climbing_club.md
+++ b/Docs/Layers/climbing_club.md
@@ -5,7 +5,7 @@
-
+
A climbing club or organisation
diff --git a/Docs/Layers/climbing_gym.md b/Docs/Layers/climbing_gym.md
index 81d97216dd..ed961c7b18 100644
--- a/Docs/Layers/climbing_gym.md
+++ b/Docs/Layers/climbing_gym.md
@@ -5,7 +5,7 @@
-
+
A climbing gym
diff --git a/Docs/Layers/climbing_opportunity.md b/Docs/Layers/climbing_opportunity.md
index a4f96a1efc..a04562912a 100644
--- a/Docs/Layers/climbing_opportunity.md
+++ b/Docs/Layers/climbing_opportunity.md
@@ -5,7 +5,7 @@
-
+
Fallback layer with items on which climbing _might_ be possible. It is loaded when zoomed in a lot, to prevent duplicate items to be added
diff --git a/Docs/Layers/climbing_route.md b/Docs/Layers/climbing_route.md
index 5fad3788ab..d9257f2f70 100644
--- a/Docs/Layers/climbing_route.md
+++ b/Docs/Layers/climbing_route.md
@@ -5,7 +5,7 @@
-
+
A single climbing route and its properties. Some properties are derived from the containing features
diff --git a/Docs/Layers/clock.md b/Docs/Layers/clock.md
index f56011b317..a89d2c527b 100644
--- a/Docs/Layers/clock.md
+++ b/Docs/Layers/clock.md
@@ -5,7 +5,7 @@
-
+
Layer with public clocks
diff --git a/Docs/Layers/crab_address.md b/Docs/Layers/crab_address.md
index 9a895e2bfa..8f6bc86b46 100644
--- a/Docs/Layers/crab_address.md
+++ b/Docs/Layers/crab_address.md
@@ -5,7 +5,7 @@
-
+
Address data for Flanders by the governement, suited for import into OpenStreetMap. Datadump from 2021-10-26. This layer contains only visualisation logic. Import buttons should be added via an override. Note that HNRLABEL contains the original value, whereas _HNRLABEL contains a slightly cleaned version
diff --git a/Docs/Layers/crossings.md b/Docs/Layers/crossings.md
index 1c4f465471..7812e77e6b 100644
--- a/Docs/Layers/crossings.md
+++ b/Docs/Layers/crossings.md
@@ -5,7 +5,7 @@
-
+
Crossings for pedestrians and cyclists
diff --git a/Docs/Layers/cultural_places_without_etymology.md b/Docs/Layers/cultural_places_without_etymology.md
index f43d3c83b9..7f89a0418c 100644
--- a/Docs/Layers/cultural_places_without_etymology.md
+++ b/Docs/Layers/cultural_places_without_etymology.md
@@ -5,7 +5,7 @@
-
+
All objects which have an etymology known
diff --git a/Docs/Layers/cycleways_and_roads.md b/Docs/Layers/cycleways_and_roads.md
index 152328a169..30025407ca 100644
--- a/Docs/Layers/cycleways_and_roads.md
+++ b/Docs/Layers/cycleways_and_roads.md
@@ -5,7 +5,7 @@
-
+
All infrastructure that someone can cycle over, accompanied with questions about this infrastructure
diff --git a/Docs/Layers/defibrillator.md b/Docs/Layers/defibrillator.md
index 0d6cdd7454..0270d95e6f 100644
--- a/Docs/Layers/defibrillator.md
+++ b/Docs/Layers/defibrillator.md
@@ -5,7 +5,7 @@
-
+
A layer showing defibrillators which can be used in case of emergency. This contains public defibrillators, but also defibrillators which might need staff to fetch the actual device
diff --git a/Docs/Layers/dentist.md b/Docs/Layers/dentist.md
index d52b4b840a..ee67d58c8d 100644
--- a/Docs/Layers/dentist.md
+++ b/Docs/Layers/dentist.md
@@ -5,7 +5,7 @@
-
+
This layer shows dentist offices
diff --git a/Docs/Layers/direction.md b/Docs/Layers/direction.md
index 59aab447e0..b4f6bdce71 100644
--- a/Docs/Layers/direction.md
+++ b/Docs/Layers/direction.md
@@ -5,7 +5,7 @@
-
+
This layer visualizes directions
diff --git a/Docs/Layers/doctors.md b/Docs/Layers/doctors.md
index 81d4a1973e..0494cbcbf5 100644
--- a/Docs/Layers/doctors.md
+++ b/Docs/Layers/doctors.md
@@ -5,7 +5,7 @@
-
+
This layer shows doctor offices
diff --git a/Docs/Layers/dogfoodb.md b/Docs/Layers/dogfoodb.md
index f10efed281..0ccde46f88 100644
--- a/Docs/Layers/dogfoodb.md
+++ b/Docs/Layers/dogfoodb.md
@@ -5,7 +5,7 @@
-
+
A layer showing restaurants and fast-food amenities (with a special rendering for friteries)
@@ -455,6 +455,8 @@ The question is *Does this shop have a sugar free offering?*
- *This shop has no sugar free offering* corresponds with `diet:sugar_free=no`
+This tagrendering has labels `diets`
+
### gluten_free
@@ -473,6 +475,8 @@ The question is *Does this shop have a gluten free offering?*
- *This shop has no gluten free offering* corresponds with `diet:gluten_free=no`
+This tagrendering has labels `diets`
+
### lactose_free
@@ -491,6 +495,8 @@ The question is *Does {title()} have a lactose-free offering?*
- *No lactose free offering* corresponds with `diet:lactose_free=no`
+This tagrendering has labels `diets`
+
### organic (no friture)
diff --git a/Docs/Layers/dogpark.md b/Docs/Layers/dogpark.md
index 61094640ca..27d2faa73f 100644
--- a/Docs/Layers/dogpark.md
+++ b/Docs/Layers/dogpark.md
@@ -5,7 +5,7 @@
-
+
A layer showing dogparks, which are areas where dog are allowed to run without a leash
diff --git a/Docs/Layers/dogshop.md b/Docs/Layers/dogshop.md
index e1d22611ba..9886d1c1f3 100644
--- a/Docs/Layers/dogshop.md
+++ b/Docs/Layers/dogshop.md
@@ -5,7 +5,7 @@
-
+
A shop
@@ -47,7 +47,7 @@ attribute | type | values which are supported by this layer
----------- | ------ | ------------------------------------------
[
](https://taginfo.openstreetmap.org/keys/id#values) [id](https://wiki.openstreetmap.org/wiki/Key:id) | Multiple choice |
[
](https://taginfo.openstreetmap.org/keys/name#values) [name](https://wiki.openstreetmap.org/wiki/Key:name) | [string](../SpecialInputElements.md#string) |
-[
](https://taginfo.openstreetmap.org/keys/shop#values) [shop](https://wiki.openstreetmap.org/wiki/Key:shop) | [string](../SpecialInputElements.md#string) | [agrarian](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dagrarian) [alcohol](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dalcohol) [anime](https://wiki.openstreetmap.org/wiki/Tag:shop%3Danime) [antiques](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dantiques) [appliance](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dappliance) [art](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dart) [baby_goods](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbaby_goods) [bag](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbag) [bakery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbakery) [bathroom_furnishing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbathroom_furnishing) [beauty](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbeauty) [bed](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbed) [beverages](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbeverages) [bicycle](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbicycle) [boat](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dboat) [bookmaker](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbookmaker) [books](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbooks) [brewing_supplies](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbrewing_supplies) [butcher](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbutcher) [camera](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcamera) [candles](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcandles) [cannabis](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcannabis) [car](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar) [car_parts](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar_parts) [car_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar_repair) [caravan](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcaravan) [carpet](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcarpet) [catalogue](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcatalogue) [charity](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcharity) [cheese](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcheese) [chemist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dchemist) [chocolate](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dchocolate) [clothes](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dclothes) [coffee](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcoffee) [collector](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcollector) [computer](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcomputer) [confectionery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dconfectionery) [convenience](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dconvenience) [copyshop](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcopyshop) [cosmetics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcosmetics) [country_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcountry_store) [craft](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcraft) [curtain](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcurtain) [dairy](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddairy) [deli](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddeli) [department_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddepartment_store) [doityourself](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddoityourself) [doors](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddoors) [dry_cleaning](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddry_cleaning) [e-cigarette](https://wiki.openstreetmap.org/wiki/Tag:shop%3De-cigarette) [electrical](https://wiki.openstreetmap.org/wiki/Tag:shop%3Delectrical) [electronics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Delectronics) [erotic](https://wiki.openstreetmap.org/wiki/Tag:shop%3Derotic) [fabric](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfabric) [farm](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfarm) [fashion_accessories](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfashion_accessories) [fireplace](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfireplace) [fishing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfishing) [flooring](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dflooring) [florist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dflorist) [frame](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dframe) [frozen_food](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfrozen_food) [fuel](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfuel) [funeral_directors](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfuneral_directors) [furniture](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfurniture) [games](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgames) [garden_centre](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgarden_centre) [gas](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgas) [general](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgeneral) [gift](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgift) [greengrocer](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgreengrocer) [hairdresser](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhairdresser) [hairdresser_supply](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhairdresser_supply) [hardware](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhardware) [health_food](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhealth_food) [hearing_aids](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhearing_aids) [herbalist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dherbalist) [hifi](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhifi) [hobby](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhobby) [household_linen](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhousehold_linen) [houseware](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhouseware) [hunting](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhunting) [interior_decoration](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dinterior_decoration) [jewelry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Djewelry) [kiosk](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dkiosk) [kitchen](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dkitchen) [laundry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlaundry) [leather](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dleather) [lighting](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlighting) [locksmith](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlocksmith) [lottery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlottery) [mall](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmall) [massage](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmassage) [medical_supply](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmedical_supply) [military_surplus](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmilitary_surplus) [mobile_phone](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmobile_phone) [model](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmodel) [money_lender](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmoney_lender) [motorcycle](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmotorcycle) [motorcycle_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmotorcycle_repair) [music](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmusic) [musical_instrument](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmusical_instrument) [newsagent](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dnewsagent) [nutrition_supplements](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dnutrition_supplements) [optician](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doptician) [outdoor](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doutdoor) [outpost](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doutpost) [paint](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpaint) [party](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dparty) [pastry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpastry) [pawnbroker](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpawnbroker) [perfumery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dperfumery) [pet](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpet) [pet_grooming](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpet_grooming) [photo](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dphoto) [pottery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpottery) [printer_ink](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dprinter_ink) [psychic](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpsychic) [pyrotechnics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpyrotechnics) [radiotechnics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dradiotechnics) [religion](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dreligion) [rental](https://wiki.openstreetmap.org/wiki/Tag:shop%3Drental) [repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Drepair) [scuba_diving](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dscuba_diving) [seafood](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dseafood) [second_hand](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsecond_hand) [sewing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsewing) [shoe_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dshoe_repair) [shoes](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dshoes) [spices](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dspices) [sports](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsports) [stationery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dstationery) [storage_rental](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dstorage_rental) [supermarket](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsupermarket) [swimming_pool](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dswimming_pool) [tailor](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtailor) [tattoo](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtattoo) [tea](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtea) [telecommunication](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtelecommunication) [ticket](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dticket) [tiles](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtiles) [tobacco](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtobacco) [tool_hire](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtool_hire) [toys](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtoys) [trade](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtrade) [travel_agency](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtravel_agency) [trophy](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtrophy) [tyres](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtyres) [vacuum_cleaner](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvacuum_cleaner) [variety_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvariety_store) [video](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvideo) [video_games](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvideo_games) [watches](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwatches) [water](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwater) [water_sports](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwater_sports) [weapons](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dweapons) [wholesale](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwholesale) [wigs](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwigs) [window_blind](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwindow_blind) [wine](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwine)
+[
](https://taginfo.openstreetmap.org/keys/shop#values) [shop](https://wiki.openstreetmap.org/wiki/Key:shop) | [string](../SpecialInputElements.md#string) | [vacant](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvacant) [agrarian](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dagrarian) [alcohol](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dalcohol) [anime](https://wiki.openstreetmap.org/wiki/Tag:shop%3Danime) [antiques](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dantiques) [appliance](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dappliance) [art](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dart) [baby_goods](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbaby_goods) [bag](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbag) [bakery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbakery) [bathroom_furnishing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbathroom_furnishing) [beauty](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbeauty) [bed](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbed) [beverages](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbeverages) [bicycle](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbicycle) [boat](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dboat) [bookmaker](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbookmaker) [books](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbooks) [brewing_supplies](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbrewing_supplies) [butcher](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbutcher) [camera](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcamera) [candles](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcandles) [cannabis](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcannabis) [car](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar) [car_parts](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar_parts) [car_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar_repair) [caravan](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcaravan) [carpet](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcarpet) [catalogue](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcatalogue) [charity](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcharity) [cheese](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcheese) [chemist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dchemist) [chocolate](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dchocolate) [clothes](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dclothes) [coffee](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcoffee) [collector](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcollector) [computer](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcomputer) [confectionery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dconfectionery) [convenience](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dconvenience) [copyshop](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcopyshop) [cosmetics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcosmetics) [country_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcountry_store) [craft](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcraft) [curtain](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcurtain) [dairy](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddairy) [deli](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddeli) [department_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddepartment_store) [doityourself](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddoityourself) [doors](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddoors) [dry_cleaning](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddry_cleaning) [e-cigarette](https://wiki.openstreetmap.org/wiki/Tag:shop%3De-cigarette) [electrical](https://wiki.openstreetmap.org/wiki/Tag:shop%3Delectrical) [electronics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Delectronics) [erotic](https://wiki.openstreetmap.org/wiki/Tag:shop%3Derotic) [fabric](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfabric) [farm](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfarm) [fashion_accessories](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfashion_accessories) [fireplace](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfireplace) [fishing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfishing) [flooring](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dflooring) [florist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dflorist) [frame](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dframe) [frozen_food](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfrozen_food) [fuel](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfuel) [funeral_directors](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfuneral_directors) [furniture](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfurniture) [games](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgames) [garden_centre](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgarden_centre) [gas](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgas) [general](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgeneral) [gift](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgift) [greengrocer](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgreengrocer) [hairdresser](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhairdresser) [hairdresser_supply](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhairdresser_supply) [hardware](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhardware) [health_food](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhealth_food) [hearing_aids](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhearing_aids) [herbalist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dherbalist) [hifi](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhifi) [honey](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhoney) [household_linen](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhousehold_linen) [houseware](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhouseware) [hunting](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhunting) [interior_decoration](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dinterior_decoration) [jewelry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Djewelry) [kiosk](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dkiosk) [kitchen](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dkitchen) [laundry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlaundry) [leather](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dleather) [lighting](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlighting) [locksmith](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlocksmith) [lottery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlottery) [mall](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmall) [massage](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmassage) [medical_supply](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmedical_supply) [military_surplus](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmilitary_surplus) [mobile_phone](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmobile_phone) [model](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmodel) [money_lender](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmoney_lender) [motorcycle](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmotorcycle) [motorcycle_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmotorcycle_repair) [music](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmusic) [musical_instrument](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmusical_instrument) [newsagent](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dnewsagent) [nutrition_supplements](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dnutrition_supplements) [nuts](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dnuts) [optician](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doptician) [outdoor](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doutdoor) [outpost](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doutpost) [paint](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpaint) [party](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dparty) [pasta](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpasta) [pastry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpastry) [pawnbroker](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpawnbroker) [perfumery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dperfumery) [pet](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpet) [pet_grooming](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpet_grooming) [photo](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dphoto) [pottery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpottery) [printer_ink](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dprinter_ink) [psychic](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpsychic) [pyrotechnics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpyrotechnics) [radiotechnics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dradiotechnics) [religion](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dreligion) [rental](https://wiki.openstreetmap.org/wiki/Tag:shop%3Drental) [repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Drepair) [rice](https://wiki.openstreetmap.org/wiki/Tag:shop%3Drice) [scuba_diving](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dscuba_diving) [seafood](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dseafood) [second_hand](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsecond_hand) [sewing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsewing) [shoe_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dshoe_repair) [shoes](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dshoes) [spices](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dspices) [sports](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsports) [stationery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dstationery) [storage_rental](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dstorage_rental) [supermarket](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsupermarket) [swimming_pool](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dswimming_pool) [tailor](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtailor) [tattoo](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtattoo) [tea](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtea) [telecommunication](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtelecommunication) [ticket](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dticket) [tiles](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtiles) [tobacco](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtobacco) [tool_hire](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtool_hire) [toys](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtoys) [trade](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtrade) [travel_agency](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtravel_agency) [trophy](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtrophy) [tyres](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtyres) [vacuum_cleaner](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvacuum_cleaner) [variety_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvariety_store) [video](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvideo) [video_games](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvideo_games) [watches](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwatches) [water](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwater) [water_sports](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwater_sports) [weapons](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dweapons) [wholesale](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwholesale) [wigs](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwigs) [window_blind](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwindow_blind) [wine](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwine)
[
](https://taginfo.openstreetmap.org/keys/second_hand#values) [second_hand](https://wiki.openstreetmap.org/wiki/Key:second_hand) | Multiple choice | [only](https://wiki.openstreetmap.org/wiki/Tag:second_hand%3Donly) [yes](https://wiki.openstreetmap.org/wiki/Tag:second_hand%3Dyes) [no](https://wiki.openstreetmap.org/wiki/Tag:second_hand%3Dno)
[
](https://taginfo.openstreetmap.org/keys/opening_hours#values) [opening_hours](https://wiki.openstreetmap.org/wiki/Key:opening_hours) | [opening_hours](../SpecialInputElements.md#opening_hours) |
[
](https://taginfo.openstreetmap.org/keys/website#values) [website](https://wiki.openstreetmap.org/wiki/Key:website) | [url](../SpecialInputElements.md#url) |
@@ -124,10 +124,11 @@ This is rendered with `This is a {shop}`
+ - *Vacant Shop* corresponds with `shop=vacant`
- *Farm Supply Shop* corresponds with `shop=agrarian`
- *Liquor Store* corresponds with `shop=alcohol`
- *Anime / Manga Shop* corresponds with `shop=anime`
- - *Antiques Shop* corresponds with `shop=antiques`
+ - *Antique Shop* corresponds with `shop=antiques`
- *Appliance Store* corresponds with `shop=appliance`
- *Art Store* corresponds with `shop=art`
- *Baby Goods Store* corresponds with `shop=baby_goods`
@@ -140,7 +141,7 @@ This is rendered with `This is a {shop}`
- *Bicycle Shop* corresponds with `shop=bicycle`
- *Boat Store* corresponds with `shop=boat`
- *Bookmaker* corresponds with `shop=bookmaker`
- - *Book Store* corresponds with `shop=books`
+ - *Bookstore* corresponds with `shop=books`
- *Brewing Supply Store* corresponds with `shop=brewing_supplies`
- *Butcher* corresponds with `shop=butcher`
- *Camera Equipment Store* corresponds with `shop=camera`
@@ -164,11 +165,11 @@ This is rendered with `This is a {shop}`
- *Convenience Store* corresponds with `shop=convenience`
- *Copy Store* corresponds with `shop=copyshop`
- *Cosmetics Store* corresponds with `shop=cosmetics`
- - *Country Store* corresponds with `shop=country_store`
+ - *Rural Supplies Store* corresponds with `shop=country_store`
- *Arts & Crafts Store* corresponds with `shop=craft`
- *Curtain Store* corresponds with `shop=curtain`
- *Dairy Store* corresponds with `shop=dairy`
- - *Deli* corresponds with `shop=deli`
+ - *Delicatessen* corresponds with `shop=deli`
- *Department Store* corresponds with `shop=department_store`
- *DIY Store* corresponds with `shop=doityourself`
- *Door Shop* corresponds with `shop=doors`
@@ -198,11 +199,11 @@ This is rendered with `This is a {shop}`
- *Hairdresser* corresponds with `shop=hairdresser`
- *Hairdresser Supply Store* corresponds with `shop=hairdresser_supply`
- *Hardware Store* corresponds with `shop=hardware`
- - *Health Food Shop* corresponds with `shop=health_food`
+ - *Health Food Store* corresponds with `shop=health_food`
- *Hearing Aids Store* corresponds with `shop=hearing_aids`
- *Herbalist* corresponds with `shop=herbalist`
- *Hifi Store* corresponds with `shop=hifi`
- - *Hobby Shop* corresponds with `shop=hobby`
+ - *Honey Store* corresponds with `shop=honey`
- *Household Linen Shop* corresponds with `shop=household_linen`
- *Houseware Store* corresponds with `shop=houseware`
- *Hunting Shop* corresponds with `shop=hunting`
@@ -226,18 +227,20 @@ This is rendered with `This is a {shop}`
- *Motorcycle Repair Shop* corresponds with `shop=motorcycle_repair`
- *Music Store* corresponds with `shop=music`
- *Musical Instrument Store* corresponds with `shop=musical_instrument`
- - *Newspaper/Magazine Shop* corresponds with `shop=newsagent`
+ - *Newsstand* corresponds with `shop=newsagent`
- *Nutrition Supplements Store* corresponds with `shop=nutrition_supplements`
+ - *Nuts Shop* corresponds with `shop=nuts`
- *Optician* corresponds with `shop=optician`
- *Outdoors Store* corresponds with `shop=outdoor`
- *Online Retailer Outpost* corresponds with `shop=outpost`
- *Paint Store* corresponds with `shop=paint`
- *Party Supply Store* corresponds with `shop=party`
+ - *Pasta Store* corresponds with `shop=pasta`
- *Pastry Shop* corresponds with `shop=pastry`
- - *Pawn Shop* corresponds with `shop=pawnbroker`
+ - *Pawnshop* corresponds with `shop=pawnbroker`
- *Perfume Store* corresponds with `shop=perfumery`
- *Pet Store* corresponds with `shop=pet`
- - *Pet Grooming Store* corresponds with `shop=pet_grooming`
+ - *Pet Groomer* corresponds with `shop=pet_grooming`
- *Photography Store* corresponds with `shop=photo`
- *Pottery Store* corresponds with `shop=pottery`
- *Printer Ink Store* corresponds with `shop=printer_ink`
@@ -247,9 +250,10 @@ This is rendered with `This is a {shop}`
- *Religious Store* corresponds with `shop=religion`
- *Rental Shop* corresponds with `shop=rental`
- *Repair Shop* corresponds with `shop=repair`
+ - *Rice Store* corresponds with `shop=rice`
- *Scuba Diving Shop* corresponds with `shop=scuba_diving`
- *Seafood Shop* corresponds with `shop=seafood`
- - *Consignment/Thrift Store* corresponds with `shop=second_hand`
+ - *Thrift Store* corresponds with `shop=second_hand`
- *Sewing Supply Shop* corresponds with `shop=sewing`
- *Shoe Repair Shop* corresponds with `shop=shoe_repair`
- *Shoe Store* corresponds with `shop=shoes`
@@ -273,7 +277,7 @@ This is rendered with `This is a {shop}`
- *Trophy Shop* corresponds with `shop=trophy`
- *Tire Store* corresponds with `shop=tyres`
- *Vacuum Cleaner Store* corresponds with `shop=vacuum_cleaner`
- - *Variety Store* corresponds with `shop=variety_store`
+ - *Discount Store* corresponds with `shop=variety_store`
- *Video Store* corresponds with `shop=video`
- *Video Game Store* corresponds with `shop=video_games`
- *Watches Shop* corresponds with `shop=watches`
@@ -474,6 +478,25 @@ This tagrendering is only visible in the popup if the following condition is met
+### key_cutter
+
+
+
+This tagrendering has no question and is thus read-only
+
+
+
+
+
+ - *This shop is also specialized in key cutting* corresponds with `craft=key_cutter`
+ - *This shop offers key cutting as a service* corresponds with `service:key_cutting=yes`
+ - *This shops does not offer key cutting as a service* corresponds with `service:key_cutting=no`
+
+
+This tagrendering is only visible in the popup if the following condition is met: `shop=shoe_repair|service:key_cutting~.+|craft=key_cutting|shop=diy|shop=doityourself|shop=home_improvement|shop=hardware|shop=locksmith|shop=repair`
+
+
+
### internet
@@ -571,6 +594,8 @@ The question is *Does this shop have a sugar free offering?*
This tagrendering is only visible in the popup if the following condition is met: `shop=supermarket|shop=convenience|shop=farm|shop=greengrocer|shop=health_food|shop=deli|shop=bakery|shop=beverages|shop=beverages|shop=pastry|shop=chocolate|shop=frozen_food|shop=ice_cream`
+This tagrendering has labels `diets`
+
### gluten_free
@@ -591,6 +616,8 @@ The question is *Does this shop have a gluten free offering?*
This tagrendering is only visible in the popup if the following condition is met: `shop=supermarket|shop=convenience|shop=farm|shop=greengrocer|shop=health_food|shop=deli|shop=bakery|shop=beverages|shop=beverages|shop=pastry|shop=chocolate|shop=frozen_food|shop=ice_cream`
+This tagrendering has labels `diets`
+
### lactose_free
@@ -611,6 +638,8 @@ The question is *Does {title()} have a lactose-free offering?*
This tagrendering is only visible in the popup if the following condition is met: `shop=supermarket|shop=convenience|shop=farm|shop=greengrocer|shop=health_food|shop=deli|shop=bakery|shop=beverages|shop=beverages|shop=pastry|shop=chocolate|shop=frozen_food|shop=ice_cream`
+This tagrendering has labels `diets`
+
### questions
diff --git a/Docs/Layers/drinking_water.md b/Docs/Layers/drinking_water.md
index 9942749b8a..3ba8feddca 100644
--- a/Docs/Layers/drinking_water.md
+++ b/Docs/Layers/drinking_water.md
@@ -5,7 +5,7 @@
-
+
A layer showing drinking water fountains
@@ -14,7 +14,7 @@ A layer showing drinking water fountains
- - This layer is shown at zoomlevel **13** and higher
+ - This layer is shown at zoomlevel **0** and higher
- This layer will automatically load [drinking_water](./drinking_water.md) into the layout as it depends on it: a calculated tag loads features from this layer (calculatedTag[0] which calculates the value for _closest_other_drinking_water)
- This layer is needed as dependency for layer [drinking_water](#drinking_water)
diff --git a/Docs/Layers/dumpstations.md b/Docs/Layers/dumpstations.md
index 1dd141f772..0bc74b3054 100644
--- a/Docs/Layers/dumpstations.md
+++ b/Docs/Layers/dumpstations.md
@@ -5,7 +5,7 @@
-
+
Sanitary dump stations
@@ -15,6 +15,7 @@ Sanitary dump stations
- This layer is shown at zoomlevel **10** and higher
+ - Not rendered on the map by default. If you want to rendering this on the map, override `mapRenderings`
diff --git a/Docs/Layers/education_institutions_without_etymology.md b/Docs/Layers/education_institutions_without_etymology.md
index 7d44a33501..c975ad42ff 100644
--- a/Docs/Layers/education_institutions_without_etymology.md
+++ b/Docs/Layers/education_institutions_without_etymology.md
@@ -5,7 +5,7 @@
-
+
All objects which have an etymology known
diff --git a/Docs/Layers/elevator.md b/Docs/Layers/elevator.md
index 1da424300b..28d760d19d 100644
--- a/Docs/Layers/elevator.md
+++ b/Docs/Layers/elevator.md
@@ -5,7 +5,7 @@
-
+
This layer show elevators and asks for operational status and elevator dimensions. Useful for wheelchair accessibility information
diff --git a/Docs/Layers/elongated_coin.md b/Docs/Layers/elongated_coin.md
index 067b778d4f..caee2d59f2 100644
--- a/Docs/Layers/elongated_coin.md
+++ b/Docs/Layers/elongated_coin.md
@@ -5,7 +5,7 @@
-
+
Layer showing penny presses.
diff --git a/Docs/Layers/entrance.md b/Docs/Layers/entrance.md
index 88c0bc0601..e9dff9523f 100644
--- a/Docs/Layers/entrance.md
+++ b/Docs/Layers/entrance.md
@@ -5,7 +5,7 @@
-
+
A layer showing entrances and offering capabilities to survey some advanced data which is important for e.g. wheelchair users (but also bicycle users, people who want to deliver, …)
diff --git a/Docs/Layers/etymology.md b/Docs/Layers/etymology.md
index efa89c1d21..abc3b9e52e 100644
--- a/Docs/Layers/etymology.md
+++ b/Docs/Layers/etymology.md
@@ -5,7 +5,7 @@
-
+
All objects which have an etymology known
diff --git a/Docs/Layers/extinguisher.md b/Docs/Layers/extinguisher.md
index a66a99075b..1cfe9fae5a 100644
--- a/Docs/Layers/extinguisher.md
+++ b/Docs/Layers/extinguisher.md
@@ -5,7 +5,7 @@
-
+
Map layer to show fire extinguishers.
diff --git a/Docs/Layers/facadegardens.md b/Docs/Layers/facadegardens.md
index de51365816..675446e07f 100644
--- a/Docs/Layers/facadegardens.md
+++ b/Docs/Layers/facadegardens.md
@@ -5,7 +5,7 @@
-
+
Facade gardens
@@ -15,6 +15,7 @@ Facade gardens
- This layer is shown at zoomlevel **12** and higher
+ - Not rendered on the map by default. If you want to rendering this on the map, override `mapRenderings`
diff --git a/Docs/Layers/fietsstraat.md b/Docs/Layers/fietsstraat.md
index dcac7d3336..ecfd974c44 100644
--- a/Docs/Layers/fietsstraat.md
+++ b/Docs/Layers/fietsstraat.md
@@ -15,6 +15,7 @@ A cyclestreet is a street where motorized traffic is not allowed to overtake a c
- This layer is shown at zoomlevel **7** and higher
+ - Not rendered on the map by default. If you want to rendering this on the map, override `mapRenderings`
diff --git a/Docs/Layers/fire_station.md b/Docs/Layers/fire_station.md
index 8d2c78525c..8fd2b6fe8c 100644
--- a/Docs/Layers/fire_station.md
+++ b/Docs/Layers/fire_station.md
@@ -5,7 +5,7 @@
-
+
Map layer to show fire stations.
diff --git a/Docs/Layers/fitness_centre.md b/Docs/Layers/fitness_centre.md
index 9d64836609..63eb517cf5 100644
--- a/Docs/Layers/fitness_centre.md
+++ b/Docs/Layers/fitness_centre.md
@@ -5,7 +5,7 @@
-
+
Layer showing fitness centres
diff --git a/Docs/Layers/fitness_station.md b/Docs/Layers/fitness_station.md
index 94a3ae10ae..43865e9574 100644
--- a/Docs/Layers/fitness_station.md
+++ b/Docs/Layers/fitness_station.md
@@ -5,7 +5,7 @@
-
+
Find a fitness station near you, and add missing ones.
diff --git a/Docs/Layers/fixme.md b/Docs/Layers/fixme.md
index 27d29ce75c..e1584d3882 100644
--- a/Docs/Layers/fixme.md
+++ b/Docs/Layers/fixme.md
@@ -5,7 +5,7 @@
-
+
OSM objects that likely need to be fixed, based on a FIXME tag.
diff --git a/Docs/Layers/food.md b/Docs/Layers/food.md
index f586efc8ee..f68097aada 100644
--- a/Docs/Layers/food.md
+++ b/Docs/Layers/food.md
@@ -5,7 +5,7 @@
-
+
A layer showing restaurants and fast-food amenities (with a special rendering for friteries)
@@ -459,6 +459,8 @@ The question is *Does this shop have a sugar free offering?*
- *This shop has no sugar free offering* corresponds with `diet:sugar_free=no`
+This tagrendering has labels `diets`
+
### gluten_free
@@ -477,6 +479,8 @@ The question is *Does this shop have a gluten free offering?*
- *This shop has no gluten free offering* corresponds with `diet:gluten_free=no`
+This tagrendering has labels `diets`
+
### lactose_free
@@ -495,6 +499,8 @@ The question is *Does {title()} have a lactose-free offering?*
- *No lactose free offering* corresponds with `diet:lactose_free=no`
+This tagrendering has labels `diets`
+
### organic (no friture)
diff --git a/Docs/Layers/friture.md b/Docs/Layers/friture.md
index 360525abc4..1ce3dc070f 100644
--- a/Docs/Layers/friture.md
+++ b/Docs/Layers/friture.md
@@ -5,7 +5,7 @@
-
+
A layer showing restaurants and fast-food amenities (with a special rendering for friteries)
@@ -455,6 +455,8 @@ The question is *Does this shop have a sugar free offering?*
- *This shop has no sugar free offering* corresponds with `diet:sugar_free=no`
+This tagrendering has labels `diets`
+
### gluten_free
@@ -473,6 +475,8 @@ The question is *Does this shop have a gluten free offering?*
- *This shop has no gluten free offering* corresponds with `diet:gluten_free=no`
+This tagrendering has labels `diets`
+
### lactose_free
@@ -491,6 +495,8 @@ The question is *Does {title()} have a lactose-free offering?*
- *No lactose free offering* corresponds with `diet:lactose_free=no`
+This tagrendering has labels `diets`
+
### organic (no friture)
diff --git a/Docs/Layers/ghost_bike.md b/Docs/Layers/ghost_bike.md
index 42c94fc945..f783680923 100644
--- a/Docs/Layers/ghost_bike.md
+++ b/Docs/Layers/ghost_bike.md
@@ -5,7 +5,7 @@
-
+
A layer showing memorials for cyclists, killed in road accidents
diff --git a/Docs/Layers/governments.md b/Docs/Layers/governments.md
index 972356e0a4..3b6b0bbe20 100644
--- a/Docs/Layers/governments.md
+++ b/Docs/Layers/governments.md
@@ -5,7 +5,7 @@
-
+
This layer show governmental buildings. It was setup as commissioned layer for the client of OSOC '22
diff --git a/Docs/Layers/guidepost.md b/Docs/Layers/guidepost.md
index e29df15475..3a5d956bdb 100644
--- a/Docs/Layers/guidepost.md
+++ b/Docs/Layers/guidepost.md
@@ -5,7 +5,7 @@
-
+
Guideposts (also known as fingerposts or finger posts) are often found along official hiking/cycling/riding/skiing routes to indicate the directions to different destinations
@@ -84,6 +84,30 @@ This tagrendering has no question and is thus read-only
+### type
+
+
+
+The question is *What kind of routes are shown on this guidepost?*
+
+
+
+
+
+ - *This guidepost shows bicycle routes* corresponds with `bicycle=yes`
+ - Unselecting this answer will add
+ - *This guidepost shows hiking routes* corresponds with `hiking=yes`
+ - Unselecting this answer will add
+ - *This guidepost shows mountain bike routes* corresponds with `mtb=yes`
+ - Unselecting this answer will add
+ - *This guidepost shows horse riding routes* corresponds with `horse=yes`
+ - Unselecting this answer will add
+ - *This guidepost shows ski routes* corresponds with `ski=yes`
+ - Unselecting this answer will add
+
+
+
+
### leftover-questions
diff --git a/Docs/Layers/hackerspace.md b/Docs/Layers/hackerspace.md
index dcf2e7d37c..2f8211c5bd 100644
--- a/Docs/Layers/hackerspace.md
+++ b/Docs/Layers/hackerspace.md
@@ -5,7 +5,7 @@
-
+
Hackerspace
diff --git a/Docs/Layers/health_and_social_places_without_etymology.md b/Docs/Layers/health_and_social_places_without_etymology.md
index 1bbd8f4e54..6b4c708097 100644
--- a/Docs/Layers/health_and_social_places_without_etymology.md
+++ b/Docs/Layers/health_and_social_places_without_etymology.md
@@ -5,7 +5,7 @@
-
+
All objects which have an etymology known
diff --git a/Docs/Layers/hospital.md b/Docs/Layers/hospital.md
index 72080c9122..8c59e95d9a 100644
--- a/Docs/Layers/hospital.md
+++ b/Docs/Layers/hospital.md
@@ -5,7 +5,7 @@
-
+
A layer showing hospital grounds
diff --git a/Docs/Layers/hotel.md b/Docs/Layers/hotel.md
index 49abe46090..630b4c9d91 100644
--- a/Docs/Layers/hotel.md
+++ b/Docs/Layers/hotel.md
@@ -5,7 +5,7 @@
-
+
Layer showing all hotels
diff --git a/Docs/Layers/hydrant.md b/Docs/Layers/hydrant.md
index c9d3fdd3b8..7e4b617c4e 100644
--- a/Docs/Layers/hydrant.md
+++ b/Docs/Layers/hydrant.md
@@ -5,7 +5,7 @@
-
+
Map layer to show fire hydrants.
diff --git a/Docs/Layers/ice_cream.md b/Docs/Layers/ice_cream.md
new file mode 100644
index 0000000000..488fd6e1ea
--- /dev/null
+++ b/Docs/Layers/ice_cream.md
@@ -0,0 +1,331 @@
+[//]: # (WARNING: this file is automatically generated. Please find the sources at the bottom and edit those sources)
+
+ ice_cream
+===========
+
+
+
+
+
+A place where ice cream is sold over the counter
+
+
+
+
+
+
+ - This layer is shown at zoomlevel **0** and higher
+
+
+
+
+#### Themes using this layer
+
+
+
+
+
+ - [icecream](https://mapcomplete.org/icecream)
+ - [personal](https://mapcomplete.org/personal)
+ - [shops](https://mapcomplete.org/shops)
+
+
+This is a special layer - data is not sourced from OpenStreetMap
+
+
+
+ Supported attributes
+----------------------
+
+
+
+Warning:
+
+this quick overview is incomplete
+
+
+
+attribute | type | values which are supported by this layer
+----------- | ------ | ------------------------------------------
+[
](https://taginfo.openstreetmap.org/keys/id#values) [id](https://wiki.openstreetmap.org/wiki/Key:id) | Multiple choice |
+[
](https://taginfo.openstreetmap.org/keys/name#values) [name](https://wiki.openstreetmap.org/wiki/Key:name) | [string](../SpecialInputElements.md#string) |
+[
](https://taginfo.openstreetmap.org/keys/opening_hours#values) [opening_hours](https://wiki.openstreetmap.org/wiki/Key:opening_hours) | [opening_hours](../SpecialInputElements.md#opening_hours) |
+[
](https://taginfo.openstreetmap.org/keys/phone#values) [phone](https://wiki.openstreetmap.org/wiki/Key:phone) | [phone](../SpecialInputElements.md#phone) |
+[
](https://taginfo.openstreetmap.org/keys/email#values) [email](https://wiki.openstreetmap.org/wiki/Key:email) | [email](../SpecialInputElements.md#email) |
+[
](https://taginfo.openstreetmap.org/keys/website#values) [website](https://wiki.openstreetmap.org/wiki/Key:website) | [url](../SpecialInputElements.md#url) |
+[
](https://taginfo.openstreetmap.org/keys/diet:sugar_free#values) [diet:sugar_free](https://wiki.openstreetmap.org/wiki/Key:diet:sugar_free) | Multiple choice | [only](https://wiki.openstreetmap.org/wiki/Tag:diet:sugar_free%3Donly) [yes](https://wiki.openstreetmap.org/wiki/Tag:diet:sugar_free%3Dyes) [limited](https://wiki.openstreetmap.org/wiki/Tag:diet:sugar_free%3Dlimited) [no](https://wiki.openstreetmap.org/wiki/Tag:diet:sugar_free%3Dno)
+[
](https://taginfo.openstreetmap.org/keys/diet:lactose_free#values) [diet:lactose_free](https://wiki.openstreetmap.org/wiki/Key:diet:lactose_free) | Multiple choice | [only](https://wiki.openstreetmap.org/wiki/Tag:diet:lactose_free%3Donly) [yes](https://wiki.openstreetmap.org/wiki/Tag:diet:lactose_free%3Dyes) [limited](https://wiki.openstreetmap.org/wiki/Tag:diet:lactose_free%3Dlimited) [no](https://wiki.openstreetmap.org/wiki/Tag:diet:lactose_free%3Dno)
+[
](https://taginfo.openstreetmap.org/keys/diet:gluten_free#values) [diet:gluten_free](https://wiki.openstreetmap.org/wiki/Key:diet:gluten_free) | Multiple choice | [only](https://wiki.openstreetmap.org/wiki/Tag:diet:gluten_free%3Donly) [yes](https://wiki.openstreetmap.org/wiki/Tag:diet:gluten_free%3Dyes) [limited](https://wiki.openstreetmap.org/wiki/Tag:diet:gluten_free%3Dlimited) [no](https://wiki.openstreetmap.org/wiki/Tag:diet:gluten_free%3Dno)
+[
](https://taginfo.openstreetmap.org/keys/wheelchair#values) [wheelchair](https://wiki.openstreetmap.org/wiki/Key:wheelchair) | Multiple choice | [designated](https://wiki.openstreetmap.org/wiki/Tag:wheelchair%3Ddesignated) [yes](https://wiki.openstreetmap.org/wiki/Tag:wheelchair%3Dyes) [limited](https://wiki.openstreetmap.org/wiki/Tag:wheelchair%3Dlimited) [no](https://wiki.openstreetmap.org/wiki/Tag:wheelchair%3Dno)
+
+
+
+
+### just_created
+
+
+
+This element shows a 'thank you' that the contributor has recently created this element
+
+This tagrendering has no question and is thus read-only
+
+
+
+
+
+ - *You just created this element! Thanks for sharing this info with the world and helping people worldwide.* corresponds with `id~.+`
+
+
+This tagrendering is only visible in the popup if the following condition is met: `_backend~.+&_last_edit:passed_time<300&|_version_number=1`
+
+
+
+### images
+
+
+
+This block shows the known images which are linked with the `image`-keys, but also via `mapillary` and `wikidata` and shows the button to upload new images
+
+This tagrendering has no question and is thus read-only
+
+
+
+
+
+### 1
+
+
+
+The question is *What is the name of this ice cream parlor?*
+
+This rendering asks information about the property [name](https://wiki.openstreetmap.org/wiki/Key:name)
+
+This is rendered with `This ice cream parlor is named {name}`
+
+
+
+
+
+### opening_hours
+
+
+
+The question is *What are the opening hours of {title()}?*
+
+This rendering asks information about the property [opening_hours](https://wiki.openstreetmap.org/wiki/Key:opening_hours)
+
+This is rendered with `Opening hours
{opening_hours_table(opening_hours)}`
+
+
+
+
+
+### phone
+
+
+
+The question is *What is the phone number of {title()}?*
+
+This rendering asks information about the property [phone](https://wiki.openstreetmap.org/wiki/Key:phone)
+
+This is rendered with `{phone}`
+
+
+
+
+
+ - *{contact:phone}* corresponds with `contact:phone~.+`
+ - This option cannot be chosen as answer
+
+
+This tagrendering has labels `contact`
+
+
+
+### email
+
+
+
+The question is *What is the email address of {title()}?*
+
+This rendering asks information about the property [email](https://wiki.openstreetmap.org/wiki/Key:email)
+
+This is rendered with `{email}`
+
+
+
+
+
+ - *{contact:email}* corresponds with `contact:email~.+`
+ - This option cannot be chosen as answer
+
+
+This tagrendering has labels `contact`
+
+
+
+### website
+
+
+
+The question is *What is the website of {title()}?*
+
+This rendering asks information about the property [website](https://wiki.openstreetmap.org/wiki/Key:website)
+
+This is rendered with `{website}`
+
+
+
+
+
+ - *{contact:website}* corresponds with `contact:website~.+`
+ - This option cannot be chosen as answer
+
+
+This tagrendering has labels `contact`
+
+
+
+### sugar_free
+
+
+
+The question is *Does this shop have a sugar free offering?*
+
+
+
+
+
+ - *This shop only sells sugar free products* corresponds with `diet:sugar_free=only`
+ - *This shop has a big sugar free offering* corresponds with `diet:sugar_free=yes`
+ - *This shop has a limited sugar free offering* corresponds with `diet:sugar_free=limited`
+ - *This shop has no sugar free offering* corresponds with `diet:sugar_free=no`
+
+
+This tagrendering has labels `diets`
+
+
+
+### lactose_free
+
+
+
+The question is *Does {title()} have a lactose-free offering?*
+
+
+
+
+
+ - *Only sells lactose free products* corresponds with `diet:lactose_free=only`
+ - *Big lactose free offering* corresponds with `diet:lactose_free=yes`
+ - *Limited lactose free offering* corresponds with `diet:lactose_free=limited`
+ - *No lactose free offering* corresponds with `diet:lactose_free=no`
+
+
+This tagrendering has labels `diets`
+
+
+
+### gluten_free
+
+
+
+The question is *Does this shop have a gluten free offering?*
+
+
+
+
+
+ - *This shop only sells gluten free products* corresponds with `diet:gluten_free=only`
+ - *This shop has a big gluten free offering* corresponds with `diet:gluten_free=yes`
+ - *This shop has a limited gluten free offering* corresponds with `diet:gluten_free=limited`
+ - *This shop has no gluten free offering* corresponds with `diet:gluten_free=no`
+
+
+This tagrendering has labels `diets`
+
+
+
+### payment-options
+
+
+
+The question is *Which methods of payment are accepted here?*
+
+
+
+
+
+ - *Cash is accepted here* corresponds with `payment:cash=yes`
+ - Unselecting this answer will add payment:cash=no
+ - *Payment cards are accepted here* corresponds with `payment:cards=yes`
+ - Unselecting this answer will add payment:cards=no
+ - *Payment by QR-code is possible here* corresponds with `payment:qr_code=yes`
+ - Unselecting this answer will add payment:qr_code=no
+
+
+
+
+### wheelchair-access
+
+
+
+The question is *Is this place accessible with a wheelchair?*
+
+
+
+
+
+ - *This place is specially adapted for wheelchair users* corresponds with `wheelchair=designated`
+ - *This place is easily reachable with a wheelchair* corresponds with `wheelchair=yes`
+ - *It is possible to reach this place in a wheelchair, but it is not easy* corresponds with `wheelchair=limited`
+ - *This place is not reachable with a wheelchair* corresponds with `wheelchair=no`
+
+
+
+
+### leftover-questions
+
+
+
+This tagrendering has no question and is thus read-only
+
+
+
+
+
+### minimap
+
+
+
+Shows a small map with the feature. Added by default to every popup
+
+This tagrendering has no question and is thus read-only
+
+
+
+
+
+### last_edit
+
+
+
+Gives some metainfo about the last edit and who did edit it - rendering only
+
+This tagrendering has no question and is thus read-only
+
+
+
+This tagrendering is only visible in the popup if the following condition is met: `_last_edit:contributor~.+&_last_edit:changeset~.+`
+
+
+
+### all-tags
+
+
+
+This tagrendering has no question and is thus read-only
+
+
+
+This document is autogenerated from [assets/layers/ice_cream/ice_cream.json](https://github.com/pietervdvn/MapComplete/blob/develop/assets/layers/ice_cream/ice_cream.json)
diff --git a/Docs/Layers/information_board.md b/Docs/Layers/information_board.md
index 91a1e483aa..2d4c18a822 100644
--- a/Docs/Layers/information_board.md
+++ b/Docs/Layers/information_board.md
@@ -5,7 +5,7 @@
-
+
A layer showing touristical, road side information boards (e.g. giving information about the landscape, a building, a feature, a map, …)
diff --git a/Docs/Layers/kerbs.md b/Docs/Layers/kerbs.md
index b507121f7b..a1fce7292a 100644
--- a/Docs/Layers/kerbs.md
+++ b/Docs/Layers/kerbs.md
@@ -5,7 +5,7 @@
-
+
A layer showing kerbs.
diff --git a/Docs/Layers/map.md b/Docs/Layers/map.md
index 356ce84e98..79a7f7c63b 100644
--- a/Docs/Layers/map.md
+++ b/Docs/Layers/map.md
@@ -5,7 +5,7 @@
-
+
A map, meant for tourists which is permanently installed in the public space
diff --git a/Docs/Layers/maproulette.md b/Docs/Layers/maproulette.md
index 2b0ba2e15a..37a46da462 100644
--- a/Docs/Layers/maproulette.md
+++ b/Docs/Layers/maproulette.md
@@ -5,7 +5,7 @@
-
+
Layer showing all tasks in MapRoulette
diff --git a/Docs/Layers/maproulette_challenge.md b/Docs/Layers/maproulette_challenge.md
index ed3c2e770b..ad32cd993d 100644
--- a/Docs/Layers/maproulette_challenge.md
+++ b/Docs/Layers/maproulette_challenge.md
@@ -5,7 +5,7 @@
-
+
Layer showing tasks of a single MapRoulette challenge. This layer is intended to be reused and extended in themes; refer to [the documentation](https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Integrating_Maproulette.md) on how to do this.
diff --git a/Docs/Layers/medical-shops.md b/Docs/Layers/medical-shops.md
index 94a4aaacb6..6399c69240 100644
--- a/Docs/Layers/medical-shops.md
+++ b/Docs/Layers/medical-shops.md
@@ -5,7 +5,7 @@
-
+
A shop
@@ -47,7 +47,7 @@ attribute | type | values which are supported by this layer
----------- | ------ | ------------------------------------------
[
](https://taginfo.openstreetmap.org/keys/id#values) [id](https://wiki.openstreetmap.org/wiki/Key:id) | Multiple choice |
[
](https://taginfo.openstreetmap.org/keys/name#values) [name](https://wiki.openstreetmap.org/wiki/Key:name) | [string](../SpecialInputElements.md#string) |
-[
](https://taginfo.openstreetmap.org/keys/shop#values) [shop](https://wiki.openstreetmap.org/wiki/Key:shop) | [string](../SpecialInputElements.md#string) | [agrarian](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dagrarian) [alcohol](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dalcohol) [anime](https://wiki.openstreetmap.org/wiki/Tag:shop%3Danime) [antiques](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dantiques) [appliance](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dappliance) [art](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dart) [baby_goods](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbaby_goods) [bag](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbag) [bakery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbakery) [bathroom_furnishing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbathroom_furnishing) [beauty](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbeauty) [bed](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbed) [beverages](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbeverages) [bicycle](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbicycle) [boat](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dboat) [bookmaker](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbookmaker) [books](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbooks) [brewing_supplies](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbrewing_supplies) [butcher](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbutcher) [camera](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcamera) [candles](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcandles) [cannabis](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcannabis) [car](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar) [car_parts](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar_parts) [car_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar_repair) [caravan](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcaravan) [carpet](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcarpet) [catalogue](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcatalogue) [charity](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcharity) [cheese](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcheese) [chemist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dchemist) [chocolate](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dchocolate) [clothes](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dclothes) [coffee](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcoffee) [collector](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcollector) [computer](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcomputer) [confectionery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dconfectionery) [convenience](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dconvenience) [copyshop](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcopyshop) [cosmetics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcosmetics) [country_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcountry_store) [craft](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcraft) [curtain](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcurtain) [dairy](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddairy) [deli](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddeli) [department_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddepartment_store) [doityourself](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddoityourself) [doors](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddoors) [dry_cleaning](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddry_cleaning) [e-cigarette](https://wiki.openstreetmap.org/wiki/Tag:shop%3De-cigarette) [electrical](https://wiki.openstreetmap.org/wiki/Tag:shop%3Delectrical) [electronics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Delectronics) [erotic](https://wiki.openstreetmap.org/wiki/Tag:shop%3Derotic) [fabric](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfabric) [farm](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfarm) [fashion_accessories](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfashion_accessories) [fireplace](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfireplace) [fishing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfishing) [flooring](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dflooring) [florist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dflorist) [frame](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dframe) [frozen_food](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfrozen_food) [fuel](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfuel) [funeral_directors](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfuneral_directors) [furniture](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfurniture) [games](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgames) [garden_centre](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgarden_centre) [gas](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgas) [general](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgeneral) [gift](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgift) [greengrocer](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgreengrocer) [hairdresser](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhairdresser) [hairdresser_supply](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhairdresser_supply) [hardware](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhardware) [health_food](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhealth_food) [hearing_aids](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhearing_aids) [herbalist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dherbalist) [hifi](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhifi) [hobby](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhobby) [household_linen](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhousehold_linen) [houseware](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhouseware) [hunting](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhunting) [interior_decoration](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dinterior_decoration) [jewelry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Djewelry) [kiosk](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dkiosk) [kitchen](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dkitchen) [laundry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlaundry) [leather](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dleather) [lighting](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlighting) [locksmith](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlocksmith) [lottery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlottery) [mall](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmall) [massage](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmassage) [medical_supply](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmedical_supply) [military_surplus](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmilitary_surplus) [mobile_phone](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmobile_phone) [model](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmodel) [money_lender](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmoney_lender) [motorcycle](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmotorcycle) [motorcycle_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmotorcycle_repair) [music](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmusic) [musical_instrument](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmusical_instrument) [newsagent](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dnewsagent) [nutrition_supplements](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dnutrition_supplements) [optician](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doptician) [outdoor](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doutdoor) [outpost](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doutpost) [paint](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpaint) [party](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dparty) [pastry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpastry) [pawnbroker](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpawnbroker) [perfumery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dperfumery) [pet](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpet) [pet_grooming](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpet_grooming) [photo](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dphoto) [pottery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpottery) [printer_ink](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dprinter_ink) [psychic](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpsychic) [pyrotechnics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpyrotechnics) [radiotechnics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dradiotechnics) [religion](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dreligion) [rental](https://wiki.openstreetmap.org/wiki/Tag:shop%3Drental) [repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Drepair) [scuba_diving](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dscuba_diving) [seafood](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dseafood) [second_hand](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsecond_hand) [sewing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsewing) [shoe_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dshoe_repair) [shoes](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dshoes) [spices](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dspices) [sports](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsports) [stationery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dstationery) [storage_rental](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dstorage_rental) [supermarket](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsupermarket) [swimming_pool](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dswimming_pool) [tailor](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtailor) [tattoo](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtattoo) [tea](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtea) [telecommunication](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtelecommunication) [ticket](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dticket) [tiles](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtiles) [tobacco](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtobacco) [tool_hire](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtool_hire) [toys](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtoys) [trade](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtrade) [travel_agency](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtravel_agency) [trophy](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtrophy) [tyres](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtyres) [vacuum_cleaner](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvacuum_cleaner) [variety_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvariety_store) [video](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvideo) [video_games](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvideo_games) [watches](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwatches) [water](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwater) [water_sports](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwater_sports) [weapons](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dweapons) [wholesale](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwholesale) [wigs](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwigs) [window_blind](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwindow_blind) [wine](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwine)
+[
](https://taginfo.openstreetmap.org/keys/shop#values) [shop](https://wiki.openstreetmap.org/wiki/Key:shop) | [string](../SpecialInputElements.md#string) | [vacant](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvacant) [agrarian](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dagrarian) [alcohol](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dalcohol) [anime](https://wiki.openstreetmap.org/wiki/Tag:shop%3Danime) [antiques](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dantiques) [appliance](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dappliance) [art](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dart) [baby_goods](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbaby_goods) [bag](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbag) [bakery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbakery) [bathroom_furnishing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbathroom_furnishing) [beauty](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbeauty) [bed](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbed) [beverages](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbeverages) [bicycle](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbicycle) [boat](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dboat) [bookmaker](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbookmaker) [books](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbooks) [brewing_supplies](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbrewing_supplies) [butcher](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbutcher) [camera](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcamera) [candles](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcandles) [cannabis](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcannabis) [car](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar) [car_parts](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar_parts) [car_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar_repair) [caravan](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcaravan) [carpet](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcarpet) [catalogue](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcatalogue) [charity](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcharity) [cheese](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcheese) [chemist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dchemist) [chocolate](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dchocolate) [clothes](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dclothes) [coffee](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcoffee) [collector](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcollector) [computer](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcomputer) [confectionery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dconfectionery) [convenience](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dconvenience) [copyshop](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcopyshop) [cosmetics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcosmetics) [country_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcountry_store) [craft](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcraft) [curtain](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcurtain) [dairy](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddairy) [deli](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddeli) [department_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddepartment_store) [doityourself](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddoityourself) [doors](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddoors) [dry_cleaning](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddry_cleaning) [e-cigarette](https://wiki.openstreetmap.org/wiki/Tag:shop%3De-cigarette) [electrical](https://wiki.openstreetmap.org/wiki/Tag:shop%3Delectrical) [electronics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Delectronics) [erotic](https://wiki.openstreetmap.org/wiki/Tag:shop%3Derotic) [fabric](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfabric) [farm](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfarm) [fashion_accessories](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfashion_accessories) [fireplace](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfireplace) [fishing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfishing) [flooring](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dflooring) [florist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dflorist) [frame](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dframe) [frozen_food](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfrozen_food) [fuel](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfuel) [funeral_directors](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfuneral_directors) [furniture](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfurniture) [games](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgames) [garden_centre](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgarden_centre) [gas](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgas) [general](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgeneral) [gift](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgift) [greengrocer](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgreengrocer) [hairdresser](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhairdresser) [hairdresser_supply](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhairdresser_supply) [hardware](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhardware) [health_food](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhealth_food) [hearing_aids](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhearing_aids) [herbalist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dherbalist) [hifi](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhifi) [honey](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhoney) [household_linen](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhousehold_linen) [houseware](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhouseware) [hunting](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhunting) [interior_decoration](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dinterior_decoration) [jewelry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Djewelry) [kiosk](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dkiosk) [kitchen](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dkitchen) [laundry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlaundry) [leather](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dleather) [lighting](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlighting) [locksmith](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlocksmith) [lottery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlottery) [mall](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmall) [massage](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmassage) [medical_supply](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmedical_supply) [military_surplus](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmilitary_surplus) [mobile_phone](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmobile_phone) [model](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmodel) [money_lender](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmoney_lender) [motorcycle](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmotorcycle) [motorcycle_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmotorcycle_repair) [music](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmusic) [musical_instrument](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmusical_instrument) [newsagent](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dnewsagent) [nutrition_supplements](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dnutrition_supplements) [nuts](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dnuts) [optician](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doptician) [outdoor](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doutdoor) [outpost](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doutpost) [paint](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpaint) [party](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dparty) [pasta](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpasta) [pastry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpastry) [pawnbroker](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpawnbroker) [perfumery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dperfumery) [pet](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpet) [pet_grooming](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpet_grooming) [photo](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dphoto) [pottery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpottery) [printer_ink](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dprinter_ink) [psychic](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpsychic) [pyrotechnics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpyrotechnics) [radiotechnics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dradiotechnics) [religion](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dreligion) [rental](https://wiki.openstreetmap.org/wiki/Tag:shop%3Drental) [repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Drepair) [rice](https://wiki.openstreetmap.org/wiki/Tag:shop%3Drice) [scuba_diving](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dscuba_diving) [seafood](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dseafood) [second_hand](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsecond_hand) [sewing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsewing) [shoe_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dshoe_repair) [shoes](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dshoes) [spices](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dspices) [sports](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsports) [stationery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dstationery) [storage_rental](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dstorage_rental) [supermarket](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsupermarket) [swimming_pool](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dswimming_pool) [tailor](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtailor) [tattoo](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtattoo) [tea](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtea) [telecommunication](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtelecommunication) [ticket](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dticket) [tiles](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtiles) [tobacco](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtobacco) [tool_hire](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtool_hire) [toys](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtoys) [trade](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtrade) [travel_agency](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtravel_agency) [trophy](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtrophy) [tyres](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtyres) [vacuum_cleaner](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvacuum_cleaner) [variety_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvariety_store) [video](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvideo) [video_games](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvideo_games) [watches](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwatches) [water](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwater) [water_sports](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwater_sports) [weapons](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dweapons) [wholesale](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwholesale) [wigs](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwigs) [window_blind](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwindow_blind) [wine](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwine)
[
](https://taginfo.openstreetmap.org/keys/second_hand#values) [second_hand](https://wiki.openstreetmap.org/wiki/Key:second_hand) | Multiple choice | [only](https://wiki.openstreetmap.org/wiki/Tag:second_hand%3Donly) [yes](https://wiki.openstreetmap.org/wiki/Tag:second_hand%3Dyes) [no](https://wiki.openstreetmap.org/wiki/Tag:second_hand%3Dno)
[
](https://taginfo.openstreetmap.org/keys/opening_hours#values) [opening_hours](https://wiki.openstreetmap.org/wiki/Key:opening_hours) | [opening_hours](../SpecialInputElements.md#opening_hours) |
[
](https://taginfo.openstreetmap.org/keys/website#values) [website](https://wiki.openstreetmap.org/wiki/Key:website) | [url](../SpecialInputElements.md#url) |
@@ -124,10 +124,11 @@ This is rendered with `This is a {shop}`
+ - *Vacant Shop* corresponds with `shop=vacant`
- *Farm Supply Shop* corresponds with `shop=agrarian`
- *Liquor Store* corresponds with `shop=alcohol`
- *Anime / Manga Shop* corresponds with `shop=anime`
- - *Antiques Shop* corresponds with `shop=antiques`
+ - *Antique Shop* corresponds with `shop=antiques`
- *Appliance Store* corresponds with `shop=appliance`
- *Art Store* corresponds with `shop=art`
- *Baby Goods Store* corresponds with `shop=baby_goods`
@@ -140,7 +141,7 @@ This is rendered with `This is a {shop}`
- *Bicycle Shop* corresponds with `shop=bicycle`
- *Boat Store* corresponds with `shop=boat`
- *Bookmaker* corresponds with `shop=bookmaker`
- - *Book Store* corresponds with `shop=books`
+ - *Bookstore* corresponds with `shop=books`
- *Brewing Supply Store* corresponds with `shop=brewing_supplies`
- *Butcher* corresponds with `shop=butcher`
- *Camera Equipment Store* corresponds with `shop=camera`
@@ -164,11 +165,11 @@ This is rendered with `This is a {shop}`
- *Convenience Store* corresponds with `shop=convenience`
- *Copy Store* corresponds with `shop=copyshop`
- *Cosmetics Store* corresponds with `shop=cosmetics`
- - *Country Store* corresponds with `shop=country_store`
+ - *Rural Supplies Store* corresponds with `shop=country_store`
- *Arts & Crafts Store* corresponds with `shop=craft`
- *Curtain Store* corresponds with `shop=curtain`
- *Dairy Store* corresponds with `shop=dairy`
- - *Deli* corresponds with `shop=deli`
+ - *Delicatessen* corresponds with `shop=deli`
- *Department Store* corresponds with `shop=department_store`
- *DIY Store* corresponds with `shop=doityourself`
- *Door Shop* corresponds with `shop=doors`
@@ -198,11 +199,11 @@ This is rendered with `This is a {shop}`
- *Hairdresser* corresponds with `shop=hairdresser`
- *Hairdresser Supply Store* corresponds with `shop=hairdresser_supply`
- *Hardware Store* corresponds with `shop=hardware`
- - *Health Food Shop* corresponds with `shop=health_food`
+ - *Health Food Store* corresponds with `shop=health_food`
- *Hearing Aids Store* corresponds with `shop=hearing_aids`
- *Herbalist* corresponds with `shop=herbalist`
- *Hifi Store* corresponds with `shop=hifi`
- - *Hobby Shop* corresponds with `shop=hobby`
+ - *Honey Store* corresponds with `shop=honey`
- *Household Linen Shop* corresponds with `shop=household_linen`
- *Houseware Store* corresponds with `shop=houseware`
- *Hunting Shop* corresponds with `shop=hunting`
@@ -226,18 +227,20 @@ This is rendered with `This is a {shop}`
- *Motorcycle Repair Shop* corresponds with `shop=motorcycle_repair`
- *Music Store* corresponds with `shop=music`
- *Musical Instrument Store* corresponds with `shop=musical_instrument`
- - *Newspaper/Magazine Shop* corresponds with `shop=newsagent`
+ - *Newsstand* corresponds with `shop=newsagent`
- *Nutrition Supplements Store* corresponds with `shop=nutrition_supplements`
+ - *Nuts Shop* corresponds with `shop=nuts`
- *Optician* corresponds with `shop=optician`
- *Outdoors Store* corresponds with `shop=outdoor`
- *Online Retailer Outpost* corresponds with `shop=outpost`
- *Paint Store* corresponds with `shop=paint`
- *Party Supply Store* corresponds with `shop=party`
+ - *Pasta Store* corresponds with `shop=pasta`
- *Pastry Shop* corresponds with `shop=pastry`
- - *Pawn Shop* corresponds with `shop=pawnbroker`
+ - *Pawnshop* corresponds with `shop=pawnbroker`
- *Perfume Store* corresponds with `shop=perfumery`
- *Pet Store* corresponds with `shop=pet`
- - *Pet Grooming Store* corresponds with `shop=pet_grooming`
+ - *Pet Groomer* corresponds with `shop=pet_grooming`
- *Photography Store* corresponds with `shop=photo`
- *Pottery Store* corresponds with `shop=pottery`
- *Printer Ink Store* corresponds with `shop=printer_ink`
@@ -247,9 +250,10 @@ This is rendered with `This is a {shop}`
- *Religious Store* corresponds with `shop=religion`
- *Rental Shop* corresponds with `shop=rental`
- *Repair Shop* corresponds with `shop=repair`
+ - *Rice Store* corresponds with `shop=rice`
- *Scuba Diving Shop* corresponds with `shop=scuba_diving`
- *Seafood Shop* corresponds with `shop=seafood`
- - *Consignment/Thrift Store* corresponds with `shop=second_hand`
+ - *Thrift Store* corresponds with `shop=second_hand`
- *Sewing Supply Shop* corresponds with `shop=sewing`
- *Shoe Repair Shop* corresponds with `shop=shoe_repair`
- *Shoe Store* corresponds with `shop=shoes`
@@ -273,7 +277,7 @@ This is rendered with `This is a {shop}`
- *Trophy Shop* corresponds with `shop=trophy`
- *Tire Store* corresponds with `shop=tyres`
- *Vacuum Cleaner Store* corresponds with `shop=vacuum_cleaner`
- - *Variety Store* corresponds with `shop=variety_store`
+ - *Discount Store* corresponds with `shop=variety_store`
- *Video Store* corresponds with `shop=video`
- *Video Game Store* corresponds with `shop=video_games`
- *Watches Shop* corresponds with `shop=watches`
@@ -474,6 +478,25 @@ This tagrendering is only visible in the popup if the following condition is met
+### key_cutter
+
+
+
+This tagrendering has no question and is thus read-only
+
+
+
+
+
+ - *This shop is also specialized in key cutting* corresponds with `craft=key_cutter`
+ - *This shop offers key cutting as a service* corresponds with `service:key_cutting=yes`
+ - *This shops does not offer key cutting as a service* corresponds with `service:key_cutting=no`
+
+
+This tagrendering is only visible in the popup if the following condition is met: `shop=shoe_repair|service:key_cutting~.+|craft=key_cutting|shop=diy|shop=doityourself|shop=home_improvement|shop=hardware|shop=locksmith|shop=repair`
+
+
+
### internet
@@ -571,6 +594,8 @@ The question is *Does this shop have a sugar free offering?*
This tagrendering is only visible in the popup if the following condition is met: `shop=supermarket|shop=convenience|shop=farm|shop=greengrocer|shop=health_food|shop=deli|shop=bakery|shop=beverages|shop=beverages|shop=pastry|shop=chocolate|shop=frozen_food|shop=ice_cream`
+This tagrendering has labels `diets`
+
### gluten_free
@@ -591,6 +616,8 @@ The question is *Does this shop have a gluten free offering?*
This tagrendering is only visible in the popup if the following condition is met: `shop=supermarket|shop=convenience|shop=farm|shop=greengrocer|shop=health_food|shop=deli|shop=bakery|shop=beverages|shop=beverages|shop=pastry|shop=chocolate|shop=frozen_food|shop=ice_cream`
+This tagrendering has labels `diets`
+
### lactose_free
@@ -611,6 +638,8 @@ The question is *Does {title()} have a lactose-free offering?*
This tagrendering is only visible in the popup if the following condition is met: `shop=supermarket|shop=convenience|shop=farm|shop=greengrocer|shop=health_food|shop=deli|shop=bakery|shop=beverages|shop=beverages|shop=pastry|shop=chocolate|shop=frozen_food|shop=ice_cream`
+This tagrendering has labels `diets`
+
### questions
diff --git a/Docs/Layers/memorial.md b/Docs/Layers/memorial.md
index 9a0c26614a..83ffd08618 100644
--- a/Docs/Layers/memorial.md
+++ b/Docs/Layers/memorial.md
@@ -5,7 +5,7 @@
-
+
Layer showing memorial plaques, based upon a unofficial theme. Can be expanded to have multiple types of memorials later on
diff --git a/Docs/Layers/nature_reserve.md b/Docs/Layers/nature_reserve.md
index a34adf70a6..a0a061cc9a 100644
--- a/Docs/Layers/nature_reserve.md
+++ b/Docs/Layers/nature_reserve.md
@@ -5,7 +5,7 @@
-
+
A nature reserve is an area where nature can take its course
diff --git a/Docs/Layers/note.md b/Docs/Layers/note.md
index 50b4f1db6b..386584e785 100644
--- a/Docs/Layers/note.md
+++ b/Docs/Layers/note.md
@@ -5,7 +5,7 @@
-
+
This layer shows notes on OpenStreetMap. Having this layer in your theme will trigger the 'add new note' functionality in the 'addNewPoint'-popup (or if your theme has no presets, it'll enable adding notes)
diff --git a/Docs/Layers/observation_tower.md b/Docs/Layers/observation_tower.md
index 47dc364538..b2bd50097f 100644
--- a/Docs/Layers/observation_tower.md
+++ b/Docs/Layers/observation_tower.md
@@ -5,7 +5,7 @@
-
+
Towers with a panoramic view
diff --git a/Docs/Layers/osm_community_index.md b/Docs/Layers/osm_community_index.md
index 94f7da38d6..a614f7450e 100644
--- a/Docs/Layers/osm_community_index.md
+++ b/Docs/Layers/osm_community_index.md
@@ -5,7 +5,7 @@
-
+
A layer showing the OpenStreetMap Communities
diff --git a/Docs/Layers/parcel_lockers.md b/Docs/Layers/parcel_lockers.md
index d46c6021e6..b37b128d67 100644
--- a/Docs/Layers/parcel_lockers.md
+++ b/Docs/Layers/parcel_lockers.md
@@ -5,7 +5,7 @@
-
+
Layer showing parcel lockers for collecting and sending parcels.
diff --git a/Docs/Layers/parking.md b/Docs/Layers/parking.md
index 6856d586d0..962a75b35d 100644
--- a/Docs/Layers/parking.md
+++ b/Docs/Layers/parking.md
@@ -5,7 +5,7 @@
-
+
A layer showing car parkings
diff --git a/Docs/Layers/parking_spaces.md b/Docs/Layers/parking_spaces.md
index 23d9cf06f5..42187e8dff 100644
--- a/Docs/Layers/parking_spaces.md
+++ b/Docs/Layers/parking_spaces.md
@@ -5,7 +5,7 @@
-
+
Layer showing individual parking spaces.
@@ -14,7 +14,7 @@ Layer showing individual parking spaces.
- - This layer is shown at zoomlevel **19** and higher
+ - This layer is shown at zoomlevel **18** and higher
diff --git a/Docs/Layers/parking_ticket_machine.md b/Docs/Layers/parking_ticket_machine.md
index 84760f725c..712e95d1ca 100644
--- a/Docs/Layers/parking_ticket_machine.md
+++ b/Docs/Layers/parking_ticket_machine.md
@@ -5,7 +5,7 @@
-
+
Layer with parking ticket machines to pay for parking.
diff --git a/Docs/Layers/parks_and_forests_without_etymology.md b/Docs/Layers/parks_and_forests_without_etymology.md
index 0abbb8ef50..e913071985 100644
--- a/Docs/Layers/parks_and_forests_without_etymology.md
+++ b/Docs/Layers/parks_and_forests_without_etymology.md
@@ -5,7 +5,7 @@
-
+
All objects which have an etymology known
diff --git a/Docs/Layers/pedestrian_path.md b/Docs/Layers/pedestrian_path.md
index 02ff931dc3..117ff3dc27 100644
--- a/Docs/Layers/pedestrian_path.md
+++ b/Docs/Layers/pedestrian_path.md
@@ -5,7 +5,7 @@
-
+
Pedestrian footpaths, especially used for indoor navigation and snapping entrances to this layer
diff --git a/Docs/Layers/pharmacy.md b/Docs/Layers/pharmacy.md
index e3232cad2c..9c91a38b6d 100644
--- a/Docs/Layers/pharmacy.md
+++ b/Docs/Layers/pharmacy.md
@@ -5,7 +5,7 @@
-
+
A layer showing pharmacies, which (probably) dispense prescription drugs
diff --git a/Docs/Layers/physiotherapist.md b/Docs/Layers/physiotherapist.md
index d8b177c5d3..08e3cc1adc 100644
--- a/Docs/Layers/physiotherapist.md
+++ b/Docs/Layers/physiotherapist.md
@@ -5,7 +5,7 @@
-
+
This layer shows physiotherapists
diff --git a/Docs/Layers/picnic_table.md b/Docs/Layers/picnic_table.md
index 0896279513..c549a0203a 100644
--- a/Docs/Layers/picnic_table.md
+++ b/Docs/Layers/picnic_table.md
@@ -5,7 +5,7 @@
-
+
The layer showing picnic tables
diff --git a/Docs/Layers/play_forest.md b/Docs/Layers/play_forest.md
index 034da95cdf..060fb433d1 100644
--- a/Docs/Layers/play_forest.md
+++ b/Docs/Layers/play_forest.md
@@ -5,7 +5,7 @@
-
+
Een speelbos is een vrij toegankelijke zone in een bos
diff --git a/Docs/Layers/playground.md b/Docs/Layers/playground.md
index f02e655958..7be594d82e 100644
--- a/Docs/Layers/playground.md
+++ b/Docs/Layers/playground.md
@@ -5,7 +5,7 @@
-
+
Playgrounds
diff --git a/Docs/Layers/post_offices_with_atm.md b/Docs/Layers/post_offices_with_atm.md
index 623b5615c8..003eee6964 100644
--- a/Docs/Layers/post_offices_with_atm.md
+++ b/Docs/Layers/post_offices_with_atm.md
@@ -5,7 +5,7 @@
-
+
A layer showing post offices.
diff --git a/Docs/Layers/postboxes.md b/Docs/Layers/postboxes.md
index 2d68645078..2c54c42693 100644
--- a/Docs/Layers/postboxes.md
+++ b/Docs/Layers/postboxes.md
@@ -5,7 +5,7 @@
-
+
The layer showing postboxes.
diff --git a/Docs/Layers/postoffices.md b/Docs/Layers/postoffices.md
index ae2ee83407..a257e61009 100644
--- a/Docs/Layers/postoffices.md
+++ b/Docs/Layers/postoffices.md
@@ -5,7 +5,7 @@
-
+
A layer showing post offices.
diff --git a/Docs/Layers/public_bookcase.md b/Docs/Layers/public_bookcase.md
index 2583464a3a..e21fc13645 100644
--- a/Docs/Layers/public_bookcase.md
+++ b/Docs/Layers/public_bookcase.md
@@ -5,7 +5,7 @@
-
+
A streetside cabinet with books, accessible to anyone
diff --git a/Docs/Layers/railway_platforms.md b/Docs/Layers/railway_platforms.md
index 9e9a075d8d..ba20272557 100644
--- a/Docs/Layers/railway_platforms.md
+++ b/Docs/Layers/railway_platforms.md
@@ -5,7 +5,7 @@
-
+
Find every platform in the station, and the train routes that use them.
diff --git a/Docs/Layers/rainbow_crossing_high_zoom.md b/Docs/Layers/rainbow_crossing_high_zoom.md
index 35cb22949b..f2cae84c90 100644
--- a/Docs/Layers/rainbow_crossing_high_zoom.md
+++ b/Docs/Layers/rainbow_crossing_high_zoom.md
@@ -5,7 +5,7 @@
-
+
A layer showing pedestrian crossings with rainbow paintings
diff --git a/Docs/Layers/rainbow_crossings.md b/Docs/Layers/rainbow_crossings.md
index e3c50abd71..4b092d6ba3 100644
--- a/Docs/Layers/rainbow_crossings.md
+++ b/Docs/Layers/rainbow_crossings.md
@@ -5,7 +5,7 @@
-
+
A layer showing pedestrian crossings with rainbow paintings
diff --git a/Docs/Layers/reception_desk.md b/Docs/Layers/reception_desk.md
index be0164aa8e..ab03fef8c1 100644
--- a/Docs/Layers/reception_desk.md
+++ b/Docs/Layers/reception_desk.md
@@ -5,7 +5,7 @@
-
+
A layer showing where the reception desks are and which asks some accessibility information
diff --git a/Docs/Layers/recycling.md b/Docs/Layers/recycling.md
index 4157a58494..59b45eaa54 100644
--- a/Docs/Layers/recycling.md
+++ b/Docs/Layers/recycling.md
@@ -5,7 +5,7 @@
-
+
A layer with recycling containers and centres
diff --git a/Docs/Layers/route_marker.md b/Docs/Layers/route_marker.md
new file mode 100644
index 0000000000..625650f104
--- /dev/null
+++ b/Docs/Layers/route_marker.md
@@ -0,0 +1,161 @@
+[//]: # (WARNING: this file is automatically generated. Please find the sources at the bottom and edit those sources)
+
+ route_marker
+==============
+
+
+
+
+
+Route markers are small markers often found along official hiking/cycling/riding/skiing routes to indicate the direction of the route.
+
+
+
+
+
+
+ - This layer is shown at zoomlevel **14** and higher
+
+
+This is a special layer - data is not sourced from OpenStreetMap
+
+
+
+ Supported attributes
+----------------------
+
+
+
+Warning:
+
+this quick overview is incomplete
+
+
+
+attribute | type | values which are supported by this layer
+----------- | ------ | ------------------------------------------
+[
](https://taginfo.openstreetmap.org/keys/id#values) [id](https://wiki.openstreetmap.org/wiki/Key:id) | Multiple choice |
+
+
+
+
+### just_created
+
+
+
+This element shows a 'thank you' that the contributor has recently created this element
+
+This tagrendering has no question and is thus read-only
+
+
+
+
+
+ - *You just created this element! Thanks for sharing this info with the world and helping people worldwide.* corresponds with `id~.+`
+
+
+This tagrendering is only visible in the popup if the following condition is met: `_backend~.+&_last_edit:passed_time<300&|_version_number=1`
+
+
+
+### images
+
+
+
+This block shows the known images which are linked with the `image`-keys, but also via `mapillary` and `wikidata` and shows the button to upload new images
+
+This tagrendering has no question and is thus read-only
+
+
+
+
+
+### type
+
+
+
+The question is *For what kind of route is this marker?*
+
+
+
+
+
+ - *This is a route marker for a bicycle route.* corresponds with `bicycle=yes`
+ - Unselecting this answer will add
+ - *This is a route marker for a hiking route.* corresponds with `hiking=yes`
+ - Unselecting this answer will add
+ - *This is a route marker for a mountain bike route.* corresponds with `mtb=yes`
+ - Unselecting this answer will add
+ - *This is a route marker for a horse riding route.* corresponds with `horse=yes`
+ - Unselecting this answer will add
+ - *This is a route marker for a ski route.* corresponds with `ski=yes`
+ - Unselecting this answer will add
+
+
+
+
+### leftover-questions
+
+
+
+This tagrendering has no question and is thus read-only
+
+
+
+
+
+### minimap
+
+
+
+Shows a small map with the feature. Added by default to every popup
+
+This tagrendering has no question and is thus read-only
+
+
+
+
+
+### move-button
+
+
+
+This tagrendering has no question and is thus read-only
+
+
+
+
+
+### delete-button
+
+
+
+This tagrendering has no question and is thus read-only
+
+
+
+
+
+### last_edit
+
+
+
+Gives some metainfo about the last edit and who did edit it - rendering only
+
+This tagrendering has no question and is thus read-only
+
+
+
+This tagrendering is only visible in the popup if the following condition is met: `_last_edit:contributor~.+&_last_edit:changeset~.+`
+
+
+
+### all-tags
+
+
+
+This tagrendering has no question and is thus read-only
+
+
+
+This document is autogenerated from [assets/layers/route_marker/route_marker.json](https://github.com/pietervdvn/MapComplete/blob/develop/assets/layers/route_marker/route_marker.json)
diff --git a/Docs/Layers/school.md b/Docs/Layers/school.md
index 69d9c48595..bba2d01bf3 100644
--- a/Docs/Layers/school.md
+++ b/Docs/Layers/school.md
@@ -5,7 +5,7 @@
-
+
Schools giving primary and secondary education and post-secondary, non-tertiary education. Note that this level of education does not imply an age of the pupiles
diff --git a/Docs/Layers/shelter.md b/Docs/Layers/shelter.md
index ce3561cf4e..96522737ac 100644
--- a/Docs/Layers/shelter.md
+++ b/Docs/Layers/shelter.md
@@ -5,7 +5,7 @@
-
+
Layer showing shelter structures
diff --git a/Docs/Layers/shops.md b/Docs/Layers/shops.md
index 3aa4ee6db5..227c1638fc 100644
--- a/Docs/Layers/shops.md
+++ b/Docs/Layers/shops.md
@@ -5,7 +5,7 @@
-
+
A shop
@@ -52,7 +52,7 @@ attribute | type | values which are supported by this layer
----------- | ------ | ------------------------------------------
[
](https://taginfo.openstreetmap.org/keys/id#values) [id](https://wiki.openstreetmap.org/wiki/Key:id) | Multiple choice |
[
](https://taginfo.openstreetmap.org/keys/name#values) [name](https://wiki.openstreetmap.org/wiki/Key:name) | [string](../SpecialInputElements.md#string) |
-[
](https://taginfo.openstreetmap.org/keys/shop#values) [shop](https://wiki.openstreetmap.org/wiki/Key:shop) | [string](../SpecialInputElements.md#string) | [agrarian](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dagrarian) [alcohol](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dalcohol) [anime](https://wiki.openstreetmap.org/wiki/Tag:shop%3Danime) [antiques](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dantiques) [appliance](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dappliance) [art](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dart) [baby_goods](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbaby_goods) [bag](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbag) [bakery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbakery) [bathroom_furnishing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbathroom_furnishing) [beauty](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbeauty) [bed](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbed) [beverages](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbeverages) [bicycle](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbicycle) [boat](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dboat) [bookmaker](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbookmaker) [books](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbooks) [brewing_supplies](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbrewing_supplies) [butcher](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbutcher) [camera](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcamera) [candles](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcandles) [cannabis](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcannabis) [car](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar) [car_parts](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar_parts) [car_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar_repair) [caravan](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcaravan) [carpet](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcarpet) [catalogue](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcatalogue) [charity](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcharity) [cheese](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcheese) [chemist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dchemist) [chocolate](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dchocolate) [clothes](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dclothes) [coffee](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcoffee) [collector](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcollector) [computer](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcomputer) [confectionery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dconfectionery) [convenience](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dconvenience) [copyshop](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcopyshop) [cosmetics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcosmetics) [country_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcountry_store) [craft](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcraft) [curtain](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcurtain) [dairy](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddairy) [deli](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddeli) [department_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddepartment_store) [doityourself](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddoityourself) [doors](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddoors) [dry_cleaning](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddry_cleaning) [e-cigarette](https://wiki.openstreetmap.org/wiki/Tag:shop%3De-cigarette) [electrical](https://wiki.openstreetmap.org/wiki/Tag:shop%3Delectrical) [electronics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Delectronics) [erotic](https://wiki.openstreetmap.org/wiki/Tag:shop%3Derotic) [fabric](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfabric) [farm](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfarm) [fashion_accessories](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfashion_accessories) [fireplace](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfireplace) [fishing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfishing) [flooring](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dflooring) [florist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dflorist) [frame](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dframe) [frozen_food](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfrozen_food) [fuel](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfuel) [funeral_directors](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfuneral_directors) [furniture](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfurniture) [games](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgames) [garden_centre](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgarden_centre) [gas](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgas) [general](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgeneral) [gift](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgift) [greengrocer](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgreengrocer) [hairdresser](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhairdresser) [hairdresser_supply](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhairdresser_supply) [hardware](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhardware) [health_food](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhealth_food) [hearing_aids](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhearing_aids) [herbalist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dherbalist) [hifi](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhifi) [hobby](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhobby) [household_linen](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhousehold_linen) [houseware](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhouseware) [hunting](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhunting) [interior_decoration](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dinterior_decoration) [jewelry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Djewelry) [kiosk](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dkiosk) [kitchen](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dkitchen) [laundry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlaundry) [leather](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dleather) [lighting](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlighting) [locksmith](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlocksmith) [lottery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlottery) [mall](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmall) [massage](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmassage) [medical_supply](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmedical_supply) [military_surplus](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmilitary_surplus) [mobile_phone](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmobile_phone) [model](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmodel) [money_lender](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmoney_lender) [motorcycle](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmotorcycle) [motorcycle_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmotorcycle_repair) [music](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmusic) [musical_instrument](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmusical_instrument) [newsagent](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dnewsagent) [nutrition_supplements](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dnutrition_supplements) [optician](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doptician) [outdoor](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doutdoor) [outpost](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doutpost) [paint](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpaint) [party](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dparty) [pastry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpastry) [pawnbroker](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpawnbroker) [perfumery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dperfumery) [pet](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpet) [pet_grooming](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpet_grooming) [photo](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dphoto) [pottery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpottery) [printer_ink](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dprinter_ink) [psychic](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpsychic) [pyrotechnics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpyrotechnics) [radiotechnics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dradiotechnics) [religion](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dreligion) [rental](https://wiki.openstreetmap.org/wiki/Tag:shop%3Drental) [repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Drepair) [scuba_diving](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dscuba_diving) [seafood](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dseafood) [second_hand](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsecond_hand) [sewing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsewing) [shoe_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dshoe_repair) [shoes](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dshoes) [spices](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dspices) [sports](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsports) [stationery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dstationery) [storage_rental](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dstorage_rental) [supermarket](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsupermarket) [swimming_pool](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dswimming_pool) [tailor](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtailor) [tattoo](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtattoo) [tea](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtea) [telecommunication](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtelecommunication) [ticket](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dticket) [tiles](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtiles) [tobacco](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtobacco) [tool_hire](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtool_hire) [toys](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtoys) [trade](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtrade) [travel_agency](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtravel_agency) [trophy](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtrophy) [tyres](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtyres) [vacuum_cleaner](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvacuum_cleaner) [variety_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvariety_store) [video](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvideo) [video_games](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvideo_games) [watches](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwatches) [water](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwater) [water_sports](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwater_sports) [weapons](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dweapons) [wholesale](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwholesale) [wigs](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwigs) [window_blind](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwindow_blind) [wine](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwine)
+[
](https://taginfo.openstreetmap.org/keys/shop#values) [shop](https://wiki.openstreetmap.org/wiki/Key:shop) | [string](../SpecialInputElements.md#string) | [vacant](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvacant) [agrarian](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dagrarian) [alcohol](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dalcohol) [anime](https://wiki.openstreetmap.org/wiki/Tag:shop%3Danime) [antiques](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dantiques) [appliance](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dappliance) [art](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dart) [baby_goods](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbaby_goods) [bag](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbag) [bakery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbakery) [bathroom_furnishing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbathroom_furnishing) [beauty](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbeauty) [bed](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbed) [beverages](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbeverages) [bicycle](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbicycle) [boat](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dboat) [bookmaker](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbookmaker) [books](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbooks) [brewing_supplies](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbrewing_supplies) [butcher](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbutcher) [camera](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcamera) [candles](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcandles) [cannabis](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcannabis) [car](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar) [car_parts](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar_parts) [car_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar_repair) [caravan](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcaravan) [carpet](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcarpet) [catalogue](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcatalogue) [charity](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcharity) [cheese](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcheese) [chemist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dchemist) [chocolate](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dchocolate) [clothes](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dclothes) [coffee](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcoffee) [collector](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcollector) [computer](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcomputer) [confectionery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dconfectionery) [convenience](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dconvenience) [copyshop](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcopyshop) [cosmetics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcosmetics) [country_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcountry_store) [craft](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcraft) [curtain](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcurtain) [dairy](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddairy) [deli](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddeli) [department_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddepartment_store) [doityourself](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddoityourself) [doors](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddoors) [dry_cleaning](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddry_cleaning) [e-cigarette](https://wiki.openstreetmap.org/wiki/Tag:shop%3De-cigarette) [electrical](https://wiki.openstreetmap.org/wiki/Tag:shop%3Delectrical) [electronics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Delectronics) [erotic](https://wiki.openstreetmap.org/wiki/Tag:shop%3Derotic) [fabric](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfabric) [farm](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfarm) [fashion_accessories](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfashion_accessories) [fireplace](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfireplace) [fishing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfishing) [flooring](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dflooring) [florist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dflorist) [frame](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dframe) [frozen_food](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfrozen_food) [fuel](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfuel) [funeral_directors](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfuneral_directors) [furniture](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfurniture) [games](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgames) [garden_centre](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgarden_centre) [gas](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgas) [general](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgeneral) [gift](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgift) [greengrocer](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgreengrocer) [hairdresser](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhairdresser) [hairdresser_supply](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhairdresser_supply) [hardware](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhardware) [health_food](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhealth_food) [hearing_aids](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhearing_aids) [herbalist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dherbalist) [hifi](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhifi) [honey](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhoney) [household_linen](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhousehold_linen) [houseware](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhouseware) [hunting](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhunting) [interior_decoration](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dinterior_decoration) [jewelry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Djewelry) [kiosk](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dkiosk) [kitchen](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dkitchen) [laundry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlaundry) [leather](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dleather) [lighting](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlighting) [locksmith](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlocksmith) [lottery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlottery) [mall](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmall) [massage](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmassage) [medical_supply](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmedical_supply) [military_surplus](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmilitary_surplus) [mobile_phone](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmobile_phone) [model](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmodel) [money_lender](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmoney_lender) [motorcycle](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmotorcycle) [motorcycle_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmotorcycle_repair) [music](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmusic) [musical_instrument](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmusical_instrument) [newsagent](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dnewsagent) [nutrition_supplements](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dnutrition_supplements) [nuts](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dnuts) [optician](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doptician) [outdoor](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doutdoor) [outpost](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doutpost) [paint](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpaint) [party](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dparty) [pasta](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpasta) [pastry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpastry) [pawnbroker](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpawnbroker) [perfumery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dperfumery) [pet](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpet) [pet_grooming](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpet_grooming) [photo](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dphoto) [pottery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpottery) [printer_ink](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dprinter_ink) [psychic](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpsychic) [pyrotechnics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpyrotechnics) [radiotechnics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dradiotechnics) [religion](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dreligion) [rental](https://wiki.openstreetmap.org/wiki/Tag:shop%3Drental) [repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Drepair) [rice](https://wiki.openstreetmap.org/wiki/Tag:shop%3Drice) [scuba_diving](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dscuba_diving) [seafood](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dseafood) [second_hand](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsecond_hand) [sewing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsewing) [shoe_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dshoe_repair) [shoes](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dshoes) [spices](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dspices) [sports](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsports) [stationery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dstationery) [storage_rental](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dstorage_rental) [supermarket](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsupermarket) [swimming_pool](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dswimming_pool) [tailor](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtailor) [tattoo](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtattoo) [tea](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtea) [telecommunication](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtelecommunication) [ticket](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dticket) [tiles](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtiles) [tobacco](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtobacco) [tool_hire](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtool_hire) [toys](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtoys) [trade](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtrade) [travel_agency](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtravel_agency) [trophy](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtrophy) [tyres](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtyres) [vacuum_cleaner](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvacuum_cleaner) [variety_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvariety_store) [video](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvideo) [video_games](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvideo_games) [watches](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwatches) [water](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwater) [water_sports](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwater_sports) [weapons](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dweapons) [wholesale](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwholesale) [wigs](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwigs) [window_blind](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwindow_blind) [wine](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwine)
[
](https://taginfo.openstreetmap.org/keys/second_hand#values) [second_hand](https://wiki.openstreetmap.org/wiki/Key:second_hand) | Multiple choice | [only](https://wiki.openstreetmap.org/wiki/Tag:second_hand%3Donly) [yes](https://wiki.openstreetmap.org/wiki/Tag:second_hand%3Dyes) [no](https://wiki.openstreetmap.org/wiki/Tag:second_hand%3Dno)
[
](https://taginfo.openstreetmap.org/keys/opening_hours#values) [opening_hours](https://wiki.openstreetmap.org/wiki/Key:opening_hours) | [opening_hours](../SpecialInputElements.md#opening_hours) |
[
](https://taginfo.openstreetmap.org/keys/website#values) [website](https://wiki.openstreetmap.org/wiki/Key:website) | [url](../SpecialInputElements.md#url) |
@@ -129,10 +129,11 @@ This is rendered with `This is a {shop}`
+ - *Vacant Shop* corresponds with `shop=vacant`
- *Farm Supply Shop* corresponds with `shop=agrarian`
- *Liquor Store* corresponds with `shop=alcohol`
- *Anime / Manga Shop* corresponds with `shop=anime`
- - *Antiques Shop* corresponds with `shop=antiques`
+ - *Antique Shop* corresponds with `shop=antiques`
- *Appliance Store* corresponds with `shop=appliance`
- *Art Store* corresponds with `shop=art`
- *Baby Goods Store* corresponds with `shop=baby_goods`
@@ -145,7 +146,7 @@ This is rendered with `This is a {shop}`
- *Bicycle Shop* corresponds with `shop=bicycle`
- *Boat Store* corresponds with `shop=boat`
- *Bookmaker* corresponds with `shop=bookmaker`
- - *Book Store* corresponds with `shop=books`
+ - *Bookstore* corresponds with `shop=books`
- *Brewing Supply Store* corresponds with `shop=brewing_supplies`
- *Butcher* corresponds with `shop=butcher`
- *Camera Equipment Store* corresponds with `shop=camera`
@@ -169,11 +170,11 @@ This is rendered with `This is a {shop}`
- *Convenience Store* corresponds with `shop=convenience`
- *Copy Store* corresponds with `shop=copyshop`
- *Cosmetics Store* corresponds with `shop=cosmetics`
- - *Country Store* corresponds with `shop=country_store`
+ - *Rural Supplies Store* corresponds with `shop=country_store`
- *Arts & Crafts Store* corresponds with `shop=craft`
- *Curtain Store* corresponds with `shop=curtain`
- *Dairy Store* corresponds with `shop=dairy`
- - *Deli* corresponds with `shop=deli`
+ - *Delicatessen* corresponds with `shop=deli`
- *Department Store* corresponds with `shop=department_store`
- *DIY Store* corresponds with `shop=doityourself`
- *Door Shop* corresponds with `shop=doors`
@@ -203,11 +204,11 @@ This is rendered with `This is a {shop}`
- *Hairdresser* corresponds with `shop=hairdresser`
- *Hairdresser Supply Store* corresponds with `shop=hairdresser_supply`
- *Hardware Store* corresponds with `shop=hardware`
- - *Health Food Shop* corresponds with `shop=health_food`
+ - *Health Food Store* corresponds with `shop=health_food`
- *Hearing Aids Store* corresponds with `shop=hearing_aids`
- *Herbalist* corresponds with `shop=herbalist`
- *Hifi Store* corresponds with `shop=hifi`
- - *Hobby Shop* corresponds with `shop=hobby`
+ - *Honey Store* corresponds with `shop=honey`
- *Household Linen Shop* corresponds with `shop=household_linen`
- *Houseware Store* corresponds with `shop=houseware`
- *Hunting Shop* corresponds with `shop=hunting`
@@ -231,18 +232,20 @@ This is rendered with `This is a {shop}`
- *Motorcycle Repair Shop* corresponds with `shop=motorcycle_repair`
- *Music Store* corresponds with `shop=music`
- *Musical Instrument Store* corresponds with `shop=musical_instrument`
- - *Newspaper/Magazine Shop* corresponds with `shop=newsagent`
+ - *Newsstand* corresponds with `shop=newsagent`
- *Nutrition Supplements Store* corresponds with `shop=nutrition_supplements`
+ - *Nuts Shop* corresponds with `shop=nuts`
- *Optician* corresponds with `shop=optician`
- *Outdoors Store* corresponds with `shop=outdoor`
- *Online Retailer Outpost* corresponds with `shop=outpost`
- *Paint Store* corresponds with `shop=paint`
- *Party Supply Store* corresponds with `shop=party`
+ - *Pasta Store* corresponds with `shop=pasta`
- *Pastry Shop* corresponds with `shop=pastry`
- - *Pawn Shop* corresponds with `shop=pawnbroker`
+ - *Pawnshop* corresponds with `shop=pawnbroker`
- *Perfume Store* corresponds with `shop=perfumery`
- *Pet Store* corresponds with `shop=pet`
- - *Pet Grooming Store* corresponds with `shop=pet_grooming`
+ - *Pet Groomer* corresponds with `shop=pet_grooming`
- *Photography Store* corresponds with `shop=photo`
- *Pottery Store* corresponds with `shop=pottery`
- *Printer Ink Store* corresponds with `shop=printer_ink`
@@ -252,9 +255,10 @@ This is rendered with `This is a {shop}`
- *Religious Store* corresponds with `shop=religion`
- *Rental Shop* corresponds with `shop=rental`
- *Repair Shop* corresponds with `shop=repair`
+ - *Rice Store* corresponds with `shop=rice`
- *Scuba Diving Shop* corresponds with `shop=scuba_diving`
- *Seafood Shop* corresponds with `shop=seafood`
- - *Consignment/Thrift Store* corresponds with `shop=second_hand`
+ - *Thrift Store* corresponds with `shop=second_hand`
- *Sewing Supply Shop* corresponds with `shop=sewing`
- *Shoe Repair Shop* corresponds with `shop=shoe_repair`
- *Shoe Store* corresponds with `shop=shoes`
@@ -278,7 +282,7 @@ This is rendered with `This is a {shop}`
- *Trophy Shop* corresponds with `shop=trophy`
- *Tire Store* corresponds with `shop=tyres`
- *Vacuum Cleaner Store* corresponds with `shop=vacuum_cleaner`
- - *Variety Store* corresponds with `shop=variety_store`
+ - *Discount Store* corresponds with `shop=variety_store`
- *Video Store* corresponds with `shop=video`
- *Video Game Store* corresponds with `shop=video_games`
- *Watches Shop* corresponds with `shop=watches`
@@ -479,6 +483,25 @@ This tagrendering is only visible in the popup if the following condition is met
+### key_cutter
+
+
+
+This tagrendering has no question and is thus read-only
+
+
+
+
+
+ - *This shop is also specialized in key cutting* corresponds with `craft=key_cutter`
+ - *This shop offers key cutting as a service* corresponds with `service:key_cutting=yes`
+ - *This shops does not offer key cutting as a service* corresponds with `service:key_cutting=no`
+
+
+This tagrendering is only visible in the popup if the following condition is met: `shop=shoe_repair|service:key_cutting~.+|craft=key_cutting|shop=diy|shop=doityourself|shop=home_improvement|shop=hardware|shop=locksmith|shop=repair`
+
+
+
### internet
@@ -576,6 +599,8 @@ The question is *Does this shop have a sugar free offering?*
This tagrendering is only visible in the popup if the following condition is met: `shop=supermarket|shop=convenience|shop=farm|shop=greengrocer|shop=health_food|shop=deli|shop=bakery|shop=beverages|shop=beverages|shop=pastry|shop=chocolate|shop=frozen_food|shop=ice_cream`
+This tagrendering has labels `diets`
+
### gluten_free
@@ -596,6 +621,8 @@ The question is *Does this shop have a gluten free offering?*
This tagrendering is only visible in the popup if the following condition is met: `shop=supermarket|shop=convenience|shop=farm|shop=greengrocer|shop=health_food|shop=deli|shop=bakery|shop=beverages|shop=beverages|shop=pastry|shop=chocolate|shop=frozen_food|shop=ice_cream`
+This tagrendering has labels `diets`
+
### lactose_free
@@ -616,6 +643,8 @@ The question is *Does {title()} have a lactose-free offering?*
This tagrendering is only visible in the popup if the following condition is met: `shop=supermarket|shop=convenience|shop=farm|shop=greengrocer|shop=health_food|shop=deli|shop=bakery|shop=beverages|shop=beverages|shop=pastry|shop=chocolate|shop=frozen_food|shop=ice_cream`
+This tagrendering has labels `diets`
+
### questions
diff --git a/Docs/Layers/shops_with_climbing_shoe_repair.md b/Docs/Layers/shops_with_climbing_shoe_repair.md
index 0765a40765..19c935296c 100644
--- a/Docs/Layers/shops_with_climbing_shoe_repair.md
+++ b/Docs/Layers/shops_with_climbing_shoe_repair.md
@@ -5,7 +5,7 @@
-
+
A shop
@@ -48,7 +48,7 @@ attribute | type | values which are supported by this layer
[
](https://taginfo.openstreetmap.org/keys/service:climbing_shoes:repair#values) [service:climbing_shoes:repair](https://wiki.openstreetmap.org/wiki/Key:service:climbing_shoes:repair) | Multiple choice | [yes](https://wiki.openstreetmap.org/wiki/Tag:service:climbing_shoes:repair%3Dyes) [no](https://wiki.openstreetmap.org/wiki/Tag:service:climbing_shoes:repair%3Dno)
[
](https://taginfo.openstreetmap.org/keys/id#values) [id](https://wiki.openstreetmap.org/wiki/Key:id) | Multiple choice |
[
](https://taginfo.openstreetmap.org/keys/name#values) [name](https://wiki.openstreetmap.org/wiki/Key:name) | [string](../SpecialInputElements.md#string) |
-[
](https://taginfo.openstreetmap.org/keys/shop#values) [shop](https://wiki.openstreetmap.org/wiki/Key:shop) | [string](../SpecialInputElements.md#string) | [agrarian](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dagrarian) [alcohol](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dalcohol) [anime](https://wiki.openstreetmap.org/wiki/Tag:shop%3Danime) [antiques](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dantiques) [appliance](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dappliance) [art](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dart) [baby_goods](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbaby_goods) [bag](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbag) [bakery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbakery) [bathroom_furnishing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbathroom_furnishing) [beauty](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbeauty) [bed](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbed) [beverages](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbeverages) [bicycle](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbicycle) [boat](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dboat) [bookmaker](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbookmaker) [books](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbooks) [brewing_supplies](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbrewing_supplies) [butcher](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbutcher) [camera](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcamera) [candles](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcandles) [cannabis](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcannabis) [car](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar) [car_parts](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar_parts) [car_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar_repair) [caravan](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcaravan) [carpet](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcarpet) [catalogue](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcatalogue) [charity](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcharity) [cheese](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcheese) [chemist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dchemist) [chocolate](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dchocolate) [clothes](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dclothes) [coffee](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcoffee) [collector](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcollector) [computer](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcomputer) [confectionery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dconfectionery) [convenience](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dconvenience) [copyshop](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcopyshop) [cosmetics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcosmetics) [country_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcountry_store) [craft](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcraft) [curtain](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcurtain) [dairy](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddairy) [deli](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddeli) [department_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddepartment_store) [doityourself](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddoityourself) [doors](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddoors) [dry_cleaning](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddry_cleaning) [e-cigarette](https://wiki.openstreetmap.org/wiki/Tag:shop%3De-cigarette) [electrical](https://wiki.openstreetmap.org/wiki/Tag:shop%3Delectrical) [electronics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Delectronics) [erotic](https://wiki.openstreetmap.org/wiki/Tag:shop%3Derotic) [fabric](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfabric) [farm](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfarm) [fashion_accessories](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfashion_accessories) [fireplace](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfireplace) [fishing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfishing) [flooring](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dflooring) [florist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dflorist) [frame](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dframe) [frozen_food](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfrozen_food) [fuel](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfuel) [funeral_directors](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfuneral_directors) [furniture](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfurniture) [games](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgames) [garden_centre](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgarden_centre) [gas](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgas) [general](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgeneral) [gift](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgift) [greengrocer](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgreengrocer) [hairdresser](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhairdresser) [hairdresser_supply](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhairdresser_supply) [hardware](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhardware) [health_food](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhealth_food) [hearing_aids](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhearing_aids) [herbalist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dherbalist) [hifi](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhifi) [hobby](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhobby) [household_linen](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhousehold_linen) [houseware](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhouseware) [hunting](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhunting) [interior_decoration](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dinterior_decoration) [jewelry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Djewelry) [kiosk](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dkiosk) [kitchen](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dkitchen) [laundry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlaundry) [leather](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dleather) [lighting](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlighting) [locksmith](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlocksmith) [lottery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlottery) [mall](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmall) [massage](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmassage) [medical_supply](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmedical_supply) [military_surplus](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmilitary_surplus) [mobile_phone](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmobile_phone) [model](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmodel) [money_lender](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmoney_lender) [motorcycle](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmotorcycle) [motorcycle_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmotorcycle_repair) [music](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmusic) [musical_instrument](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmusical_instrument) [newsagent](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dnewsagent) [nutrition_supplements](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dnutrition_supplements) [optician](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doptician) [outdoor](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doutdoor) [outpost](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doutpost) [paint](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpaint) [party](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dparty) [pastry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpastry) [pawnbroker](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpawnbroker) [perfumery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dperfumery) [pet](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpet) [pet_grooming](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpet_grooming) [photo](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dphoto) [pottery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpottery) [printer_ink](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dprinter_ink) [psychic](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpsychic) [pyrotechnics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpyrotechnics) [radiotechnics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dradiotechnics) [religion](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dreligion) [rental](https://wiki.openstreetmap.org/wiki/Tag:shop%3Drental) [repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Drepair) [scuba_diving](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dscuba_diving) [seafood](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dseafood) [second_hand](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsecond_hand) [sewing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsewing) [shoe_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dshoe_repair) [shoes](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dshoes) [spices](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dspices) [sports](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsports) [stationery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dstationery) [storage_rental](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dstorage_rental) [supermarket](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsupermarket) [swimming_pool](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dswimming_pool) [tailor](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtailor) [tattoo](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtattoo) [tea](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtea) [telecommunication](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtelecommunication) [ticket](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dticket) [tiles](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtiles) [tobacco](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtobacco) [tool_hire](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtool_hire) [toys](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtoys) [trade](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtrade) [travel_agency](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtravel_agency) [trophy](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtrophy) [tyres](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtyres) [vacuum_cleaner](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvacuum_cleaner) [variety_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvariety_store) [video](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvideo) [video_games](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvideo_games) [watches](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwatches) [water](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwater) [water_sports](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwater_sports) [weapons](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dweapons) [wholesale](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwholesale) [wigs](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwigs) [window_blind](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwindow_blind) [wine](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwine)
+[
](https://taginfo.openstreetmap.org/keys/shop#values) [shop](https://wiki.openstreetmap.org/wiki/Key:shop) | [string](../SpecialInputElements.md#string) | [vacant](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvacant) [agrarian](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dagrarian) [alcohol](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dalcohol) [anime](https://wiki.openstreetmap.org/wiki/Tag:shop%3Danime) [antiques](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dantiques) [appliance](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dappliance) [art](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dart) [baby_goods](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbaby_goods) [bag](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbag) [bakery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbakery) [bathroom_furnishing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbathroom_furnishing) [beauty](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbeauty) [bed](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbed) [beverages](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbeverages) [bicycle](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbicycle) [boat](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dboat) [bookmaker](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbookmaker) [books](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbooks) [brewing_supplies](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbrewing_supplies) [butcher](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbutcher) [camera](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcamera) [candles](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcandles) [cannabis](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcannabis) [car](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar) [car_parts](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar_parts) [car_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar_repair) [caravan](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcaravan) [carpet](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcarpet) [catalogue](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcatalogue) [charity](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcharity) [cheese](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcheese) [chemist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dchemist) [chocolate](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dchocolate) [clothes](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dclothes) [coffee](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcoffee) [collector](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcollector) [computer](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcomputer) [confectionery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dconfectionery) [convenience](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dconvenience) [copyshop](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcopyshop) [cosmetics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcosmetics) [country_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcountry_store) [craft](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcraft) [curtain](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcurtain) [dairy](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddairy) [deli](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddeli) [department_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddepartment_store) [doityourself](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddoityourself) [doors](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddoors) [dry_cleaning](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddry_cleaning) [e-cigarette](https://wiki.openstreetmap.org/wiki/Tag:shop%3De-cigarette) [electrical](https://wiki.openstreetmap.org/wiki/Tag:shop%3Delectrical) [electronics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Delectronics) [erotic](https://wiki.openstreetmap.org/wiki/Tag:shop%3Derotic) [fabric](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfabric) [farm](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfarm) [fashion_accessories](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfashion_accessories) [fireplace](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfireplace) [fishing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfishing) [flooring](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dflooring) [florist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dflorist) [frame](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dframe) [frozen_food](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfrozen_food) [fuel](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfuel) [funeral_directors](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfuneral_directors) [furniture](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfurniture) [games](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgames) [garden_centre](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgarden_centre) [gas](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgas) [general](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgeneral) [gift](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgift) [greengrocer](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgreengrocer) [hairdresser](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhairdresser) [hairdresser_supply](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhairdresser_supply) [hardware](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhardware) [health_food](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhealth_food) [hearing_aids](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhearing_aids) [herbalist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dherbalist) [hifi](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhifi) [honey](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhoney) [household_linen](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhousehold_linen) [houseware](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhouseware) [hunting](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhunting) [interior_decoration](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dinterior_decoration) [jewelry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Djewelry) [kiosk](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dkiosk) [kitchen](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dkitchen) [laundry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlaundry) [leather](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dleather) [lighting](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlighting) [locksmith](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlocksmith) [lottery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlottery) [mall](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmall) [massage](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmassage) [medical_supply](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmedical_supply) [military_surplus](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmilitary_surplus) [mobile_phone](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmobile_phone) [model](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmodel) [money_lender](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmoney_lender) [motorcycle](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmotorcycle) [motorcycle_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmotorcycle_repair) [music](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmusic) [musical_instrument](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmusical_instrument) [newsagent](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dnewsagent) [nutrition_supplements](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dnutrition_supplements) [nuts](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dnuts) [optician](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doptician) [outdoor](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doutdoor) [outpost](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doutpost) [paint](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpaint) [party](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dparty) [pasta](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpasta) [pastry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpastry) [pawnbroker](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpawnbroker) [perfumery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dperfumery) [pet](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpet) [pet_grooming](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpet_grooming) [photo](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dphoto) [pottery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpottery) [printer_ink](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dprinter_ink) [psychic](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpsychic) [pyrotechnics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpyrotechnics) [radiotechnics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dradiotechnics) [religion](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dreligion) [rental](https://wiki.openstreetmap.org/wiki/Tag:shop%3Drental) [repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Drepair) [rice](https://wiki.openstreetmap.org/wiki/Tag:shop%3Drice) [scuba_diving](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dscuba_diving) [seafood](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dseafood) [second_hand](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsecond_hand) [sewing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsewing) [shoe_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dshoe_repair) [shoes](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dshoes) [spices](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dspices) [sports](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsports) [stationery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dstationery) [storage_rental](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dstorage_rental) [supermarket](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsupermarket) [swimming_pool](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dswimming_pool) [tailor](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtailor) [tattoo](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtattoo) [tea](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtea) [telecommunication](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtelecommunication) [ticket](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dticket) [tiles](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtiles) [tobacco](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtobacco) [tool_hire](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtool_hire) [toys](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtoys) [trade](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtrade) [travel_agency](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtravel_agency) [trophy](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtrophy) [tyres](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtyres) [vacuum_cleaner](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvacuum_cleaner) [variety_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvariety_store) [video](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvideo) [video_games](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvideo_games) [watches](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwatches) [water](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwater) [water_sports](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwater_sports) [weapons](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dweapons) [wholesale](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwholesale) [wigs](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwigs) [window_blind](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwindow_blind) [wine](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwine)
[
](https://taginfo.openstreetmap.org/keys/second_hand#values) [second_hand](https://wiki.openstreetmap.org/wiki/Key:second_hand) | Multiple choice | [only](https://wiki.openstreetmap.org/wiki/Tag:second_hand%3Donly) [yes](https://wiki.openstreetmap.org/wiki/Tag:second_hand%3Dyes) [no](https://wiki.openstreetmap.org/wiki/Tag:second_hand%3Dno)
[
](https://taginfo.openstreetmap.org/keys/opening_hours#values) [opening_hours](https://wiki.openstreetmap.org/wiki/Key:opening_hours) | [opening_hours](../SpecialInputElements.md#opening_hours) |
[
](https://taginfo.openstreetmap.org/keys/website#values) [website](https://wiki.openstreetmap.org/wiki/Key:website) | [url](../SpecialInputElements.md#url) |
@@ -141,10 +141,11 @@ This is rendered with `This is a {shop}`
+ - *Vacant Shop* corresponds with `shop=vacant`
- *Farm Supply Shop* corresponds with `shop=agrarian`
- *Liquor Store* corresponds with `shop=alcohol`
- *Anime / Manga Shop* corresponds with `shop=anime`
- - *Antiques Shop* corresponds with `shop=antiques`
+ - *Antique Shop* corresponds with `shop=antiques`
- *Appliance Store* corresponds with `shop=appliance`
- *Art Store* corresponds with `shop=art`
- *Baby Goods Store* corresponds with `shop=baby_goods`
@@ -157,7 +158,7 @@ This is rendered with `This is a {shop}`
- *Bicycle Shop* corresponds with `shop=bicycle`
- *Boat Store* corresponds with `shop=boat`
- *Bookmaker* corresponds with `shop=bookmaker`
- - *Book Store* corresponds with `shop=books`
+ - *Bookstore* corresponds with `shop=books`
- *Brewing Supply Store* corresponds with `shop=brewing_supplies`
- *Butcher* corresponds with `shop=butcher`
- *Camera Equipment Store* corresponds with `shop=camera`
@@ -181,11 +182,11 @@ This is rendered with `This is a {shop}`
- *Convenience Store* corresponds with `shop=convenience`
- *Copy Store* corresponds with `shop=copyshop`
- *Cosmetics Store* corresponds with `shop=cosmetics`
- - *Country Store* corresponds with `shop=country_store`
+ - *Rural Supplies Store* corresponds with `shop=country_store`
- *Arts & Crafts Store* corresponds with `shop=craft`
- *Curtain Store* corresponds with `shop=curtain`
- *Dairy Store* corresponds with `shop=dairy`
- - *Deli* corresponds with `shop=deli`
+ - *Delicatessen* corresponds with `shop=deli`
- *Department Store* corresponds with `shop=department_store`
- *DIY Store* corresponds with `shop=doityourself`
- *Door Shop* corresponds with `shop=doors`
@@ -215,11 +216,11 @@ This is rendered with `This is a {shop}`
- *Hairdresser* corresponds with `shop=hairdresser`
- *Hairdresser Supply Store* corresponds with `shop=hairdresser_supply`
- *Hardware Store* corresponds with `shop=hardware`
- - *Health Food Shop* corresponds with `shop=health_food`
+ - *Health Food Store* corresponds with `shop=health_food`
- *Hearing Aids Store* corresponds with `shop=hearing_aids`
- *Herbalist* corresponds with `shop=herbalist`
- *Hifi Store* corresponds with `shop=hifi`
- - *Hobby Shop* corresponds with `shop=hobby`
+ - *Honey Store* corresponds with `shop=honey`
- *Household Linen Shop* corresponds with `shop=household_linen`
- *Houseware Store* corresponds with `shop=houseware`
- *Hunting Shop* corresponds with `shop=hunting`
@@ -243,18 +244,20 @@ This is rendered with `This is a {shop}`
- *Motorcycle Repair Shop* corresponds with `shop=motorcycle_repair`
- *Music Store* corresponds with `shop=music`
- *Musical Instrument Store* corresponds with `shop=musical_instrument`
- - *Newspaper/Magazine Shop* corresponds with `shop=newsagent`
+ - *Newsstand* corresponds with `shop=newsagent`
- *Nutrition Supplements Store* corresponds with `shop=nutrition_supplements`
+ - *Nuts Shop* corresponds with `shop=nuts`
- *Optician* corresponds with `shop=optician`
- *Outdoors Store* corresponds with `shop=outdoor`
- *Online Retailer Outpost* corresponds with `shop=outpost`
- *Paint Store* corresponds with `shop=paint`
- *Party Supply Store* corresponds with `shop=party`
+ - *Pasta Store* corresponds with `shop=pasta`
- *Pastry Shop* corresponds with `shop=pastry`
- - *Pawn Shop* corresponds with `shop=pawnbroker`
+ - *Pawnshop* corresponds with `shop=pawnbroker`
- *Perfume Store* corresponds with `shop=perfumery`
- *Pet Store* corresponds with `shop=pet`
- - *Pet Grooming Store* corresponds with `shop=pet_grooming`
+ - *Pet Groomer* corresponds with `shop=pet_grooming`
- *Photography Store* corresponds with `shop=photo`
- *Pottery Store* corresponds with `shop=pottery`
- *Printer Ink Store* corresponds with `shop=printer_ink`
@@ -264,9 +267,10 @@ This is rendered with `This is a {shop}`
- *Religious Store* corresponds with `shop=religion`
- *Rental Shop* corresponds with `shop=rental`
- *Repair Shop* corresponds with `shop=repair`
+ - *Rice Store* corresponds with `shop=rice`
- *Scuba Diving Shop* corresponds with `shop=scuba_diving`
- *Seafood Shop* corresponds with `shop=seafood`
- - *Consignment/Thrift Store* corresponds with `shop=second_hand`
+ - *Thrift Store* corresponds with `shop=second_hand`
- *Sewing Supply Shop* corresponds with `shop=sewing`
- *Shoe Repair Shop* corresponds with `shop=shoe_repair`
- *Shoe Store* corresponds with `shop=shoes`
@@ -290,7 +294,7 @@ This is rendered with `This is a {shop}`
- *Trophy Shop* corresponds with `shop=trophy`
- *Tire Store* corresponds with `shop=tyres`
- *Vacuum Cleaner Store* corresponds with `shop=vacuum_cleaner`
- - *Variety Store* corresponds with `shop=variety_store`
+ - *Discount Store* corresponds with `shop=variety_store`
- *Video Store* corresponds with `shop=video`
- *Video Game Store* corresponds with `shop=video_games`
- *Watches Shop* corresponds with `shop=watches`
@@ -491,6 +495,25 @@ This tagrendering is only visible in the popup if the following condition is met
+### key_cutter
+
+
+
+This tagrendering has no question and is thus read-only
+
+
+
+
+
+ - *This shop is also specialized in key cutting* corresponds with `craft=key_cutter`
+ - *This shop offers key cutting as a service* corresponds with `service:key_cutting=yes`
+ - *This shops does not offer key cutting as a service* corresponds with `service:key_cutting=no`
+
+
+This tagrendering is only visible in the popup if the following condition is met: `shop=shoe_repair|service:key_cutting~.+|craft=key_cutting|shop=diy|shop=doityourself|shop=home_improvement|shop=hardware|shop=locksmith|shop=repair`
+
+
+
### internet
@@ -588,6 +611,8 @@ The question is *Does this shop have a sugar free offering?*
This tagrendering is only visible in the popup if the following condition is met: `shop=supermarket|shop=convenience|shop=farm|shop=greengrocer|shop=health_food|shop=deli|shop=bakery|shop=beverages|shop=beverages|shop=pastry|shop=chocolate|shop=frozen_food|shop=ice_cream`
+This tagrendering has labels `diets`
+
### gluten_free
@@ -608,6 +633,8 @@ The question is *Does this shop have a gluten free offering?*
This tagrendering is only visible in the popup if the following condition is met: `shop=supermarket|shop=convenience|shop=farm|shop=greengrocer|shop=health_food|shop=deli|shop=bakery|shop=beverages|shop=beverages|shop=pastry|shop=chocolate|shop=frozen_food|shop=ice_cream`
+This tagrendering has labels `diets`
+
### lactose_free
@@ -628,6 +655,8 @@ The question is *Does {title()} have a lactose-free offering?*
This tagrendering is only visible in the popup if the following condition is met: `shop=supermarket|shop=convenience|shop=farm|shop=greengrocer|shop=health_food|shop=deli|shop=bakery|shop=beverages|shop=beverages|shop=pastry|shop=chocolate|shop=frozen_food|shop=ice_cream`
+This tagrendering has labels `diets`
+
### questions
diff --git a/Docs/Layers/shower.md b/Docs/Layers/shower.md
index 28edf884cc..21b768df1e 100644
--- a/Docs/Layers/shower.md
+++ b/Docs/Layers/shower.md
@@ -5,7 +5,7 @@
-
+
A layer showing (public) showers
diff --git a/Docs/Layers/slow_roads.md b/Docs/Layers/slow_roads.md
index 417dbaa242..6ddfbe7c4e 100644
--- a/Docs/Layers/slow_roads.md
+++ b/Docs/Layers/slow_roads.md
@@ -5,7 +5,7 @@
-
+
All carfree roads
diff --git a/Docs/Layers/speed_camera.md b/Docs/Layers/speed_camera.md
index 792ea53be8..6e974176c9 100644
--- a/Docs/Layers/speed_camera.md
+++ b/Docs/Layers/speed_camera.md
@@ -5,7 +5,7 @@
-
+
Layer showing speed cameras
diff --git a/Docs/Layers/speed_display.md b/Docs/Layers/speed_display.md
index d710d1a1bb..f7ec7a149e 100644
--- a/Docs/Layers/speed_display.md
+++ b/Docs/Layers/speed_display.md
@@ -5,7 +5,7 @@
-
+
Layer showing speed displays that alert drivers of their speed.
diff --git a/Docs/Layers/sport_pitch.md b/Docs/Layers/sport_pitch.md
index 61bc1a6c74..3c8640a234 100644
--- a/Docs/Layers/sport_pitch.md
+++ b/Docs/Layers/sport_pitch.md
@@ -5,7 +5,7 @@
-
+
A sport pitch
diff --git a/Docs/Layers/sport_places_without_etymology.md b/Docs/Layers/sport_places_without_etymology.md
index d8243531e8..bbc438af39 100644
--- a/Docs/Layers/sport_places_without_etymology.md
+++ b/Docs/Layers/sport_places_without_etymology.md
@@ -5,7 +5,7 @@
-
+
All objects which have an etymology known
diff --git a/Docs/Layers/sport_shops.md b/Docs/Layers/sport_shops.md
index 8ea7f90be2..732c88bcf5 100644
--- a/Docs/Layers/sport_shops.md
+++ b/Docs/Layers/sport_shops.md
@@ -5,7 +5,7 @@
-
+
A shop
@@ -47,7 +47,7 @@ attribute | type | values which are supported by this layer
----------- | ------ | ------------------------------------------
[
](https://taginfo.openstreetmap.org/keys/id#values) [id](https://wiki.openstreetmap.org/wiki/Key:id) | Multiple choice |
[
](https://taginfo.openstreetmap.org/keys/name#values) [name](https://wiki.openstreetmap.org/wiki/Key:name) | [string](../SpecialInputElements.md#string) |
-[
](https://taginfo.openstreetmap.org/keys/shop#values) [shop](https://wiki.openstreetmap.org/wiki/Key:shop) | [string](../SpecialInputElements.md#string) | [agrarian](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dagrarian) [alcohol](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dalcohol) [anime](https://wiki.openstreetmap.org/wiki/Tag:shop%3Danime) [antiques](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dantiques) [appliance](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dappliance) [art](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dart) [baby_goods](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbaby_goods) [bag](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbag) [bakery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbakery) [bathroom_furnishing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbathroom_furnishing) [beauty](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbeauty) [bed](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbed) [beverages](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbeverages) [bicycle](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbicycle) [boat](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dboat) [bookmaker](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbookmaker) [books](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbooks) [brewing_supplies](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbrewing_supplies) [butcher](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbutcher) [camera](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcamera) [candles](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcandles) [cannabis](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcannabis) [car](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar) [car_parts](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar_parts) [car_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar_repair) [caravan](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcaravan) [carpet](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcarpet) [catalogue](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcatalogue) [charity](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcharity) [cheese](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcheese) [chemist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dchemist) [chocolate](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dchocolate) [clothes](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dclothes) [coffee](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcoffee) [collector](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcollector) [computer](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcomputer) [confectionery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dconfectionery) [convenience](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dconvenience) [copyshop](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcopyshop) [cosmetics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcosmetics) [country_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcountry_store) [craft](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcraft) [curtain](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcurtain) [dairy](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddairy) [deli](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddeli) [department_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddepartment_store) [doityourself](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddoityourself) [doors](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddoors) [dry_cleaning](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddry_cleaning) [e-cigarette](https://wiki.openstreetmap.org/wiki/Tag:shop%3De-cigarette) [electrical](https://wiki.openstreetmap.org/wiki/Tag:shop%3Delectrical) [electronics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Delectronics) [erotic](https://wiki.openstreetmap.org/wiki/Tag:shop%3Derotic) [fabric](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfabric) [farm](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfarm) [fashion_accessories](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfashion_accessories) [fireplace](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfireplace) [fishing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfishing) [flooring](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dflooring) [florist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dflorist) [frame](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dframe) [frozen_food](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfrozen_food) [fuel](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfuel) [funeral_directors](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfuneral_directors) [furniture](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfurniture) [games](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgames) [garden_centre](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgarden_centre) [gas](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgas) [general](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgeneral) [gift](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgift) [greengrocer](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgreengrocer) [hairdresser](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhairdresser) [hairdresser_supply](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhairdresser_supply) [hardware](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhardware) [health_food](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhealth_food) [hearing_aids](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhearing_aids) [herbalist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dherbalist) [hifi](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhifi) [hobby](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhobby) [household_linen](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhousehold_linen) [houseware](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhouseware) [hunting](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhunting) [interior_decoration](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dinterior_decoration) [jewelry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Djewelry) [kiosk](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dkiosk) [kitchen](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dkitchen) [laundry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlaundry) [leather](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dleather) [lighting](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlighting) [locksmith](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlocksmith) [lottery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlottery) [mall](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmall) [massage](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmassage) [medical_supply](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmedical_supply) [military_surplus](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmilitary_surplus) [mobile_phone](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmobile_phone) [model](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmodel) [money_lender](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmoney_lender) [motorcycle](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmotorcycle) [motorcycle_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmotorcycle_repair) [music](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmusic) [musical_instrument](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmusical_instrument) [newsagent](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dnewsagent) [nutrition_supplements](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dnutrition_supplements) [optician](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doptician) [outdoor](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doutdoor) [outpost](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doutpost) [paint](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpaint) [party](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dparty) [pastry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpastry) [pawnbroker](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpawnbroker) [perfumery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dperfumery) [pet](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpet) [pet_grooming](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpet_grooming) [photo](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dphoto) [pottery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpottery) [printer_ink](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dprinter_ink) [psychic](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpsychic) [pyrotechnics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpyrotechnics) [radiotechnics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dradiotechnics) [religion](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dreligion) [rental](https://wiki.openstreetmap.org/wiki/Tag:shop%3Drental) [repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Drepair) [scuba_diving](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dscuba_diving) [seafood](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dseafood) [second_hand](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsecond_hand) [sewing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsewing) [shoe_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dshoe_repair) [shoes](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dshoes) [spices](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dspices) [sports](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsports) [stationery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dstationery) [storage_rental](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dstorage_rental) [supermarket](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsupermarket) [swimming_pool](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dswimming_pool) [tailor](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtailor) [tattoo](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtattoo) [tea](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtea) [telecommunication](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtelecommunication) [ticket](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dticket) [tiles](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtiles) [tobacco](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtobacco) [tool_hire](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtool_hire) [toys](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtoys) [trade](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtrade) [travel_agency](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtravel_agency) [trophy](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtrophy) [tyres](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtyres) [vacuum_cleaner](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvacuum_cleaner) [variety_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvariety_store) [video](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvideo) [video_games](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvideo_games) [watches](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwatches) [water](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwater) [water_sports](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwater_sports) [weapons](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dweapons) [wholesale](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwholesale) [wigs](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwigs) [window_blind](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwindow_blind) [wine](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwine)
+[
](https://taginfo.openstreetmap.org/keys/shop#values) [shop](https://wiki.openstreetmap.org/wiki/Key:shop) | [string](../SpecialInputElements.md#string) | [vacant](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvacant) [agrarian](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dagrarian) [alcohol](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dalcohol) [anime](https://wiki.openstreetmap.org/wiki/Tag:shop%3Danime) [antiques](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dantiques) [appliance](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dappliance) [art](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dart) [baby_goods](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbaby_goods) [bag](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbag) [bakery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbakery) [bathroom_furnishing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbathroom_furnishing) [beauty](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbeauty) [bed](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbed) [beverages](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbeverages) [bicycle](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbicycle) [boat](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dboat) [bookmaker](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbookmaker) [books](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbooks) [brewing_supplies](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbrewing_supplies) [butcher](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dbutcher) [camera](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcamera) [candles](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcandles) [cannabis](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcannabis) [car](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar) [car_parts](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar_parts) [car_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcar_repair) [caravan](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcaravan) [carpet](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcarpet) [catalogue](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcatalogue) [charity](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcharity) [cheese](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcheese) [chemist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dchemist) [chocolate](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dchocolate) [clothes](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dclothes) [coffee](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcoffee) [collector](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcollector) [computer](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcomputer) [confectionery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dconfectionery) [convenience](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dconvenience) [copyshop](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcopyshop) [cosmetics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcosmetics) [country_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcountry_store) [craft](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcraft) [curtain](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dcurtain) [dairy](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddairy) [deli](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddeli) [department_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddepartment_store) [doityourself](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddoityourself) [doors](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddoors) [dry_cleaning](https://wiki.openstreetmap.org/wiki/Tag:shop%3Ddry_cleaning) [e-cigarette](https://wiki.openstreetmap.org/wiki/Tag:shop%3De-cigarette) [electrical](https://wiki.openstreetmap.org/wiki/Tag:shop%3Delectrical) [electronics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Delectronics) [erotic](https://wiki.openstreetmap.org/wiki/Tag:shop%3Derotic) [fabric](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfabric) [farm](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfarm) [fashion_accessories](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfashion_accessories) [fireplace](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfireplace) [fishing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfishing) [flooring](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dflooring) [florist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dflorist) [frame](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dframe) [frozen_food](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfrozen_food) [fuel](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfuel) [funeral_directors](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfuneral_directors) [furniture](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dfurniture) [games](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgames) [garden_centre](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgarden_centre) [gas](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgas) [general](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgeneral) [gift](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgift) [greengrocer](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dgreengrocer) [hairdresser](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhairdresser) [hairdresser_supply](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhairdresser_supply) [hardware](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhardware) [health_food](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhealth_food) [hearing_aids](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhearing_aids) [herbalist](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dherbalist) [hifi](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhifi) [honey](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhoney) [household_linen](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhousehold_linen) [houseware](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhouseware) [hunting](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dhunting) [interior_decoration](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dinterior_decoration) [jewelry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Djewelry) [kiosk](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dkiosk) [kitchen](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dkitchen) [laundry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlaundry) [leather](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dleather) [lighting](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlighting) [locksmith](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlocksmith) [lottery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dlottery) [mall](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmall) [massage](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmassage) [medical_supply](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmedical_supply) [military_surplus](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmilitary_surplus) [mobile_phone](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmobile_phone) [model](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmodel) [money_lender](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmoney_lender) [motorcycle](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmotorcycle) [motorcycle_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmotorcycle_repair) [music](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmusic) [musical_instrument](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dmusical_instrument) [newsagent](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dnewsagent) [nutrition_supplements](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dnutrition_supplements) [nuts](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dnuts) [optician](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doptician) [outdoor](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doutdoor) [outpost](https://wiki.openstreetmap.org/wiki/Tag:shop%3Doutpost) [paint](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpaint) [party](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dparty) [pasta](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpasta) [pastry](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpastry) [pawnbroker](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpawnbroker) [perfumery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dperfumery) [pet](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpet) [pet_grooming](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpet_grooming) [photo](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dphoto) [pottery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpottery) [printer_ink](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dprinter_ink) [psychic](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpsychic) [pyrotechnics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dpyrotechnics) [radiotechnics](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dradiotechnics) [religion](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dreligion) [rental](https://wiki.openstreetmap.org/wiki/Tag:shop%3Drental) [repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Drepair) [rice](https://wiki.openstreetmap.org/wiki/Tag:shop%3Drice) [scuba_diving](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dscuba_diving) [seafood](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dseafood) [second_hand](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsecond_hand) [sewing](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsewing) [shoe_repair](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dshoe_repair) [shoes](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dshoes) [spices](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dspices) [sports](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsports) [stationery](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dstationery) [storage_rental](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dstorage_rental) [supermarket](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dsupermarket) [swimming_pool](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dswimming_pool) [tailor](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtailor) [tattoo](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtattoo) [tea](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtea) [telecommunication](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtelecommunication) [ticket](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dticket) [tiles](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtiles) [tobacco](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtobacco) [tool_hire](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtool_hire) [toys](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtoys) [trade](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtrade) [travel_agency](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtravel_agency) [trophy](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtrophy) [tyres](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dtyres) [vacuum_cleaner](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvacuum_cleaner) [variety_store](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvariety_store) [video](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvideo) [video_games](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dvideo_games) [watches](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwatches) [water](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwater) [water_sports](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwater_sports) [weapons](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dweapons) [wholesale](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwholesale) [wigs](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwigs) [window_blind](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwindow_blind) [wine](https://wiki.openstreetmap.org/wiki/Tag:shop%3Dwine)
[
](https://taginfo.openstreetmap.org/keys/second_hand#values) [second_hand](https://wiki.openstreetmap.org/wiki/Key:second_hand) | Multiple choice | [only](https://wiki.openstreetmap.org/wiki/Tag:second_hand%3Donly) [yes](https://wiki.openstreetmap.org/wiki/Tag:second_hand%3Dyes) [no](https://wiki.openstreetmap.org/wiki/Tag:second_hand%3Dno)
[
](https://taginfo.openstreetmap.org/keys/opening_hours#values) [opening_hours](https://wiki.openstreetmap.org/wiki/Key:opening_hours) | [opening_hours](../SpecialInputElements.md#opening_hours) |
[
](https://taginfo.openstreetmap.org/keys/website#values) [website](https://wiki.openstreetmap.org/wiki/Key:website) | [url](../SpecialInputElements.md#url) |
@@ -124,10 +124,11 @@ This is rendered with `This is a {shop}`
+ - *Vacant Shop* corresponds with `shop=vacant`
- *Farm Supply Shop* corresponds with `shop=agrarian`
- *Liquor Store* corresponds with `shop=alcohol`
- *Anime / Manga Shop* corresponds with `shop=anime`
- - *Antiques Shop* corresponds with `shop=antiques`
+ - *Antique Shop* corresponds with `shop=antiques`
- *Appliance Store* corresponds with `shop=appliance`
- *Art Store* corresponds with `shop=art`
- *Baby Goods Store* corresponds with `shop=baby_goods`
@@ -140,7 +141,7 @@ This is rendered with `This is a {shop}`
- *Bicycle Shop* corresponds with `shop=bicycle`
- *Boat Store* corresponds with `shop=boat`
- *Bookmaker* corresponds with `shop=bookmaker`
- - *Book Store* corresponds with `shop=books`
+ - *Bookstore* corresponds with `shop=books`
- *Brewing Supply Store* corresponds with `shop=brewing_supplies`
- *Butcher* corresponds with `shop=butcher`
- *Camera Equipment Store* corresponds with `shop=camera`
@@ -164,11 +165,11 @@ This is rendered with `This is a {shop}`
- *Convenience Store* corresponds with `shop=convenience`
- *Copy Store* corresponds with `shop=copyshop`
- *Cosmetics Store* corresponds with `shop=cosmetics`
- - *Country Store* corresponds with `shop=country_store`
+ - *Rural Supplies Store* corresponds with `shop=country_store`
- *Arts & Crafts Store* corresponds with `shop=craft`
- *Curtain Store* corresponds with `shop=curtain`
- *Dairy Store* corresponds with `shop=dairy`
- - *Deli* corresponds with `shop=deli`
+ - *Delicatessen* corresponds with `shop=deli`
- *Department Store* corresponds with `shop=department_store`
- *DIY Store* corresponds with `shop=doityourself`
- *Door Shop* corresponds with `shop=doors`
@@ -198,11 +199,11 @@ This is rendered with `This is a {shop}`
- *Hairdresser* corresponds with `shop=hairdresser`
- *Hairdresser Supply Store* corresponds with `shop=hairdresser_supply`
- *Hardware Store* corresponds with `shop=hardware`
- - *Health Food Shop* corresponds with `shop=health_food`
+ - *Health Food Store* corresponds with `shop=health_food`
- *Hearing Aids Store* corresponds with `shop=hearing_aids`
- *Herbalist* corresponds with `shop=herbalist`
- *Hifi Store* corresponds with `shop=hifi`
- - *Hobby Shop* corresponds with `shop=hobby`
+ - *Honey Store* corresponds with `shop=honey`
- *Household Linen Shop* corresponds with `shop=household_linen`
- *Houseware Store* corresponds with `shop=houseware`
- *Hunting Shop* corresponds with `shop=hunting`
@@ -226,18 +227,20 @@ This is rendered with `This is a {shop}`
- *Motorcycle Repair Shop* corresponds with `shop=motorcycle_repair`
- *Music Store* corresponds with `shop=music`
- *Musical Instrument Store* corresponds with `shop=musical_instrument`
- - *Newspaper/Magazine Shop* corresponds with `shop=newsagent`
+ - *Newsstand* corresponds with `shop=newsagent`
- *Nutrition Supplements Store* corresponds with `shop=nutrition_supplements`
+ - *Nuts Shop* corresponds with `shop=nuts`
- *Optician* corresponds with `shop=optician`
- *Outdoors Store* corresponds with `shop=outdoor`
- *Online Retailer Outpost* corresponds with `shop=outpost`
- *Paint Store* corresponds with `shop=paint`
- *Party Supply Store* corresponds with `shop=party`
+ - *Pasta Store* corresponds with `shop=pasta`
- *Pastry Shop* corresponds with `shop=pastry`
- - *Pawn Shop* corresponds with `shop=pawnbroker`
+ - *Pawnshop* corresponds with `shop=pawnbroker`
- *Perfume Store* corresponds with `shop=perfumery`
- *Pet Store* corresponds with `shop=pet`
- - *Pet Grooming Store* corresponds with `shop=pet_grooming`
+ - *Pet Groomer* corresponds with `shop=pet_grooming`
- *Photography Store* corresponds with `shop=photo`
- *Pottery Store* corresponds with `shop=pottery`
- *Printer Ink Store* corresponds with `shop=printer_ink`
@@ -247,9 +250,10 @@ This is rendered with `This is a {shop}`
- *Religious Store* corresponds with `shop=religion`
- *Rental Shop* corresponds with `shop=rental`
- *Repair Shop* corresponds with `shop=repair`
+ - *Rice Store* corresponds with `shop=rice`
- *Scuba Diving Shop* corresponds with `shop=scuba_diving`
- *Seafood Shop* corresponds with `shop=seafood`
- - *Consignment/Thrift Store* corresponds with `shop=second_hand`
+ - *Thrift Store* corresponds with `shop=second_hand`
- *Sewing Supply Shop* corresponds with `shop=sewing`
- *Shoe Repair Shop* corresponds with `shop=shoe_repair`
- *Shoe Store* corresponds with `shop=shoes`
@@ -273,7 +277,7 @@ This is rendered with `This is a {shop}`
- *Trophy Shop* corresponds with `shop=trophy`
- *Tire Store* corresponds with `shop=tyres`
- *Vacuum Cleaner Store* corresponds with `shop=vacuum_cleaner`
- - *Variety Store* corresponds with `shop=variety_store`
+ - *Discount Store* corresponds with `shop=variety_store`
- *Video Store* corresponds with `shop=video`
- *Video Game Store* corresponds with `shop=video_games`
- *Watches Shop* corresponds with `shop=watches`
@@ -474,6 +478,25 @@ This tagrendering is only visible in the popup if the following condition is met
+### key_cutter
+
+
+
+This tagrendering has no question and is thus read-only
+
+
+
+
+
+ - *This shop is also specialized in key cutting* corresponds with `craft=key_cutter`
+ - *This shop offers key cutting as a service* corresponds with `service:key_cutting=yes`
+ - *This shops does not offer key cutting as a service* corresponds with `service:key_cutting=no`
+
+
+This tagrendering is only visible in the popup if the following condition is met: `shop=shoe_repair|service:key_cutting~.+|craft=key_cutting|shop=diy|shop=doityourself|shop=home_improvement|shop=hardware|shop=locksmith|shop=repair`
+
+
+
### internet
@@ -571,6 +594,8 @@ The question is *Does this shop have a sugar free offering?*
This tagrendering is only visible in the popup if the following condition is met: `shop=supermarket|shop=convenience|shop=farm|shop=greengrocer|shop=health_food|shop=deli|shop=bakery|shop=beverages|shop=beverages|shop=pastry|shop=chocolate|shop=frozen_food|shop=ice_cream`
+This tagrendering has labels `diets`
+
### gluten_free
@@ -591,6 +616,8 @@ The question is *Does this shop have a gluten free offering?*
This tagrendering is only visible in the popup if the following condition is met: `shop=supermarket|shop=convenience|shop=farm|shop=greengrocer|shop=health_food|shop=deli|shop=bakery|shop=beverages|shop=beverages|shop=pastry|shop=chocolate|shop=frozen_food|shop=ice_cream`
+This tagrendering has labels `diets`
+
### lactose_free
@@ -611,6 +638,8 @@ The question is *Does {title()} have a lactose-free offering?*
This tagrendering is only visible in the popup if the following condition is met: `shop=supermarket|shop=convenience|shop=farm|shop=greengrocer|shop=health_food|shop=deli|shop=bakery|shop=beverages|shop=beverages|shop=pastry|shop=chocolate|shop=frozen_food|shop=ice_cream`
+This tagrendering has labels `diets`
+
### questions
diff --git a/Docs/Layers/sports_centre.md b/Docs/Layers/sports_centre.md
index c77e31cd6e..6e59ed727f 100644
--- a/Docs/Layers/sports_centre.md
+++ b/Docs/Layers/sports_centre.md
@@ -5,7 +5,7 @@
-
+
Indoor and outdoor sports centres can be found on this layer
diff --git a/Docs/Layers/street_lamps.md b/Docs/Layers/street_lamps.md
index b1ebb5f35b..a70f2fbf9c 100644
--- a/Docs/Layers/street_lamps.md
+++ b/Docs/Layers/street_lamps.md
@@ -5,7 +5,7 @@
-
+
A layer showing street lights
diff --git a/Docs/Layers/streets_without_etymology.md b/Docs/Layers/streets_without_etymology.md
index 16f8889455..3daa575925 100644
--- a/Docs/Layers/streets_without_etymology.md
+++ b/Docs/Layers/streets_without_etymology.md
@@ -5,7 +5,7 @@
-
+
All objects which have an etymology known
diff --git a/Docs/Layers/surveillance_camera.md b/Docs/Layers/surveillance_camera.md
index d28122081a..02cff62e04 100644
--- a/Docs/Layers/surveillance_camera.md
+++ b/Docs/Layers/surveillance_camera.md
@@ -5,7 +5,7 @@
-
+
This layer shows surveillance cameras and allows a contributor to update information and add new cameras
diff --git a/Docs/Layers/tertiary_education.md b/Docs/Layers/tertiary_education.md
index c23a00117b..474a87e29e 100644
--- a/Docs/Layers/tertiary_education.md
+++ b/Docs/Layers/tertiary_education.md
@@ -5,7 +5,7 @@
-
+
Layer with all tertiary education institutes (ISCED:2011 levels 6,7 and 8)
diff --git a/Docs/Layers/ticket_machine.md b/Docs/Layers/ticket_machine.md
index 66f52f04a9..185b7e2205 100644
--- a/Docs/Layers/ticket_machine.md
+++ b/Docs/Layers/ticket_machine.md
@@ -5,7 +5,7 @@
-
+
Find ticket machines for public transport tickets
diff --git a/Docs/Layers/ticket_validator.md b/Docs/Layers/ticket_validator.md
index 2e318d7160..06784aac23 100644
--- a/Docs/Layers/ticket_validator.md
+++ b/Docs/Layers/ticket_validator.md
@@ -5,7 +5,7 @@
-
+
Find ticket validators to validate public transport tickets
diff --git a/Docs/Layers/toekomstige_fietsstraat.md b/Docs/Layers/toekomstige_fietsstraat.md
index e81537a41e..0aae30d05c 100644
--- a/Docs/Layers/toekomstige_fietsstraat.md
+++ b/Docs/Layers/toekomstige_fietsstraat.md
@@ -15,6 +15,7 @@ This street will become a cyclestreet soon
- This layer is shown at zoomlevel **9** and higher
+ - Not rendered on the map by default. If you want to rendering this on the map, override `mapRenderings`
diff --git a/Docs/Layers/toilet.md b/Docs/Layers/toilet.md
index f5a2c53348..31f03134f3 100644
--- a/Docs/Layers/toilet.md
+++ b/Docs/Layers/toilet.md
@@ -5,7 +5,7 @@
-
+
A layer showing (public) toilets
diff --git a/Docs/Layers/toilet_at_amenity.md b/Docs/Layers/toilet_at_amenity.md
index a2d81be2a8..7e8d94e478 100644
--- a/Docs/Layers/toilet_at_amenity.md
+++ b/Docs/Layers/toilet_at_amenity.md
@@ -5,7 +5,7 @@
-
+
A layer showing (public) toilets located at different places.
diff --git a/Docs/Layers/toursistic_places_without_etymology.md b/Docs/Layers/toursistic_places_without_etymology.md
index 5dd7db5c3b..e4904dd2d0 100644
--- a/Docs/Layers/toursistic_places_without_etymology.md
+++ b/Docs/Layers/toursistic_places_without_etymology.md
@@ -5,7 +5,7 @@
-
+
All objects which have an etymology known
diff --git a/Docs/Layers/trail.md b/Docs/Layers/trail.md
index 20e6a5a15c..cc4f2b23dd 100644
--- a/Docs/Layers/trail.md
+++ b/Docs/Layers/trail.md
@@ -5,7 +5,7 @@
-
+
Aangeduide wandeltochten
diff --git a/Docs/Layers/transit_stops.md b/Docs/Layers/transit_stops.md
index da394aa414..2044648030 100644
--- a/Docs/Layers/transit_stops.md
+++ b/Docs/Layers/transit_stops.md
@@ -5,7 +5,7 @@
-
+
Layer showing different types of transit stops.
diff --git a/Docs/Layers/tree_node.md b/Docs/Layers/tree_node.md
index bee1fa70ec..50db16d72a 100644
--- a/Docs/Layers/tree_node.md
+++ b/Docs/Layers/tree_node.md
@@ -5,7 +5,7 @@
-
+
A layer showing trees
diff --git a/Docs/Layers/vending_machine.md b/Docs/Layers/vending_machine.md
index d753e486c6..4deeef5e71 100644
--- a/Docs/Layers/vending_machine.md
+++ b/Docs/Layers/vending_machine.md
@@ -5,7 +5,7 @@
-
+
Layer showing vending machines
diff --git a/Docs/Layers/veterinary.md b/Docs/Layers/veterinary.md
index 4d76758c1e..3730721cdb 100644
--- a/Docs/Layers/veterinary.md
+++ b/Docs/Layers/veterinary.md
@@ -5,7 +5,7 @@
-
+
A layer showing veterinarians
diff --git a/Docs/Layers/viewpoint.md b/Docs/Layers/viewpoint.md
index 1c69a1c994..d941c86ff8 100644
--- a/Docs/Layers/viewpoint.md
+++ b/Docs/Layers/viewpoint.md
@@ -5,7 +5,7 @@
-
+
A nice viewpoint or nice view. Ideal to add an image if no other category fits
diff --git a/Docs/Layers/village_green.md b/Docs/Layers/village_green.md
index efcdef4e8d..4c5d4d0324 100644
--- a/Docs/Layers/village_green.md
+++ b/Docs/Layers/village_green.md
@@ -5,7 +5,7 @@
-
+
A layer showing village-green (which are communal green areas, but not quite parks)
diff --git a/Docs/Layers/visitor_information_centre.md b/Docs/Layers/visitor_information_centre.md
index 00a30bc2f0..7891b9c163 100644
--- a/Docs/Layers/visitor_information_centre.md
+++ b/Docs/Layers/visitor_information_centre.md
@@ -5,7 +5,7 @@
-
+
A visitor center offers information about a specific attraction or place of interest where it is located.
diff --git a/Docs/Layers/waste_basket.md b/Docs/Layers/waste_basket.md
index 479b1e21ad..8502188265 100644
--- a/Docs/Layers/waste_basket.md
+++ b/Docs/Layers/waste_basket.md
@@ -5,7 +5,7 @@
-
+
This is a public waste basket, thrash can, where you can throw away your thrash.
diff --git a/Docs/Layers/waste_disposal.md b/Docs/Layers/waste_disposal.md
index 2a9b9697a1..9593066b88 100644
--- a/Docs/Layers/waste_disposal.md
+++ b/Docs/Layers/waste_disposal.md
@@ -5,7 +5,7 @@
-
+
Waste Disposal Bin, medium to large bin for disposal of (household) waste
diff --git a/Docs/Layers/windturbine.md b/Docs/Layers/windturbine.md
index db9bfbb47c..3d2ccac0f5 100644
--- a/Docs/Layers/windturbine.md
+++ b/Docs/Layers/windturbine.md
@@ -5,7 +5,7 @@
-
+
Modern windmills generating electricity
diff --git a/Docs/Schemas/AndOrTagConfigJson.schema.json b/Docs/Schemas/AndOrTagConfigJson.schema.json
deleted file mode 100644
index a6214c2ea0..0000000000
--- a/Docs/Schemas/AndOrTagConfigJson.schema.json
+++ /dev/null
@@ -1,39 +0,0 @@
-{
- "$ref": "#/definitions/AndOrTagConfigJson",
- "definitions": {
- "AndOrTagConfigJson": {
- "type": "object",
- "properties": {
- "and": {
- "type": "array",
- "items": {
- "anyOf": [
- {
- "$ref": "#/definitions/AndOrTagConfigJson"
- },
- {
- "type": "string"
- }
- ]
- }
- },
- "or": {
- "type": "array",
- "items": {
- "anyOf": [
- {
- "$ref": "#/definitions/AndOrTagConfigJson"
- },
- {
- "type": "string"
- }
- ]
- }
- }
- },
- "additionalProperties": false
- }
- },
- "$schema": "http://json-schema.org/draft-07/schema#",
- "additionalProperties": false
-}
\ No newline at end of file
diff --git a/Docs/Schemas/AndOrTagConfigJsonJSC.ts b/Docs/Schemas/AndOrTagConfigJsonJSC.ts
deleted file mode 100644
index 3da8b5b091..0000000000
--- a/Docs/Schemas/AndOrTagConfigJsonJSC.ts
+++ /dev/null
@@ -1,37 +0,0 @@
-export default {
- "$ref": "#/definitions/AndOrTagConfigJson",
- "definitions": {
- "AndOrTagConfigJson": {
- "type": "object",
- "properties": {
- "and": {
- "type": "array",
- "items": {
- "anyOf": [
- {
- "$ref": "#/definitions/AndOrTagConfigJson"
- },
- {
- "type": "string"
- }
- ]
- }
- },
- "or": {
- "type": "array",
- "items": {
- "anyOf": [
- {
- "$ref": "#/definitions/AndOrTagConfigJson"
- },
- {
- "type": "string"
- }
- ]
- }
- }
- }
- }
- },
- "$schema": "http://json-schema.org/draft-07/schema#"
-}
\ No newline at end of file
diff --git a/Docs/Schemas/AndTagConfigJson.schema.json b/Docs/Schemas/AndTagConfigJson.schema.json
deleted file mode 100644
index 9f510d6b26..0000000000
--- a/Docs/Schemas/AndTagConfigJson.schema.json
+++ /dev/null
@@ -1,66 +0,0 @@
-{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
- "definitions": {
- "TagConfigJson": {
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation",
- "anyOf": [
- {
- "$ref": "#/definitions/AndTagConfigJson"
- },
- {
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
- "type": "object",
- "properties": {
- "or": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/TagConfigJson"
- }
- }
- },
- "required": [
- "or"
- ]
- },
- {
- "type": "string"
- }
- ]
- },
- "AndTagConfigJson": {
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
- "type": "object",
- "properties": {
- "and": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/TagConfigJson"
- }
- }
- },
- "required": [
- "and"
- ],
- "additionalProperties": false
- },
- "OrTagConfigJson": {
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
- "type": "object",
- "properties": {
- "or": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/TagConfigJson"
- }
- }
- },
- "required": [
- "or"
- ],
- "additionalProperties": false
- }
- },
- "$schema": "http://json-schema.org/draft-07/schema#",
- "additionalProperties": false
-}
\ No newline at end of file
diff --git a/Docs/Schemas/AndTagConfigJsonJSC.ts b/Docs/Schemas/AndTagConfigJsonJSC.ts
deleted file mode 100644
index 2903f36b1a..0000000000
--- a/Docs/Schemas/AndTagConfigJsonJSC.ts
+++ /dev/null
@@ -1,63 +0,0 @@
-export default {
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
- "definitions": {
- "TagConfigJson": {
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation",
- "anyOf": [
- {
- "$ref": "#/definitions/AndTagConfigJson"
- },
- {
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
- "type": "object",
- "properties": {
- "or": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/TagConfigJson"
- }
- }
- },
- "required": [
- "or"
- ]
- },
- {
- "type": "string"
- }
- ]
- },
- "AndTagConfigJson": {
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
- "type": "object",
- "properties": {
- "and": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/TagConfigJson"
- }
- }
- },
- "required": [
- "and"
- ]
- },
- "OrTagConfigJson": {
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
- "type": "object",
- "properties": {
- "or": {
- "type": "array",
- "items": {
- "$ref": "#/definitions/TagConfigJson"
- }
- }
- },
- "required": [
- "or"
- ]
- }
- },
- "$schema": "http://json-schema.org/draft-07/schema#"
-}
\ No newline at end of file
diff --git a/Docs/Schemas/DeleteConfigJson.schema.json b/Docs/Schemas/DeleteConfigJson.schema.json
index 398b287679..b7bbec42aa 100644
--- a/Docs/Schemas/DeleteConfigJson.schema.json
+++ b/Docs/Schemas/DeleteConfigJson.schema.json
@@ -1,6 +1,10 @@
{
"type": "object",
"properties": {
+ "neededChangesets": {
+ "description": "*\nBy default, the contributor needs 20 previous changesets to delete points edited by others.\nFor some small features (e.g. bicycle racks) this is too much and this requirement can be lowered or dropped, which can be done here.\n\ntype: nat\nquestion: How many changesets must a contributor have before being allowed to delete a point?",
+ "type": "number"
+ },
"extraDeleteReasons": {
"description": "*\nBy default, three reasons to delete a point are shown:\n\n- The point does not exist anymore\n- The point was a testing point\n- THe point could not be found\n\nHowever, for some layers, there might be different or more specific reasons for deletion which can be user friendly to set, e.g.:\n\n- the shop has closed\n- the climbing route has been closed of for nature conservation reasons\n- ...\n\nThese reasons can be stated here and will be shown in the list of options the user can choose from",
"type": "array",
@@ -8,10 +12,10 @@
"type": "object",
"properties": {
"explanation": {
- "description": "The text that will be shown to the user - translatable"
+ "description": "The text that will be shown to the user as option for why this point does not exist anymore.\nNote that the most common reasons (test point, does not exist anymore, cannot be found) are already offered by default\n\nquestion: For what extra reason might this feature be removed in real-life?"
},
"changesetMessage": {
- "description": "The text that will be uploaded into the changeset or will be used in the fixme in case of a soft deletion\nShould be a few words, in english",
+ "description": "The text that will be uploaded into the changeset or will be used in the fixme in case of a soft deletion\nShould be a few words, in english\n\nquestion: What should be added to the changeset as delete reason?",
"type": "string"
}
},
@@ -29,10 +33,10 @@
"properties": {
"if": {
"$ref": "#/definitions/TagConfigJson",
- "description": "The tags that will be given to the object.\nThis must remove tags so that the 'source/osmTags' won't match anymore"
+ "description": "The tags that will be given to the object.\nThis must remove tags so that the 'source/osmTags' won't match anymore\n\nquestion: What tags should be applied to the object?"
},
"then": {
- "description": "The human explanation for the options"
+ "description": "The human explanation for the options\n\nquestion: What text should be shown to the contributor for this reason?"
}
},
"required": [
@@ -42,39 +46,32 @@
}
},
"softDeletionTags": {
- "description": "In some cases, the contributor is not allowed to delete the current feature (e.g. because it isn't a point, the point is referenced by a relation or the user isn't experienced enough).\nTo still offer the user a 'delete'-option, the feature is retagged with these tags. This is a soft deletion, as the point isn't actually removed from OSM but rather marked as 'disused'\nIt is important that the feature will be retagged in such a way that it won't be picked up by the layer anymore!\n\nExample (note that \"amenity=\" erases the 'amenity'-key alltogether):\n```\n{\n \"and\": [\"disussed:amenity=public_bookcase\", \"amenity=\"]\n}\n```\n\nor (notice the use of the ':='-tag to copy the old value of 'shop=*' into 'disused:shop='):\n```\n{\n \"and\": [\"disused:shop:={shop}\", \"shop=\"]\n}\n```",
+ "description": "In some cases, the contributor is not allowed to delete the current feature (e.g. because it isn't a point, the point is referenced by a relation or the user isn't experienced enough).\nTo still offer the user a 'delete'-option, the feature is retagged with these tags. This is a soft deletion, as the point isn't actually removed from OSM but rather marked as 'disused'\nIt is important that the feature will be retagged in such a way that it won't be picked up by the layer anymore!\n\nExample (note that \"amenity=\" erases the 'amenity'-key alltogether):\n\n```\n{\n \"and\": [\"disussed:amenity=public_bookcase\", \"amenity=\"]\n}\n```\n\nor (notice the use of the ':='-tag to copy the old value of 'shop=*' into 'disused:shop='):\n\n```\n{\n \"and\": [\"disused:shop:={shop}\", \"shop=\"]\n}\n```\n\nquestion: If a hard delete is not possible, what tags should be applied to mark this feature as deleted?\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
}
]
},
- "neededChangesets": {
- "description": "*\nBy default, the contributor needs 20 previous changesets to delete points edited by others.\nFor some small features (e.g. bicycle racks) this is too much and this requirement can be lowered or dropped, which can be done here.",
- "type": "number"
- },
"omitDefaultDeleteReasons": {
- "description": "Set this flag if the default delete reasons should be omitted from the dialog.\nThis requires at least one extraDeleteReason or nonDeleteMapping",
+ "description": "Set this flag if the default delete reasons should be omitted from the dialog.\nThis requires at least one extraDeleteReason or nonDeleteMapping\n\nquestion: Should the default delete reasons be hidden?\niftrue: Hide the default delete reasons\niffalse: Show the default delete reasons\nifunset: Show the default delete reasons (default behaviour)",
"type": "boolean"
}
},
"definitions": {
"TagConfigJson": {
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation",
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
"type": "object",
"properties": {
"or": {
@@ -93,8 +90,7 @@
}
]
},
- "AndTagConfigJson": {
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{and:TagConfigJson[];}": {
"type": "object",
"properties": {
"and": {
@@ -109,8 +105,7 @@
],
"additionalProperties": false
},
- "OrTagConfigJson": {
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{or:TagConfigJson[];}": {
"type": "object",
"properties": {
"or": {
diff --git a/Docs/Schemas/DeleteConfigJsonJSC.ts b/Docs/Schemas/DeleteConfigJsonJSC.ts
index 04e4b61143..afb24d2dd8 100644
--- a/Docs/Schemas/DeleteConfigJsonJSC.ts
+++ b/Docs/Schemas/DeleteConfigJsonJSC.ts
@@ -1,6 +1,10 @@
export default {
"type": "object",
"properties": {
+ "neededChangesets": {
+ "description": "*\nBy default, the contributor needs 20 previous changesets to delete points edited by others.\nFor some small features (e.g. bicycle racks) this is too much and this requirement can be lowered or dropped, which can be done here.\n\ntype: nat\nquestion: How many changesets must a contributor have before being allowed to delete a point?",
+ "type": "number"
+ },
"extraDeleteReasons": {
"description": "*\nBy default, three reasons to delete a point are shown:\n\n- The point does not exist anymore\n- The point was a testing point\n- THe point could not be found\n\nHowever, for some layers, there might be different or more specific reasons for deletion which can be user friendly to set, e.g.:\n\n- the shop has closed\n- the climbing route has been closed of for nature conservation reasons\n- ...\n\nThese reasons can be stated here and will be shown in the list of options the user can choose from",
"type": "array",
@@ -8,10 +12,10 @@ export default {
"type": "object",
"properties": {
"explanation": {
- "description": "The text that will be shown to the user - translatable"
+ "description": "The text that will be shown to the user as option for why this point does not exist anymore.\nNote that the most common reasons (test point, does not exist anymore, cannot be found) are already offered by default\n\nquestion: For what extra reason might this feature be removed in real-life?"
},
"changesetMessage": {
- "description": "The text that will be uploaded into the changeset or will be used in the fixme in case of a soft deletion\nShould be a few words, in english",
+ "description": "The text that will be uploaded into the changeset or will be used in the fixme in case of a soft deletion\nShould be a few words, in english\n\nquestion: What should be added to the changeset as delete reason?",
"type": "string"
}
},
@@ -29,10 +33,10 @@ export default {
"properties": {
"if": {
"$ref": "#/definitions/TagConfigJson",
- "description": "The tags that will be given to the object.\nThis must remove tags so that the 'source/osmTags' won't match anymore"
+ "description": "The tags that will be given to the object.\nThis must remove tags so that the 'source/osmTags' won't match anymore\n\nquestion: What tags should be applied to the object?"
},
"then": {
- "description": "The human explanation for the options"
+ "description": "The human explanation for the options\n\nquestion: What text should be shown to the contributor for this reason?"
}
},
"required": [
@@ -42,39 +46,32 @@ export default {
}
},
"softDeletionTags": {
- "description": "In some cases, the contributor is not allowed to delete the current feature (e.g. because it isn't a point, the point is referenced by a relation or the user isn't experienced enough).\nTo still offer the user a 'delete'-option, the feature is retagged with these tags. This is a soft deletion, as the point isn't actually removed from OSM but rather marked as 'disused'\nIt is important that the feature will be retagged in such a way that it won't be picked up by the layer anymore!\n\nExample (note that \"amenity=\" erases the 'amenity'-key alltogether):\n```\n{\n \"and\": [\"disussed:amenity=public_bookcase\", \"amenity=\"]\n}\n```\n\nor (notice the use of the ':='-tag to copy the old value of 'shop=*' into 'disused:shop='):\n```\n{\n \"and\": [\"disused:shop:={shop}\", \"shop=\"]\n}\n```",
+ "description": "In some cases, the contributor is not allowed to delete the current feature (e.g. because it isn't a point, the point is referenced by a relation or the user isn't experienced enough).\nTo still offer the user a 'delete'-option, the feature is retagged with these tags. This is a soft deletion, as the point isn't actually removed from OSM but rather marked as 'disused'\nIt is important that the feature will be retagged in such a way that it won't be picked up by the layer anymore!\n\nExample (note that \"amenity=\" erases the 'amenity'-key alltogether):\n\n```\n{\n \"and\": [\"disussed:amenity=public_bookcase\", \"amenity=\"]\n}\n```\n\nor (notice the use of the ':='-tag to copy the old value of 'shop=*' into 'disused:shop='):\n\n```\n{\n \"and\": [\"disused:shop:={shop}\", \"shop=\"]\n}\n```\n\nquestion: If a hard delete is not possible, what tags should be applied to mark this feature as deleted?\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
}
]
},
- "neededChangesets": {
- "description": "*\nBy default, the contributor needs 20 previous changesets to delete points edited by others.\nFor some small features (e.g. bicycle racks) this is too much and this requirement can be lowered or dropped, which can be done here.",
- "type": "number"
- },
"omitDefaultDeleteReasons": {
- "description": "Set this flag if the default delete reasons should be omitted from the dialog.\nThis requires at least one extraDeleteReason or nonDeleteMapping",
+ "description": "Set this flag if the default delete reasons should be omitted from the dialog.\nThis requires at least one extraDeleteReason or nonDeleteMapping\n\nquestion: Should the default delete reasons be hidden?\niftrue: Hide the default delete reasons\niffalse: Show the default delete reasons\nifunset: Show the default delete reasons (default behaviour)",
"type": "boolean"
}
},
"definitions": {
"TagConfigJson": {
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation",
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
"type": "object",
"properties": {
"or": {
@@ -93,8 +90,7 @@ export default {
}
]
},
- "AndTagConfigJson": {
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{and:TagConfigJson[];}": {
"type": "object",
"properties": {
"and": {
@@ -108,8 +104,7 @@ export default {
"and"
]
},
- "OrTagConfigJson": {
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{or:TagConfigJson[];}": {
"type": "object",
"properties": {
"or": {
diff --git a/Docs/Schemas/DenominationConfigJson.schema.json b/Docs/Schemas/DenominationConfigJson.schema.json
index cfde140100..a5086168fa 100644
--- a/Docs/Schemas/DenominationConfigJson.schema.json
+++ b/Docs/Schemas/DenominationConfigJson.schema.json
@@ -2,13 +2,12 @@
"$ref": "#/definitions/DenominationConfigJson",
"definitions": {
"TagConfigJson": {
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation",
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
"type": "object",
"properties": {
"or": {
@@ -27,8 +26,7 @@
}
]
},
- "AndTagConfigJson": {
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{and:TagConfigJson[];}": {
"type": "object",
"properties": {
"and": {
@@ -43,8 +41,7 @@
],
"additionalProperties": false
},
- "OrTagConfigJson": {
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{or:TagConfigJson[];}": {
"type": "object",
"properties": {
"or": {
diff --git a/Docs/Schemas/DenominationConfigJsonJSC.ts b/Docs/Schemas/DenominationConfigJsonJSC.ts
index fd7b2494f3..acc2c079fd 100644
--- a/Docs/Schemas/DenominationConfigJsonJSC.ts
+++ b/Docs/Schemas/DenominationConfigJsonJSC.ts
@@ -2,13 +2,12 @@ export default {
"$ref": "#/definitions/DenominationConfigJson",
"definitions": {
"TagConfigJson": {
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation",
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
"type": "object",
"properties": {
"or": {
@@ -27,8 +26,7 @@ export default {
}
]
},
- "AndTagConfigJson": {
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{and:TagConfigJson[];}": {
"type": "object",
"properties": {
"and": {
@@ -42,8 +40,7 @@ export default {
"and"
]
},
- "OrTagConfigJson": {
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{or:TagConfigJson[];}": {
"type": "object",
"properties": {
"or": {
diff --git a/Docs/Schemas/ExtraLinkConfigJson.schema.json b/Docs/Schemas/ExtraLinkConfigJson.schema.json
index 157922a93a..4a298f5bad 100644
--- a/Docs/Schemas/ExtraLinkConfigJson.schema.json
+++ b/Docs/Schemas/ExtraLinkConfigJson.schema.json
@@ -2,16 +2,30 @@
"type": "object",
"properties": {
"icon": {
+ "description": "question: What icon should be shown in the link button?\nifunset: do not show an icon\ntype: icon",
"type": "string"
},
- "text": {},
+ "text": {
+ "description": "question: What text should be shown in the link icon?\n\nNote that {lat},{lon},{zoom}, {language} and {theme} will be replaced\n\nifunset: do not show a text",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
"href": {
+ "description": "question: if clicked, what webpage should open?\nNote that {lat},{lon},{zoom}, {language} and {theme} will be replaced\n\ntype: url",
"type": "string"
},
"newTab": {
+ "description": "question: Should the link open in a new tab?\niftrue: Open in a new tab\niffalse: do not open in a new tab\nifunset: do not open in a new tab",
"type": "boolean"
},
"requirements": {
+ "description": "question: When should the extra button be shown?\nsuggestions: return [{if: \"value=iframe\", then: \"When shown in an iframe\"}, {if: \"value=no-iframe\", then: \"When shown as stand-alone webpage\"}, {if: \"value=welcome-message\", then: \"When the welcome messages are enabled\"}, {if: \"value=iframe\", then: \"When the welcome messages are disabled\"}]",
"type": "array",
"items": {
"enum": [
@@ -29,13 +43,12 @@
],
"definitions": {
"TagConfigJson": {
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation",
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
"type": "object",
"properties": {
"or": {
@@ -54,8 +67,7 @@
}
]
},
- "AndTagConfigJson": {
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{and:TagConfigJson[];}": {
"type": "object",
"properties": {
"and": {
@@ -70,8 +82,7 @@
],
"additionalProperties": false
},
- "OrTagConfigJson": {
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{or:TagConfigJson[];}": {
"type": "object",
"properties": {
"or": {
@@ -85,6 +96,10 @@
"or"
],
"additionalProperties": false
+ },
+ "Record": {
+ "type": "object",
+ "additionalProperties": false
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
diff --git a/Docs/Schemas/ExtraLinkConfigJsonJSC.ts b/Docs/Schemas/ExtraLinkConfigJsonJSC.ts
index 762e6f4ad9..b822d4604b 100644
--- a/Docs/Schemas/ExtraLinkConfigJsonJSC.ts
+++ b/Docs/Schemas/ExtraLinkConfigJsonJSC.ts
@@ -2,16 +2,30 @@ export default {
"type": "object",
"properties": {
"icon": {
+ "description": "question: What icon should be shown in the link button?\nifunset: do not show an icon\ntype: icon",
"type": "string"
},
- "text": {},
+ "text": {
+ "description": "question: What text should be shown in the link icon?\n\nNote that {lat},{lon},{zoom}, {language} and {theme} will be replaced\n\nifunset: do not show a text",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
"href": {
+ "description": "question: if clicked, what webpage should open?\nNote that {lat},{lon},{zoom}, {language} and {theme} will be replaced\n\ntype: url",
"type": "string"
},
"newTab": {
+ "description": "question: Should the link open in a new tab?\niftrue: Open in a new tab\niffalse: do not open in a new tab\nifunset: do not open in a new tab",
"type": "boolean"
},
"requirements": {
+ "description": "question: When should the extra button be shown?\nsuggestions: return [{if: \"value=iframe\", then: \"When shown in an iframe\"}, {if: \"value=no-iframe\", then: \"When shown as stand-alone webpage\"}, {if: \"value=welcome-message\", then: \"When the welcome messages are enabled\"}, {if: \"value=iframe\", then: \"When the welcome messages are disabled\"}]",
"type": "array",
"items": {
"enum": [
@@ -29,13 +43,12 @@ export default {
],
"definitions": {
"TagConfigJson": {
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation",
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
"type": "object",
"properties": {
"or": {
@@ -54,8 +67,7 @@ export default {
}
]
},
- "AndTagConfigJson": {
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{and:TagConfigJson[];}": {
"type": "object",
"properties": {
"and": {
@@ -69,8 +81,7 @@ export default {
"and"
]
},
- "OrTagConfigJson": {
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{or:TagConfigJson[];}": {
"type": "object",
"properties": {
"or": {
@@ -83,6 +94,9 @@ export default {
"required": [
"or"
]
+ },
+ "Record": {
+ "type": "object"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
diff --git a/Docs/Schemas/FilterConfigJson.schema.json b/Docs/Schemas/FilterConfigJson.schema.json
index 3158c033bd..2d91892f2b 100644
--- a/Docs/Schemas/FilterConfigJson.schema.json
+++ b/Docs/Schemas/FilterConfigJson.schema.json
@@ -13,15 +13,13 @@
"properties": {
"question": {},
"osmTags": {
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation",
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -66,13 +64,12 @@
],
"definitions": {
"TagConfigJson": {
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation",
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
"type": "object",
"properties": {
"or": {
@@ -91,8 +88,7 @@
}
]
},
- "AndTagConfigJson": {
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{and:TagConfigJson[];}": {
"type": "object",
"properties": {
"and": {
@@ -107,8 +103,7 @@
],
"additionalProperties": false
},
- "OrTagConfigJson": {
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{or:TagConfigJson[];}": {
"type": "object",
"properties": {
"or": {
@@ -122,6 +117,10 @@
"or"
],
"additionalProperties": false
+ },
+ "Record": {
+ "type": "object",
+ "additionalProperties": false
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
diff --git a/Docs/Schemas/FilterConfigJsonJSC.ts b/Docs/Schemas/FilterConfigJsonJSC.ts
index 2f41e95216..62ba6448d6 100644
--- a/Docs/Schemas/FilterConfigJsonJSC.ts
+++ b/Docs/Schemas/FilterConfigJsonJSC.ts
@@ -13,15 +13,13 @@ export default {
"properties": {
"question": {},
"osmTags": {
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation",
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -66,13 +64,12 @@ export default {
],
"definitions": {
"TagConfigJson": {
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation",
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
"type": "object",
"properties": {
"or": {
@@ -91,8 +88,7 @@ export default {
}
]
},
- "AndTagConfigJson": {
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{and:TagConfigJson[];}": {
"type": "object",
"properties": {
"and": {
@@ -106,8 +102,7 @@ export default {
"and"
]
},
- "OrTagConfigJson": {
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{or:TagConfigJson[];}": {
"type": "object",
"properties": {
"or": {
@@ -120,6 +115,9 @@ export default {
"required": [
"or"
]
+ },
+ "Record": {
+ "type": "object"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
diff --git a/Docs/Schemas/IconConfigJson.schema.json b/Docs/Schemas/IconConfigJson.schema.json
new file mode 100644
index 0000000000..04ab8296fd
--- /dev/null
+++ b/Docs/Schemas/IconConfigJson.schema.json
@@ -0,0 +1,219 @@
+{
+ "type": "object",
+ "properties": {
+ "icon": {
+ "description": "question: What icon should be used?\ntype: icon\nsuggestions: return [\"pin\",\"square\",\"circle\",\"checkmark\",\"clock\",\"close\",\"crosshair\",\"help\",\"home\",\"invalid\",\"location\",\"location_empty\",\"location_locked\",\"note\",\"resolved\",\"ring\",\"scissors\",\"teardrop\",\"teardrop_with_hole_green\",\"triangle\"].map(i => ({if: \"value=\"+i, then: i, icon: i}))",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
+ },
+ {
+ "type": "object",
+ "properties": {
+ "builtin": {
+ "type": "string"
+ },
+ "override": {}
+ },
+ "required": [
+ "builtin",
+ "override"
+ ]
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "color": {
+ "description": "question: What colour should the icon be?\nThis will only work for the default icons such as `pin`,`circle`,...\ntype: color",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
+ },
+ {
+ "type": "object",
+ "properties": {
+ "builtin": {
+ "type": "string"
+ },
+ "override": {}
+ },
+ "required": [
+ "builtin",
+ "override"
+ ]
+ },
+ {
+ "type": "string"
+ }
+ ]
+ }
+ },
+ "required": [
+ "icon"
+ ],
+ "definitions": {
+ "TagConfigJson": {
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
+ },
+ {
+ "type": "object",
+ "properties": {
+ "or": {
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/TagConfigJson"
+ }
+ }
+ },
+ "required": [
+ "or"
+ ]
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "{and:TagConfigJson[];}": {
+ "type": "object",
+ "properties": {
+ "and": {
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/TagConfigJson"
+ }
+ }
+ },
+ "required": [
+ "and"
+ ],
+ "additionalProperties": false
+ },
+ "{or:TagConfigJson[];}": {
+ "type": "object",
+ "properties": {
+ "or": {
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/TagConfigJson"
+ }
+ }
+ },
+ "required": [
+ "or"
+ ],
+ "additionalProperties": false
+ },
+ "Record": {
+ "type": "object",
+ "additionalProperties": false
+ },
+ "Record>": {
+ "type": "object",
+ "additionalProperties": false
+ },
+ "DenominationConfigJson": {
+ "type": "object",
+ "properties": {
+ "useIfNoUnitGiven": {
+ "description": "If this evaluates to true and the value to interpret has _no_ unit given, assumes that this unit is meant.\nAlternatively, a list of country codes can be given where this acts as the default interpretation\n\nE.g., a denomination using \"meter\" would probably set this flag to \"true\";\na denomination for \"mp/h\" will use the condition \"_country=gb\" to indicate that it is the default in the UK.\n\nIf none of the units indicate that they are the default, the first denomination will be used instead",
+ "anyOf": [
+ {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ {
+ "type": "boolean"
+ }
+ ]
+ },
+ "canonicalDenomination": {
+ "description": "The canonical value for this denomination which will be added to the value in OSM.\ne.g. \"m\" for meters\nIf the user inputs '42', the canonical value will be added and it'll become '42m'.\n\nImportant: often, _no_ canonical values are expected, e.g. in the case of 'maxspeed' where 'km/h' is the default.\nIn this case, an empty string should be used",
+ "type": "string"
+ },
+ "canonicalDenominationSingular": {
+ "description": "The canonical denomination in the case that the unit is precisely '1'.\nUsed for display purposes only.\n\nE.g.: for duration of something in minutes: `2 minutes` but `1 minute`; the `minute` goes here",
+ "type": "string"
+ },
+ "alternativeDenomination": {
+ "description": "A list of alternative values which can occur in the OSM database - used for parsing.\nE.g.: while 'm' is canonical, `meter`, `mtrs`, ... can occur as well",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "human": {
+ "description": "The value for humans in the dropdown. This should not use abbreviations and should be translated, e.g.\n{\n \"en\": \"meter\",\n \"fr\": \"metre\"\n}",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "humanSingular": {
+ "description": "The value for humans in the dropdown. This should not use abbreviations and should be translated, e.g.\n{\n \"en\": \"minute\",\n \"nl\": \"minuut\"\n}",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "prefix": {
+ "description": "If set, then the canonical value will be prefixed instead, e.g. for '€'\nNote that if all values use 'prefix', the dropdown might move to before the text field",
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "canonicalDenomination"
+ ],
+ "additionalProperties": false
+ },
+ "MinimalTagRenderingConfigJson": {
+ "description": "Mostly used for lineRendering and pointRendering",
+ "type": "object",
+ "properties": {
+ "render": {
+ "description": "question: What value should be rendered?\n\nThis piece of text will be shown in the infobox.\nNote that \"&LBRACEkey&RBRACE\"-parts are substituted by the corresponding values of the element.\n\nThis value will be used if there is no mapping which matches (or there are no matches)\nNote that this is a HTML-interpreted value, so you can add links as e.g. '<a href='{website}'>{website}</a>' or include images such as `This is of type A <br><img src='typeA-icon.svg' />`",
+ "type": "string"
+ },
+ "mappings": {
+ "description": "Allows fixed-tag inputs, shown either as radiobuttons or as checkboxes",
+ "type": "array",
+ "items": {
+ "type": "object",
+ "properties": {
+ "if": {
+ "$ref": "#/definitions/TagConfigJson",
+ "description": "question: When should this single mapping match?\n\nIf this condition is met, then the text under `then` will be shown.\nIf no value matches, and the user selects this mapping as an option, then these tags will be uploaded to OSM.\n\nFor example: {'if': 'diet:vegetarion=yes', 'then':'A vegetarian option is offered here'}\n\nThis can be an substituting-tag as well, e.g. {'if': 'addr:street:={_calculated_nearby_streetname}', 'then': '{_calculated_nearby_streetname}'}"
+ },
+ "then": {
+ "description": "question: What text should be shown?\n\nIf the condition `if` is met, the text `then` will be rendered.\nIf not known yet, the user will be presented with `then` as an option",
+ "type": "string"
+ }
+ },
+ "required": [
+ "if",
+ "then"
+ ]
+ }
+ }
+ },
+ "additionalProperties": false
+ }
+ },
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "additionalProperties": false
+}
\ No newline at end of file
diff --git a/Docs/Schemas/IconConfigJsonJSC.ts b/Docs/Schemas/IconConfigJsonJSC.ts
new file mode 100644
index 0000000000..e5d116ac1a
--- /dev/null
+++ b/Docs/Schemas/IconConfigJsonJSC.ts
@@ -0,0 +1,212 @@
+export default {
+ "type": "object",
+ "properties": {
+ "icon": {
+ "description": "question: What icon should be used?\ntype: icon\nsuggestions: return [\"pin\",\"square\",\"circle\",\"checkmark\",\"clock\",\"close\",\"crosshair\",\"help\",\"home\",\"invalid\",\"location\",\"location_empty\",\"location_locked\",\"note\",\"resolved\",\"ring\",\"scissors\",\"teardrop\",\"teardrop_with_hole_green\",\"triangle\"].map(i => ({if: \"value=\"+i, then: i, icon: i}))",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
+ },
+ {
+ "type": "object",
+ "properties": {
+ "builtin": {
+ "type": "string"
+ },
+ "override": {}
+ },
+ "required": [
+ "builtin",
+ "override"
+ ]
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "color": {
+ "description": "question: What colour should the icon be?\nThis will only work for the default icons such as `pin`,`circle`,...\ntype: color",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
+ },
+ {
+ "type": "object",
+ "properties": {
+ "builtin": {
+ "type": "string"
+ },
+ "override": {}
+ },
+ "required": [
+ "builtin",
+ "override"
+ ]
+ },
+ {
+ "type": "string"
+ }
+ ]
+ }
+ },
+ "required": [
+ "icon"
+ ],
+ "definitions": {
+ "TagConfigJson": {
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
+ },
+ {
+ "type": "object",
+ "properties": {
+ "or": {
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/TagConfigJson"
+ }
+ }
+ },
+ "required": [
+ "or"
+ ]
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "{and:TagConfigJson[];}": {
+ "type": "object",
+ "properties": {
+ "and": {
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/TagConfigJson"
+ }
+ }
+ },
+ "required": [
+ "and"
+ ]
+ },
+ "{or:TagConfigJson[];}": {
+ "type": "object",
+ "properties": {
+ "or": {
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/TagConfigJson"
+ }
+ }
+ },
+ "required": [
+ "or"
+ ]
+ },
+ "Record": {
+ "type": "object"
+ },
+ "Record>": {
+ "type": "object"
+ },
+ "DenominationConfigJson": {
+ "type": "object",
+ "properties": {
+ "useIfNoUnitGiven": {
+ "description": "If this evaluates to true and the value to interpret has _no_ unit given, assumes that this unit is meant.\nAlternatively, a list of country codes can be given where this acts as the default interpretation\n\nE.g., a denomination using \"meter\" would probably set this flag to \"true\";\na denomination for \"mp/h\" will use the condition \"_country=gb\" to indicate that it is the default in the UK.\n\nIf none of the units indicate that they are the default, the first denomination will be used instead",
+ "anyOf": [
+ {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ {
+ "type": "boolean"
+ }
+ ]
+ },
+ "canonicalDenomination": {
+ "description": "The canonical value for this denomination which will be added to the value in OSM.\ne.g. \"m\" for meters\nIf the user inputs '42', the canonical value will be added and it'll become '42m'.\n\nImportant: often, _no_ canonical values are expected, e.g. in the case of 'maxspeed' where 'km/h' is the default.\nIn this case, an empty string should be used",
+ "type": "string"
+ },
+ "canonicalDenominationSingular": {
+ "description": "The canonical denomination in the case that the unit is precisely '1'.\nUsed for display purposes only.\n\nE.g.: for duration of something in minutes: `2 minutes` but `1 minute`; the `minute` goes here",
+ "type": "string"
+ },
+ "alternativeDenomination": {
+ "description": "A list of alternative values which can occur in the OSM database - used for parsing.\nE.g.: while 'm' is canonical, `meter`, `mtrs`, ... can occur as well",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "human": {
+ "description": "The value for humans in the dropdown. This should not use abbreviations and should be translated, e.g.\n{\n \"en\": \"meter\",\n \"fr\": \"metre\"\n}",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "humanSingular": {
+ "description": "The value for humans in the dropdown. This should not use abbreviations and should be translated, e.g.\n{\n \"en\": \"minute\",\n \"nl\": \"minuut\"\n}",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "prefix": {
+ "description": "If set, then the canonical value will be prefixed instead, e.g. for '€'\nNote that if all values use 'prefix', the dropdown might move to before the text field",
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "canonicalDenomination"
+ ]
+ },
+ "MinimalTagRenderingConfigJson": {
+ "description": "Mostly used for lineRendering and pointRendering",
+ "type": "object",
+ "properties": {
+ "render": {
+ "description": "question: What value should be rendered?\n\nThis piece of text will be shown in the infobox.\nNote that \"&LBRACEkey&RBRACE\"-parts are substituted by the corresponding values of the element.\n\nThis value will be used if there is no mapping which matches (or there are no matches)\nNote that this is a HTML-interpreted value, so you can add links as e.g. '<a href='{website}'>{website}</a>' or include images such as `This is of type A <br><img src='typeA-icon.svg' />`",
+ "type": "string"
+ },
+ "mappings": {
+ "description": "Allows fixed-tag inputs, shown either as radiobuttons or as checkboxes",
+ "type": "array",
+ "items": {
+ "type": "object",
+ "properties": {
+ "if": {
+ "$ref": "#/definitions/TagConfigJson",
+ "description": "question: When should this single mapping match?\n\nIf this condition is met, then the text under `then` will be shown.\nIf no value matches, and the user selects this mapping as an option, then these tags will be uploaded to OSM.\n\nFor example: {'if': 'diet:vegetarion=yes', 'then':'A vegetarian option is offered here'}\n\nThis can be an substituting-tag as well, e.g. {'if': 'addr:street:={_calculated_nearby_streetname}', 'then': '{_calculated_nearby_streetname}'}"
+ },
+ "then": {
+ "description": "question: What text should be shown?\n\nIf the condition `if` is met, the text `then` will be rendered.\nIf not known yet, the user will be presented with `then` as an option",
+ "type": "string"
+ }
+ },
+ "required": [
+ "if",
+ "then"
+ ]
+ }
+ }
+ }
+ }
+ },
+ "$schema": "http://json-schema.org/draft-07/schema#"
+}
\ No newline at end of file
diff --git a/Docs/Schemas/LayerConfigJson.schema.json b/Docs/Schemas/LayerConfigJson.schema.json
index e7eb813fc4..a3b9cb4521 100644
--- a/Docs/Schemas/LayerConfigJson.schema.json
+++ b/Docs/Schemas/LayerConfigJson.schema.json
@@ -3,11 +3,11 @@
"type": "object",
"properties": {
"id": {
- "description": "The id of this layer.\nThis should be a simple, lowercase, human readable string that is used to identify the layer.",
+ "description": "question: What is the identifier of this layer?\n\nThis should be a simple, lowercase, human readable string that is used to identify the layer.\n A good ID is:\n - a noun\n - written in singular\n - describes the object\n - in english\n - only has lowercase letters, numbers or underscores. Do not use a space or a dash\n\ntype: id\ngroup: Basic",
"type": "string"
},
"name": {
- "description": "The name of this layer\nUsed in the layer control panel and the 'Personal theme'.\n\nIf not given, will be hidden (and thus not toggable) in the layer control",
+ "description": "Used in the layer control panel to toggle a layer on and of.\n\nifunset: This will hide the layer in the layer control, making it not filterable and not toggleable\n\ngroup: Basic\nquestion: What is the name of this layer?",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -18,7 +18,7 @@
]
},
"description": {
- "description": "A description for this layer.\nShown in the layer selections and in the personel theme",
+ "description": "A description for the features shown in this layer.\nThis often resembles the introduction of the wiki.osm.org-page for this feature.\n\ngroup: Basic\nquestion: How would you describe the features that are shown on this layer?",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -29,17 +29,17 @@
]
},
"source": {
- "description": "This determines where the data for the layer is fetched: from OSM or from an external geojson dataset.\n\nIf no 'geojson' is defined, data will be fetched from overpass and the OSM-API.\n\nEvery source _must_ define which tags _must_ be present in order to be picked up.\n\nNote: a source must always be defined. 'special' is only allowed if this is a builtin-layer",
+ "description": "Question: Where should the data be fetched from?\ntitle: Data Source\n\nThis determines where the data for the layer is fetched: from OSM or from an external geojson dataset.\n\nIf no 'geojson' is defined, data will be fetched from overpass and the OSM-API.\n\nEvery source _must_ define which tags _must_ be present in order to be picked up.\n\nNote: a source must always be defined. 'special' is only allowed if this is a builtin-layer\n\ntypes: Load data with specific tags from OpenStreetMap ; Load data from an external geojson source ;\ntypesdefault: 0\ngroup: Basic",
"anyOf": [
{
"type": "object",
"properties": {
"osmTags": {
"$ref": "#/definitions/TagConfigJson",
- "description": "Every source must set which tags have to be present in order to load the given layer."
+ "description": "question: Which tags must be present on the feature to show it in this layer?\nEvery source must set which tags have to be present in order to load the given layer."
},
"maxCacheAge": {
- "description": "The maximum amount of seconds that a tile is allowed to linger in the cache",
+ "description": "question: How long (in seconds) is the data allowed to remain cached until it must be refreshed?\nThe maximum amount of seconds that a tile is allowed to linger in the cache\n\ntype: nat\ndefault: 30 days",
"type": "number"
}
},
@@ -51,23 +51,23 @@
"type": "object",
"properties": {
"geoJson": {
- "description": "The actual source of the data to load, if loaded via geojson.\n\n# A single geojson-file\nsource: {geoJson: \"https://my.source.net/some-geo-data.geojson\"}\n fetches a geojson from a third party source\n\n# A tiled geojson source\nsource: {geoJson: \"https://my.source.net/some-tile-geojson-{layer}-{z}-{x}-{y}.geojson\", geoJsonZoomLevel: 14}\n to use a tiled geojson source. The web server must offer multiple geojsons. {z}, {x} and {y} are substituted by the location; {layer} is substituted with the id of the loaded layer\n\nSome API's use a BBOX instead of a tile, this can be used by specifying {y_min}, {y_max}, {x_min} and {x_max}",
+ "description": "The actual source of the data to load, if loaded via geojson.\n\n# A single geojson-file\nsource: {geoJson: \"https://my.source.net/some-geo-data.geojson\"}\n fetches a geojson from a third party source\n\n# A tiled geojson source\nsource: {geoJson: \"https://my.source.net/some-tile-geojson-{layer}-{z}-{x}-{y}.geojson\", geoJsonZoomLevel: 14}\n to use a tiled geojson source. The web server must offer multiple geojsons. {z}, {x} and {y} are substituted by the location; {layer} is substituted with the id of the loaded layer\n\nSome API's use a BBOX instead of a tile, this can be used by specifying {y_min}, {y_max}, {x_min} and {x_max}\n\nquestion: What is the URL of the geojson?\ntype: url",
"type": "string"
},
"geoJsonZoomLevel": {
- "description": "To load a tiled geojson layer, set the zoomlevel of the tiles",
+ "description": "To load a tiled geojson layer, set the zoomlevel of the tiles\n\nquestion: If using a tiled geojson, what is the zoomlevel of the tiles?\nifunset: This is not a tiled geojson",
"type": "number"
},
"isOsmCache": {
- "description": "Indicates that the upstream geojson data is OSM-derived.\nUseful for e.g. merging or for scripts generating this cache",
+ "description": "Indicates that the upstream geojson data is OSM-derived.\nUseful for e.g. merging or for scripts generating this cache.\nThis also indicates that making changes on this data is possible\n\nquestion: Is this geojson a cache of OpenStreetMap data?\nifunset: This is not an OpenStreetMap cache\niftrue: this is based on OpenStreetMap and can thus be edited",
"type": "boolean"
},
"mercatorCrs": {
- "description": "Some API's use a mercator-projection (EPSG:900913) instead of WGS84. Set the flag `mercatorCrs: true` in the source for this",
+ "description": "Some API's use a mercator-projection (EPSG:900913) instead of WGS84. Set the flag `mercatorCrs: true` in the source for this\n\nquestion: Does this geojson use EPSG:900913 instead of WGS84 as projection?\niftrue: This geojson uses EPSG:900913 instead of WGS84\nifunset: This geojson uses WGS84 just like most geojson (default)",
"type": "boolean"
},
"idKey": {
- "description": "Some API's have an id-field, but give it a different name.\nSetting this key will rename this field into 'id'",
+ "description": "Some API's have an id-field, but give it a different name.\nSetting this key will rename this field into 'id'\n\nifunset: An id with key `id` will be assigned automatically if no attribute `id` is set\ninline: This geojson uses {value} as attribute to set the id\nquestion: What is the name of the attribute containing the ID of the object?",
"type": "string"
}
},
@@ -85,51 +85,44 @@
]
},
"calculatedTags": {
- "description": "A list of extra tags to calculate, specified as \"keyToAssignTo=javascript-expression\".\nThere are a few extra functions available. Refer to Docs/CalculatedTags.md for more information\nThe functions will be run in order, e.g.\n[\n \"_max_overlap_m2=Math.max(...feat.overlapsWith(\"someOtherLayer\").map(o => o.overlap))\n \"_max_overlap_ratio=Number(feat._max_overlap_m2)/feat.area\n]\n\nThe specified tags are evaluated lazily. E.g. if a calculated tag is only used in the popup (e.g. the number of nearby features),\nthe expensive calculation will only be performed then for that feature. This avoids clogging up the contributors PC when all features are loaded.\n\nIf a tag has to be evaluated strictly, use ':=' instead:\n\n[\n\"_some_key:=some_javascript_expression\"\n]",
+ "description": "A list of extra tags to calculate, specified as \"keyToAssignTo=javascript-expression\".\nThere are a few extra functions available. Refer to Docs/CalculatedTags.md for more information\nThe functions will be run in order, e.g.\n[\nNot found... * \"_max_overlap_m2=Math.max(...feat.overlapsWith(\"someOtherLayer\").map(o => o.overlap))\n \"_max_overlap_ratio=Number(feat._max_overlap_m2)/feat.area\n]\n\nThe specified tags are evaluated lazily. E.g. if a calculated tag is only used in the popup (e.g. the number of nearby features),\nthe expensive calculation will only be performed then for that feature. This avoids clogging up the contributors PC when all features are loaded.\n\nIf a tag has to be evaluated strictly, use ':=' instead:\n\n[\n\"_some_key:=some_javascript_expression\"\n]\n\nSee the full documentation on [https://github.com/pietervdvn/MapComplete/blob/master/Docs/CalculatedTags.md]\n\ngroup: expert\nquestion: What extra attributes should be calculated with javascript?",
"type": "array",
"items": {
"type": "string"
}
},
- "doNotDownload": {
- "description": "If set, this layer will not query overpass; but it'll still match the tags above which are by chance returned by other layers.\nWorks well together with 'passAllFeatures', to add decoration",
- "type": "boolean"
- },
"isShown": {
- "description": "If set, only features matching this extra tag will be shown.\nThis is useful to hide certain features from view.\n\nImportant: hiding features does not work dynamically, but is only calculated when the data is first renders.\nThis implies that it is not possible to hide a feature after a tagging change\n\nThe default value is 'yes'",
+ "description": "If set, only features matching this extra tag will be shown.\nThis is useful to hide certain features from view based on a calculated tag or if the features are provided by a different layer.\n\nquestion: What other tags should features match for being shown?\ngroup: advanced\nifunset: all features which match the 'source'-specification are shown.",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
}
]
},
- "forceLoad": {
- "description": "Advanced option - might be set by the theme compiler\n\nIf true, this data will _always_ be loaded, even if the theme is disabled",
- "type": "boolean"
- },
"minzoom": {
- "description": "The minimum needed zoomlevel required before loading of the data start\nDefault: 0",
+ "description": "The minimum needed zoomlevel required to start loading and displaying the data.\nThis can be used to only show common features (e.g. a bicycle parking) only when the map is zoomed in very much (17).\nThis prevents cluttering the map with thousands of parkings if one is looking to an entire city.\n\nDefault: 0\ngroup: Basic\ntype: nat\nquestion: At what zoom level should features of the layer be shown?\nifunset: Always load this layer, even if the entire world is in view.",
"type": "number"
},
"shownByDefault": {
- "description": "Indicates if this layer is shown by default;\ncan be used to hide a layer from start, or to load the layer but only to show it where appropriate (e.g. for snapping to it)",
+ "description": "Indicates if this layer is shown by default;\ncan be used to hide a layer from start, or to load the layer but only to show it when appropriate (e.g. for advanced users)\n\nquestion: Should this layer be enabled when opening the map for the first time?\niftrue: the layer is enabled when opening the map\niffalse: the layer is hidden until the contributor enables it. (If the filter-popup is disabled, this might never get enabled nor loaded)\ndefault: true\ngroup: advanced",
"type": "boolean"
},
"minzoomVisible": {
- "description": "The zoom level at which point the data is hidden again\nDefault: 100 (thus: always visible",
+ "description": "The zoom level at which point the data is hidden again\nDefault: 100 (thus: always visible\n\ngroup: expert",
"type": "number"
},
"title": {
- "description": "The title shown in a popup for elements of this layer.",
+ "description": "question: What title should be shown on the infobox?\nThe title shown in a popup for elements of this layer.\n\ngroup: title\ntypes: use a fixed translation ; Use a dynamic tagRendering ; hidden\ntypesdefault: 1\ntype: translation\ninline: {translated{value}}",
"anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
{
"$ref": "#/definitions/TagRenderingConfigJson"
},
@@ -138,8 +131,12 @@
}
]
},
+ "popupInFloatover": {
+ "description": "Question: Should the information for this layer be shown in the sidebar or in a splash screen?\n\nIf set, open the selectedElementView in a floatOver instead of on the right.\n\niftrue: show the infobox in the splashscreen floating over the entire UI\niffalse: show the infobox in a sidebar on the right\ngroup: advanced\ndefault: sidebar",
+ "type": "boolean"
+ },
"titleIcons": {
- "description": "Small icons shown next to the title.\nIf not specified, the OsmLink and wikipedia links will be used by default.\nUse an empty array to hide them.\nNote that \"defaults\" will insert all the default titleIcons (which are added automatically)\n\nType: icon[]",
+ "description": "Small icons shown next to the title.\nIf not specified, the OsmLink and wikipedia links will be used by default.\nUse an empty array to hide them.\nNote that \"defaults\" will insert all the default titleIcons (which are added automatically)\n\nType: icon[]\ngroup: infobox",
"anyOf": [
{
"type": "array",
@@ -169,42 +166,40 @@
}
]
},
- "mapRendering": {
- "description": "Visualisation of the items on the map",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "anyOf": [
- {
- "$ref": "#/definitions/default_4"
- },
- {
- "$ref": "#/definitions/default_5"
- },
- {
- "$ref": "#/definitions/default"
- }
- ]
- }
- },
- {
- "type": "null"
- }
- ]
+ "pointRendering": {
+ "description": "Creates points to render on the map.\nThis can render points for point-objects, lineobjects or areaobjects; use 'location' to indicate where it should be rendered\ngroup: pointrendering",
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/default_4"
+ }
+ },
+ "lineRendering": {
+ "description": "Creates lines and areas to render on the map\ngroup: linerendering",
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/default_5"
+ }
},
"passAllFeatures": {
- "description": "If set, this layer will pass all the features it receives onto the next layer.\nThis is ideal for decoration, e.g. directionss on cameras",
+ "description": "If set, this layer will pass all the features it receives onto the next layer.\nThis is ideal for decoration, e.g. directions on cameras\niftrue: Make the features from this layer also available to the other layer; might result in this object being rendered by multiple layers\niffalse: normal behaviour: don't pass features allong\nquestion: should this layer pass features to the next layers?\ngroup: expert",
+ "type": "boolean"
+ },
+ "doNotDownload": {
+ "description": "If set, this layer will not query overpass; but it'll still match the tags above which are by chance returned by other layers.\nWorks well together with 'passAllFeatures', to add decoration\nThe opposite of `forceLoad`\n\niftrue: Do not attempt to query the data for this layer from overpass/the OSM API\niffalse: download the data as usual\ngroup: expert\nquestion: Should this layer be downloaded or is the data provided by a different layer (which has 'passAllFeatures'-set)?\ndefault: false",
+ "type": "boolean"
+ },
+ "forceLoad": {
+ "description": "Advanced option - might be set by the theme compiler\n\nIf true, this data will _always_ be loaded, even if the theme is disabled by a filter or hidden.\nThe opposite of `doNotDownload`\n\nquestion: Should this layer be forcibly loaded?\nifftrue: always download this layer, even if it is disabled\niffalse: only download data for this layer when needed (default)\ndefault: false\ngroup: expert",
"type": "boolean"
},
"presets": {
- "description": "Presets for this layer.\nA preset shows up when clicking the map on a without data (or when right-clicking/long-pressing);\nit will prompt the user to add a new point.\n\nThe most important aspect are the tags, which define which tags the new point will have;\nThe title is shown in the dialog, along with the first sentence of the description.\n\nUpon confirmation, the full description is shown beneath the buttons - perfect to add pictures and examples.\n\nNote: the icon of the preset is determined automatically based on the tags and the icon above. Don't worry about that!\nNB: if no presets are defined, the popup to add new points doesn't show up at all",
+ "description": "Presets for this layer.\nA preset shows up when clicking the map on a without data (or when right-clicking/long-pressing);\nit will prompt the user to add a new point.\n\nThe most important aspect are the tags, which define which tags the new point will have;\nThe title is shown in the dialog, along with the first sentence of the description.\n\nUpon confirmation, the full description is shown beneath the buttons - perfect to add pictures and examples.\n\nNote: the icon of the preset is determined automatically based on the tags and the icon above. Don't worry about that!\nNB: if no presets are defined, the popup to add new points doesn't show up at all\n\ngroup: presets",
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
- "description": "The title - shown on the 'add-new'-button.\n\nThis should include the article of the noun, e.g. 'a hydrant', 'a bicycle pump'.\nThis text will be inserted into `Add {category} here`, becoming `Add a hydrant here`.\n\nDo _not_ indicate 'new': 'add a new shop here' is incorrect, as the shop might have existed forever, it could just be unmapped!",
+ "description": "The title - shown on the 'add-new'-button.\n\nThis should include the article of the noun, e.g. 'a hydrant', 'a bicycle pump'.\nThis text will be inserted into `Add {category} here`, becoming `Add a hydrant here`.\n\nDo _not_ indicate 'new': 'add a new shop here' is incorrect, as the shop might have existed forever, it could just be unmapped!\n\nquestion: What is the word to describe this object?\ninline: Add {translated(value)::font-bold} here",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -215,14 +210,14 @@
]
},
"tags": {
- "description": "The tags to add. It determines the icon too",
+ "description": "A single tag (encoded as key=value
) out of all the tags to add onto the newly created point.\nNote that the icon in the UI will be chosen automatically based on the tags provided here.\n\nquestion: What tag should be added to the new object?\ntype: simple_tag\ntypeHelper: uploadableOnly",
"type": "array",
"items": {
"type": "string"
}
},
"description": {
- "description": "The _first sentence_ of the description is shown on the button of the `add` menu.\nThe full description is shown in the confirmation dialog.\n\n(The first sentence is until the first '.'-character in the description)",
+ "description": "An extra explanation of what the feature is, if it is not immediately clear from the title alone.\n\nThe _first sentence_ of the description is shown on the button of the `add` menu.\nThe full description is shown in the confirmation dialog.\n\n(The first sentence is until the first '.'-character in the description)\n\nquestion: How would you describe this feature?",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -233,59 +228,22 @@
]
},
"exampleImages": {
- "description": "Example images, which show real-life pictures of what such a feature might look like\n\nType: image",
+ "description": "The URL of an example image which shows a real-life example of what such a feature might look like.\n\nType: image\nquestion: What is the URL of an image showing such a feature?",
"type": "array",
"items": {
"type": "string"
}
},
- "preciseInput": {
- "description": "If set, the user will prompted to confirm the location before actually adding the data.\nThis will be with a 'drag crosshair'-method.\n\nIf 'preferredBackgroundCategory' is set, the element will attempt to pick a background layer of that category.",
- "anyOf": [
- {
- "type": "object",
- "properties": {
- "preferredBackground": {
- "description": "The type of background picture",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "snapToLayer": {
- "description": "If specified, these layers will be shown to and the new point will be snapped towards it",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "maxSnapDistance": {
- "description": "If specified, a new point will only be snapped if it is within this range.\nDistance in meter\n\nDefault: 10",
- "type": "number"
- }
- }
- },
- {
- "enum": [
- true
- ],
- "type": "boolean"
- }
- ]
+ "snapToLayer": {
+ "description": "question: Should the created point be snapped to a line layer?\n\nIf specified, these layers will be shown in the precise location picker and the new point will be snapped towards it.\nFor example, this can be used to snap against `walls_and_buildings` (e.g. to attach a defibrillator, an entrance, an artwork, ... to the wall)\nor to snap an obstacle (such as a bollard) to the `cycleways_and_roads`.\n\nsuggestions: return Array.from(layers.keys()).map(key => ({if: \"value=\"+key, then: key+\" - \"+layers.get(key).description}))",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "maxSnapDistance": {
+ "description": "question: What is the maximum distance in the location-input that a point can be moved to be snapped to a way?\n\ninline: a point is snapped if the location input is at most {value}m away from an object\n\nIf specified, a new point will only be snapped if it is within this range.\nIf further away, it'll be placed in the center of the location input\nDistance in meter\n\nifunset: Do not snap to a layer",
+ "type": "number"
}
},
"required": [
@@ -295,7 +253,7 @@
}
},
"tagRenderings": {
- "description": "All the tag renderings.\nA tag rendering is a block that either shows the known value or asks a question.\n\nRefer to the class `TagRenderingConfigJson` to see the possibilities.\n\nNote that we can also use a string here - where the string refers to a tag rendering defined in `assets/questions/questions.json`,\nwhere a few very general questions are defined e.g. website, phone number, ...\nFurthermore, _all_ the questions of another layer can be reused with `otherlayer.*`\nIf you need only a single of the tagRenderings, use `otherlayer.tagrenderingId`\nIf one or more questions have a 'group' or 'label' set, select all the entries with the corresponding group or label with `otherlayer.*group`\nRemark: if a tagRendering is 'lent' from another layer, the 'source'-tags are copied and added as condition.\nIf they are not wanted, remove them with an override\n\nA special value is 'questions', which indicates the location of the questions box. If not specified, it'll be appended to the bottom of the featureInfobox.\n\nAt last, one can define a group of renderings where parts of all strings will be replaced by multiple other strings.\nThis is mainly create questions for a 'left' and a 'right' side of the road.\nThese will be grouped and questions will be asked together",
+ "description": "question: Which tagRenderings should be shown in the infobox?\n\nA tag rendering is a block that either shows the known value or asks a question.\n\nRefer to the class `TagRenderingConfigJson` to see the possibilities.\n\nNote that we can also use a string here - where the string refers to a tag rendering defined in `assets/questions/questions.json`,\nwhere a few very general questions are defined e.g. website, phone number, ...\nFurthermore, _all_ the questions of another layer can be reused with `otherlayer.*`\nIf you need only a single of the tagRenderings, use `otherlayer.tagrenderingId`\nIf one or more questions have a 'group' or 'label' set, select all the entries with the corresponding group or label with `otherlayer.*group`\nRemark: if a tagRendering is 'lent' from another layer, the 'source'-tags are copied and added as condition.\nIf they are not wanted, remove them with an override\n\nA special value is 'questions', which indicates the location of the questions box. If not specified, it'll be appended to the bottom of the featureInfobox.\n\nAt last, one can define a group of renderings where parts of all strings will be replaced by multiple other strings.\nThis is mainly create questions for a 'left' and a 'right' side of the road.\nThese will be grouped and questions will be asked together\n\ntype: tagrendering[]\ngroup: tagrenderings",
"type": "array",
"items": {
"anyOf": [
@@ -355,7 +313,7 @@
}
},
"filter": {
- "description": "All the extra questions for filtering.\nIf a string is given, mapComplete will search in 'filters.json' for the appropriate filter or will try to parse it as `layername.filterid` and us that one",
+ "description": "All the extra questions for filtering.\nIf a string is given, mapComplete will search in 'filters.json' for the appropriate filter or will try to parse it as `layername.filterid` and us that one\n\ngroup: filters",
"anyOf": [
{
"type": "array",
@@ -384,7 +342,7 @@
]
},
"deletion": {
- "description": "This block defines under what circumstances the delete dialog is shown for objects of this layer.\nIf set, a dialog is shown to the user to (soft) delete the point.\nThe dialog is built to be user friendly and to prevent mistakes.\nIf deletion is not possible, the dialog will hide itself and show the reason of non-deletability instead.\n\nTo configure, the following values are possible:\n\n- false: never ever show the delete button\n- true: show the default delete button\n- undefined: use the mapcomplete default to show deletion or not. Currently, this is the same as 'false' but this will change in the future\n- or: a hash with options (see below)\n\n The delete dialog\n =================\n\n\n\n#### Hard deletion if enough experience\n\nA feature can only be deleted from OpenStreetMap by mapcomplete if:\n\n- It is a node\n- No ways or relations use the node\n- The logged-in user has enough experience OR the user is the only one to have edited the point previously\n- The logged-in user has no unread messages (or has a ton of experience)\n- The user did not select one of the 'non-delete-options' (see below)\n\nIn all other cases, a 'soft deletion' is used.\n\n#### Soft deletion\n\nA 'soft deletion' is when the point isn't deleted from OSM but retagged so that it'll won't how up in the mapcomplete theme anymore.\nThis makes it look like it was deleted, without doing damage. A fixme will be added to the point.\n\nNote that a soft deletion is _only_ possible if these tags are provided by the theme creator, as they'll be different for every theme\n\n#### No-delete options\n\nIn some cases, the contributor might want to delete something for the wrong reason (e.g. someone who wants to have a path removed \"because the path is on their private property\").\nHowever, the path exists in reality and should thus be on OSM - otherwise the next contributor will pass by and notice \"hey, there is a path missing here! Let me redraw it in OSM!)\n\nThe correct approach is to retag the feature in such a way that it is semantically correct *and* that it doesn't show up on the theme anymore.\nA no-delete option is offered as 'reason to delete it', but secretly retags.",
+ "description": "This block defines under what circumstances the delete dialog is shown for objects of this layer.\nIf set, a dialog is shown to the user to (soft) delete the point.\nThe dialog is built to be user friendly and to prevent mistakes.\nIf deletion is not possible, the dialog will hide itself and show the reason of non-deletability instead.\n\nTo configure, the following values are possible:\n\n- false: never ever show the delete button\n- true: show the default delete button\n- undefined: use the mapcomplete default to show deletion or not. Currently, this is the same as 'false' but this will change in the future\n- or: a hash with options (see below)\n\n### The delete dialog\n\n\n\n#### Hard deletion if enough experience\n\nA feature can only be deleted from OpenStreetMap by mapcomplete if:\n\n- It is a node\n- No ways or relations use the node\n- The logged-in user has enough experience OR the user is the only one to have edited the point previously\n- The logged-in user has no unread messages (or has a ton of experience)\n- The user did not select one of the 'non-delete-options' (see below)\n\nIn all other cases, a 'soft deletion' is used.\n\n#### Soft deletion\n\nA 'soft deletion' is when the point isn't deleted fromOSM but retagged so that it'll won't how up in the mapcomplete theme anymore.\nThis makes it look like it was deleted, without doing damage. A fixme will be added to the point.\n\nNote that a soft deletion is _only_ possible if these tags are provided by the theme creator, as they'll be different for every theme\n\n##### No-delete options\n\nIn some cases, the contributor might want to delete something for the wrong reason (e.g. someone who wants to have a path removed \"because the path is on their private property\").\nHowever, the path exists in reality and should thus be on OSM - otherwise the next contributor will pass by and notice \"hey, there is a path missing here! Let me redraw it in OSM!)\n\nThe correct approach is to retag the feature in such a way that it is semantically correct *and* that it doesn't show up on the theme anymore.\nA no-delete option is offered as 'reason to delete it', but secretly retags.\n\ngroup: editing\ntypes: Use an advanced delete configuration ; boolean\niftrue: Allow deletion\niffalse: Do not allow deletion\nifunset: Do not allow deletion",
"anyOf": [
{
"$ref": "#/definitions/DeleteConfigJson"
@@ -395,7 +353,7 @@
]
},
"allowMove": {
- "description": "Indicates if a point can be moved and configures the modalities.\n\nA feature can be moved by MapComplete if:\n\n- It is a point\n- The point is _not_ part of a way or a a relation.\n\nOff by default. Can be enabled by setting this flag or by configuring.",
+ "description": "Indicates if a point can be moved and why.\n\nA feature can be moved by MapComplete if:\n\n- It is a point\n- The point is _not_ part of a way or a a relation.\n\ntypes: use an advanced move configuration ; boolean\ngroup: editing\nquestion: Is deleting a point allowed?\niftrue: Allow contributors to move a point (for accuracy or a relocation)\niffalse: Don't allow contributors to move points\nifunset: Don't allow contributors to move points (default)",
"anyOf": [
{
"$ref": "#/definitions/default_3"
@@ -406,7 +364,7 @@
]
},
"allowSplit": {
- "description": "If set, a 'split this way' button is shown on objects rendered as LineStrings, e.g. highways.\n\nIf the way is part of a relation, MapComplete will attempt to update this relation as well",
+ "description": "If set, a 'split this way' button is shown on objects rendered as LineStrings, e.g. highways.\n\nIf the way is part of a relation, MapComplete will attempt to update this relation as well\nquestion: Should the contributor be able to split ways using this layer?\niftrue: enable the 'split-roads'-component\niffalse: don't enable the split-roads componenet\nifunset: don't enable the split-roads component\ngroup: editing",
"type": "boolean"
},
"units": {
@@ -416,7 +374,7 @@
}
},
"syncSelection": {
- "description": "If set, synchronizes whether or not this layer is enabled.\n\nno: Do not sync at all, always revert to default\nlocal: keep selection on local storage\ntheme-only: sync via OSM, but this layer will only be toggled in this theme\nglobal: all layers with this ID will be synced accross all themes",
+ "description": "If set, synchronizes whether or not this layer is enabled.\n\ngroup: advanced\nquestion: Should enabling/disabling the layer be saved (locally or in the cloud)?\nsuggestions: return [{if: \"value=no\", then: \"Don't save, always revert to the default\"}, {if: \"value=local\", then: \"Save selection in local storage\"}, {if: \"value=theme-only\", then: \"Save the state in the OSM-usersettings, but apply on this theme only (default)\"}, {if: \"value=global\", then: \"Save in OSM-usersettings and toggle on _all_ themes using this layer\"}]",
"enum": [
"global",
"local",
@@ -426,24 +384,27 @@
"type": "string"
},
"#": {
- "description": "Used for comments and/or to disable some checks\n\nno-question-hint-check: disables a check in MiscTagRenderingChecks which complains about 'div', 'span' or 'class=subtle'-HTML elements in the tagRendering",
+ "description": "Used for comments and/or to disable some checks\n\nno-question-hint-check: disables a check in MiscTagRenderingChecks which complains about 'div', 'span' or 'class=subtle'-HTML elements in the tagRendering\n\ngroup: hidden",
"type": "string"
+ },
+ "fullNodeDatabase": {
+ "description": "_Set automatically by MapComplete, please ignore_\n\ngroup: hidden",
+ "type": "boolean"
}
},
"required": [
"id",
- "mapRendering",
+ "pointRendering",
"source"
],
"definitions": {
"TagConfigJson": {
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation",
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
"type": "object",
"properties": {
"or": {
@@ -462,8 +423,7 @@
}
]
},
- "AndTagConfigJson": {
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{and:TagConfigJson[];}": {
"type": "object",
"properties": {
"and": {
@@ -478,8 +438,7 @@
],
"additionalProperties": false
},
- "OrTagConfigJson": {
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{or:TagConfigJson[];}": {
"type": "object",
"properties": {
"or": {
@@ -566,48 +525,101 @@
],
"additionalProperties": false
},
+ "MinimalTagRenderingConfigJson": {
+ "description": "Mostly used for lineRendering and pointRendering",
+ "type": "object",
+ "properties": {
+ "render": {
+ "description": "question: What value should be rendered?\n\nThis piece of text will be shown in the infobox.\nNote that \"&LBRACEkey&RBRACE\"-parts are substituted by the corresponding values of the element.\n\nThis value will be used if there is no mapping which matches (or there are no matches)\nNote that this is a HTML-interpreted value, so you can add links as e.g. '<a href='{website}'>{website}</a>' or include images such as `This is of type A <br><img src='typeA-icon.svg' />`",
+ "type": "string"
+ },
+ "mappings": {
+ "description": "Allows fixed-tag inputs, shown either as radiobuttons or as checkboxes",
+ "type": "array",
+ "items": {
+ "type": "object",
+ "properties": {
+ "if": {
+ "$ref": "#/definitions/TagConfigJson",
+ "description": "question: When should this single mapping match?\n\nIf this condition is met, then the text under `then` will be shown.\nIf no value matches, and the user selects this mapping as an option, then these tags will be uploaded to OSM.\n\nFor example: {'if': 'diet:vegetarion=yes', 'then':'A vegetarian option is offered here'}\n\nThis can be an substituting-tag as well, e.g. {'if': 'addr:street:={_calculated_nearby_streetname}', 'then': '{_calculated_nearby_streetname}'}"
+ },
+ "then": {
+ "description": "question: What text should be shown?\n\nIf the condition `if` is met, the text `then` will be rendered.\nIf not known yet, the user will be presented with `then` as an option",
+ "type": "string"
+ }
+ },
+ "required": [
+ "if",
+ "then"
+ ]
+ }
+ }
+ },
+ "additionalProperties": false
+ },
+ "IconConfigJson": {
+ "type": "object",
+ "properties": {
+ "icon": {
+ "description": "question: What icon should be used?\ntype: icon\nsuggestions: return [\"pin\",\"square\",\"circle\",\"checkmark\",\"clock\",\"close\",\"crosshair\",\"help\",\"home\",\"invalid\",\"location\",\"location_empty\",\"location_locked\",\"note\",\"resolved\",\"ring\",\"scissors\",\"teardrop\",\"teardrop_with_hole_green\",\"triangle\"].map(i => ({if: \"value=\"+i, then: i, icon: i}))",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
+ },
+ {
+ "type": "object",
+ "properties": {
+ "builtin": {
+ "type": "string"
+ },
+ "override": {}
+ },
+ "required": [
+ "builtin",
+ "override"
+ ]
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "color": {
+ "description": "question: What colour should the icon be?\nThis will only work for the default icons such as `pin`,`circle`,...\ntype: color",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
+ },
+ {
+ "type": "object",
+ "properties": {
+ "builtin": {
+ "type": "string"
+ },
+ "override": {}
+ },
+ "required": [
+ "builtin",
+ "override"
+ ]
+ },
+ {
+ "type": "string"
+ }
+ ]
+ }
+ },
+ "required": [
+ "icon"
+ ],
+ "additionalProperties": false
+ },
"TagRenderingConfigJson": {
"description": "A TagRenderingConfigJson is a single piece of code which converts one ore more tags into a HTML-snippet.\nFor an _editable_ tagRendering, use 'QuestionableTagRenderingConfigJson' instead, which extends this one",
"type": "object",
"properties": {
- "id": {
- "description": "The id of the tagrendering, should be an unique string.\nUsed to keep the translations in sync. Only used in the tagRenderings-array of a layerConfig, not requered otherwise.\n\nUse 'questions' to trigger the question box of this group (if a group is defined)",
- "type": "string"
- },
- "labels": {
- "description": "A list of labels. These are strings that are used for various purposes, e.g. to filter them away",
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "classes": {
- "description": "A list of css-classes to apply to the entire tagRendering if the answer is known (not applied on the question).\nThis is only for advanced users",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "description": {
- "description": "A human-readable text explaining what this tagRendering does",
- "anyOf": [
- {
- "$ref": "#/definitions/Record"
- },
- {
- "type": "string"
- }
- ]
- },
"render": {
- "description": "Renders this value. Note that \"{key}\"-parts are substituted by the corresponding values of the element.\nIf neither 'textFieldQuestion' nor 'mappings' are defined, this text is simply shown as default value.\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '{website}' or include images such as `This is of type A
`\ntype: rendered",
+ "description": "question: What text should be rendered?\n\nThis piece of text will be shown in the infobox.\nIn this text, values within braces (such as {braced(key)}) are replaced by the corresponding `value` in the object.\nFor example, if the object contains tags `amenity=school; name=Windy Hill School`, the render string `This school is named {name}` will be shown to the user as `This school is named Windy Hill School`\n\nThis text will be shown if:\n- there is no mapping which matches (or there are no matches)\n- no question, no mappings and no 'freeform' is set\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '<a href='{website}'>{website}</a>' or include images such as `This is of type A <br><img src='typeA-icon.svg' />`\ntype: rendered",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -643,16 +655,38 @@
}
]
},
- "condition": {
- "description": "Only show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "icon": {
+ "description": "question: what icon should be shown next to the 'render' value?\nAn icon shown next to the rendering; typically shown pretty small\nThis is only shown next to the \"render\" value\nType: icon",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "object",
+ "properties": {
+ "path": {
+ "description": "The path to the icon\nType: icon",
+ "type": "string"
+ },
+ "class": {
+ "description": "A hint to mapcomplete on how to render this icon within the mapping.\nThis is translated to 'mapping-icon-', so defining your own in combination with a custom CSS is possible (but discouraged)",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path"
+ ]
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "string"
+ }
+ ]
+ },
+ "condition": {
+ "description": "question: When should this item be shown?\n\nOnly show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
+ },
+ {
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -660,15 +694,13 @@
]
},
"metacondition": {
- "description": "If set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
+ "description": "question: When should this item be shown (including special conditions)?\n\nIf set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -676,11 +708,11 @@
]
},
"freeform": {
- "description": "Allow freeform text input from the user",
+ "description": "question: Should a freeform text field be shown?\nAllow freeform text input from the user\nifunset: Do not add a freeform text field",
"type": "object",
"properties": {
"key": {
- "description": "If this key is present, then 'render' is used to display the value.\nIf this is undefined, the rendering is _always_ shown",
+ "description": "What attribute should be filled out\nIf this key is present in the feature, then 'render' is used to display the value.\nIf this is undefined, the rendering is _always_ shown",
"type": "string"
}
},
@@ -696,10 +728,10 @@
"properties": {
"if": {
"$ref": "#/definitions/TagConfigJson",
- "description": "If this condition is met, then the text under `then` will be shown.\nIf no value matches, and the user selects this mapping as an option, then these tags will be uploaded to OSM.\n\nFor example: {'if': 'diet:vegetarion=yes', 'then':'A vegetarian option is offered here'}\n\nThis can be an substituting-tag as well, e.g. {'if': 'addr:street:={_calculated_nearby_streetname}', 'then': '{_calculated_nearby_streetname}'}"
+ "description": "question: When should this single mapping match?\n\nIf this condition is met, then the text under `then` will be shown.\nIf no value matches, and the user selects this mapping as an option, then these tags will be uploaded to OSM.\n\nFor example: {'if': 'diet:vegetarion=yes', 'then':'A vegetarian option is offered here'}\n\nThis can be an substituting-tag as well, e.g. {'if': 'addr:street:={_calculated_nearby_streetname}', 'then': '{_calculated_nearby_streetname}'}"
},
"then": {
- "description": "If the condition `if` is met, the text `then` will be rendered.\nIf not known yet, the user will be presented with `then` as an option\nType: rendered",
+ "description": "question: What text should be shown?\n\nIf the condition `if` is met, the text `then` will be rendered.\nIf not known yet, the user will be presented with `then` as an option\nType: rendered",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -710,7 +742,7 @@
]
},
"icon": {
- "description": "An icon supporting this mapping; typically shown pretty small\nType: icon",
+ "description": "question: What icon should be added to this mapping?\nAn icon supporting this mapping; typically shown pretty small\ninline:
{icon}\nType: icon",
"anyOf": [
{
"type": "object",
@@ -739,6 +771,21 @@
"then"
]
}
+ },
+ "description": {
+ "description": "A human-readable text explaining what this tagRendering does.\nMostly used for the shared tagrenderings",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "classes": {
+ "description": "question: What css-classes should be applied to showing this attribute?\n\nA list of css-classes to apply to the entire tagRendering.\nThese classes are applied in 'answer'-mode, not in question mode\nThis is only for advanced users.\n\nValues are split on ` ` (space)",
+ "type": "string"
}
},
"additionalProperties": false
@@ -752,13 +799,21 @@
"properties": {
"if": {
"$ref": "#/definitions/TagConfigJson",
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation"
+ "description": "question: What tags should be matched to show this option?\n\nIf in 'question'-mode and the contributor selects this option, these tags will be applied to the object"
},
"then": {
- "description": "Shown if the 'if is fulfilled\nType: rendered"
+ "description": "Question: What corresponding text should be shown?\nShown if the `if` is fulfilled\nType: rendered",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
},
"icon": {
- "description": "An extra icon supporting the choice\nType: icon",
+ "description": "question: What icon should be shown next to this mapping?\n\nThis icon will only be shown if the value is known, it is not displayed in the options (but might be in the future)\n\nifunset: Show no icon\nType: icon",
"anyOf": [
{
"type": "object",
@@ -782,15 +837,13 @@
]
},
"hideInAnswer": {
- "description": "In some cases, multiple taggings exist (e.g. a default assumption, or a commonly mapped abbreviation and a fully written variation).\n\nIn the latter case, a correct text should be shown, but only a single, canonical tagging should be selectable by the user.\nIn this case, one of the mappings can be hiden by setting this flag.\n\nTo demonstrate an example making a default assumption:\n\nmappings: [\n {\n if: \"access=\", -- no access tag present, we assume accessible\n then: \"Accessible to the general public\",\n hideInAnswer: true\n },\n {\n if: \"access=yes\",\n then: \"Accessible to the general public\", -- the user selected this, we add that to OSM\n },\n {\n if: \"access=no\",\n then: \"Not accessible to the public\"\n }\n]\n\n\nFor example, for an operator, we have `operator=Agentschap Natuur en Bos`, which is often abbreviated to `operator=ANB`.\nThen, we would add two mappings:\n{\n if: \"operator=Agentschap Natuur en Bos\" -- the non-abbreviated version which should be uploaded\n then: \"Maintained by Agentschap Natuur en Bos\"\n},\n{\n if: \"operator=ANB\", -- we don't want to upload abbreviations\n then: \"Maintained by Agentschap Natuur en Bos\"\n hideInAnswer: true\n}\n\nHide in answer can also be a tagsfilter, e.g. to make sure an option is only shown when appropriate.\nKeep in mind that this is reverse logic: it will be hidden in the answer if the condition is true, it will thus only show in the case of a mismatch\n\ne.g., for toilets: if \"wheelchair=no\", we know there is no wheelchair dedicated room.\nFor the location of the changing table, the option \"in the wheelchair accessible toilet is weird\", so we write:\n\n{\n \"question\": \"Where is the changing table located?\"\n \"mappings\": [\n {\"if\":\"changing_table:location=female\",\"then\":\"In the female restroom\"},\n {\"if\":\"changing_table:location=male\",\"then\":\"In the male restroom\"},\n {\"if\":\"changing_table:location=wheelchair\",\"then\":\"In the wheelchair accessible restroom\", \"hideInAnswer\": \"wheelchair=no\"},\n\n ]\n}\n\nAlso have a look for the meta-tags\n{\n if: \"operator=Agentschap Natuur en Bos\",\n then: \"Maintained by Agentschap Natuur en Bos\",\n hideInAnswer: \"_country!=be\"\n}",
+ "description": "question: Under what circumstances should this mapping be hidden from the possibilities a contributor can pick?\niftrue: Never show this mapping as option to pick\nifunset: Always show this mapping as option to pick\ntype: tag\n\nIn some cases, multiple taggings exist (e.g. a default assumption, or a commonly mapped abbreviation and a fully written variation).\n\nIn the latter case, a correct text should be shown, but only a single, canonical tagging should be selectable by the user.\nIn this case, one of the mappings can be hiden by setting this flag.\n\nTo demonstrate an example making a default assumption:\n\nmappings: [\n {\n if: \"access=\", -- no access tag present, we assume accessible\n then: \"Accessible to the general public\",\n hideInAnswer: true\n },\n {\n if: \"access=yes\",\n then: \"Accessible to the general public\", -- the user selected this, we add that to OSM\n },\n {\n if: \"access=no\",\n then: \"Not accessible to the public\"\n }\n]\n\n\nFor example, for an operator, we have `operator=Agentschap Natuur en Bos`, which is often abbreviated to `operator=ANB`.\nThen, we would add two mappings:\n{\n if: \"operator=Agentschap Natuur en Bos\" -- the non-abbreviated version which should be uploaded\n then: \"Maintained by Agentschap Natuur en Bos\"\n},\n{\n if: \"operator=ANB\", -- we don't want to upload abbreviations\n then: \"Maintained by Agentschap Natuur en Bos\"\n hideInAnswer: true\n}\n\nHide in answer can also be a tagsfilter, e.g. to make sure an option is only shown when appropriate.\nKeep in mind that this is reverse logic: it will be hidden in the answer if the condition is true, it will thus only show in the case of a mismatch\n\ne.g., for toilets: if \"wheelchair=no\", we know there is no wheelchair dedicated room.\nFor the location of the changing table, the option \"in the wheelchair accessible toilet is weird\", so we write:\n\n{\n \"question\": \"Where is the changing table located?\"\n \"mappings\": [\n {\"if\":\"changing_table:location=female\",\"then\":\"In the female restroom\"},\n {\"if\":\"changing_table:location=male\",\"then\":\"In the male restroom\"},\n {\"if\":\"changing_table:location=wheelchair\",\"then\":\"In the wheelchair accessible restroom\", \"hideInAnswer\": \"wheelchair=no\"},\n\n ]\n}\n\nAlso have a look for the meta-tags\n{\n if: \"operator=Agentschap Natuur en Bos\",\n then: \"Maintained by Agentschap Natuur en Bos\",\n hideInAnswer: \"_country!=be\"\n}",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": [
@@ -801,15 +854,13 @@
]
},
"ifnot": {
- "description": "Only applicable if 'multiAnswer' is set.\nThis is for situations such as:\n`accepts:coins=no` where one can select all the possible payment methods. However, we want to make explicit that some options _were not_ selected.\nThis can be done with `ifnot`\nNote that we can not explicitly render this negative case to the user, we cannot show `does _not_ accept coins`.\nIf this is important to your usecase, consider using multiple radiobutton-fields without `multiAnswer`",
+ "description": "question: What tags should be applied if this mapping is _not_ chosen?\n\nOnly applicable if 'multiAnswer' is set.\nThis is for situations such as:\n`accepts:coins=no` where one can select all the possible payment methods. However, we want to make explicit that some options _were not_ selected.\nThis can be done with `ifnot`\nNote that we can not explicitly render this negative case to the user, we cannot show `does _not_ accept coins`.\nIf this is important to your usecase, consider using multiple radiobutton-fields without `multiAnswer`",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -817,26 +868,24 @@
]
},
"addExtraTags": {
- "description": "If chosen as answer, these tags will be applied as well onto the object.\nNot compatible with multiAnswer.\n\nThis can be used e.g. to erase other keys which indicate the 'not' value:\n```json\n{\n \"if\": \"crossing:marking=rainbow\",\n \"then\": \"This is a rainbow crossing\",\n \"addExtraTags\": \"not:crossing:marking=\"\n}\n```",
+ "description": "question: What extra tags should be added to the object if this object is chosen?\ntype: simple_tag[]\n\nIf chosen as answer, these tags will be applied onto the object, together with the tags from the `if`\nNot compatible with multiAnswer.\n\nThis can be used e.g. to erase other keys which indicate the 'not' value:\n```json\n{\n \"if\": \"crossing:marking=rainbow\",\n \"then\": \"This is a rainbow crossing\",\n \"addExtraTags\": [\"not:crossing:marking=\"]\n}\n```",
"type": "array",
"items": {
"type": "string"
}
},
"searchTerms": {
- "description": "If there are many options, the mappings-radiobuttons will be replaced by an element with a searchfunction\n\nSearchterms (per language) allow to easily find an option if there are many options",
+ "description": "question: If there are many options, what search terms match too?\nIf there are many options, the mappings-radiobuttons will be replaced by an element with a searchfunction\n\nSearchterms (per language) allow to easily find an option if there are many options\ngroup: hidden",
"$ref": "#/definitions/Record"
},
"priorityIf": {
- "description": "If the searchable selector is picked, mappings with this item will have priority and show up even if the others are hidden\nUse this sparingly",
+ "description": "If the searchable selector is picked, mappings with this item will have priority and show up even if the others are hidden\nUse this sparingly\ngroup: hidden",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -844,7 +893,7 @@
]
},
"#": {
- "description": "Used for comments or to disable a validation\n\nignore-image-in-then: normally, a `then`-clause is not allowed to have an `img`-html-element as icons are preferred. In some cases (most notably title-icons), this is allowed",
+ "description": "Used for comments or to disable a validation\n\ngroup: hidden\nignore-image-in-then: normally, a `then`-clause is not allowed to have an `img`-html-element as icons are preferred. In some cases (most notably title-icons), this is allowed",
"type": "string"
}
},
@@ -863,22 +912,18 @@
"type": "object",
"properties": {
"location": {
- "description": "All the locations that this point should be rendered at.\nPossible values are:\n- `point`: only renders points at their location\n- `centroid`: show a symbol at the centerpoint of a (multi)Linestring and (multi)polygon. Points will _not_ be rendered with this\n- `projected_centerpoint`: Only on (multi)linestrings: calculate the centerpoint and snap it to the way\n- `start` and `end`: only on linestrings: add a point to the first/last coordinate of the LineString",
+ "description": "question: At what location should this icon be shown?\nmultianswer: true\nsuggestions: return [{if: \"value=point\",then: \"Show an icon for point (node) objects\"},{if: \"value=centroid\",then: \"Show an icon for line or polygon (way) objects at their centroid location\"}, {if: \"value=start\",then: \"Show an icon for line (way) objects at the start\"},{if: \"value=end\",then: \"Show an icon for line (way) object at the end\"},{if: \"value=projected_centerpoint\",then: \"Show an icon for line (way) object near the centroid location, but moved onto the line\"}]",
"type": "array",
"items": {
"type": "string"
}
},
- "icon": {
- "description": "The icon for an element.\nNote that this also doubles as the icon for this layer (rendered with the overpass-tags) ánd the icon in the presets.\n\nThe result of the icon is rendered as follows:\nthe resulting string is interpreted as a _list_ of items, separated by \";\". The bottommost layer is the first layer.\nAs a result, on could use a generic pin, then overlay it with a specific icon.\nTo make things even more practical, one can use all SVG's from the folder \"assets/svg\" and _substitute the color_ in it.\nE.g. to draw a red pin, use \"pin:#f00\", to have a green circle with your icon on top, use `circle:#0f0;`\n\nType: icon",
- "anyOf": [
- {
- "$ref": "#/definitions/TagRenderingConfigJson"
- },
- {
- "type": "string"
- }
- ]
+ "marker": {
+ "description": "The marker for an element.\nNote that this also defines the icon for this layer (rendered with the overpass-tags) and the icon in the presets.\n\nThe result of the icon is rendered as follows:\n- The first icon is rendered on the map\n- The second entry is overlayed on top of it\n- ...\n\nAs a result, on could use a generic icon (`pin`, `circle`, `square`) with a color, then overlay it with a specific icon.",
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/IconConfigJson"
+ }
},
"iconBadges": {
"description": "A list of extra badges to show next to the icon as small badge\nThey will be added as a 25% height icon at the bottom right of the icon, with all the badges in a flex layout.\n\nNote: strings are interpreted as icons, so layering and substituting is supported. You can use `circle:white;./my_icon.svg` to add a background circle",
@@ -888,13 +933,13 @@
"properties": {
"if": {
"$ref": "#/definitions/TagConfigJson",
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation"
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag"
},
"then": {
"description": "Badge to show\nType: icon",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "string"
@@ -909,7 +954,18 @@
}
},
"iconSize": {
- "description": "A string containing \"width,height\" or \"width,height,anchorpoint\" where anchorpoint is any of 'center', 'top', 'bottom', 'left', 'right', 'bottomleft','topright', ...\nDefault is '40,40,center'",
+ "description": "question: What size should the marker be on the map?\nA string containing \",\" in pixels\nifunset: Use the default size (40,40 px)",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TagRenderingConfigJson"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "anchor": {
+ "description": "question: What is the anchorpoint of the icon?\n\nThis matches the geographical point with a location on the icon.\n\nifunset: Use MapComplete-default (center)\nsuggestions: return [{if: \"value=center\", then: \"Place the center of the icon on the geographical location\"},{if: \"value=top\", then: \"Place the top of the icon on the geographical location\"},{if: \"value=bottom\", then: \"Place the bottom of the icon on the geographical location\"},{if: \"value=left\", then: \"Place the left of the icon on the geographical location\"},{if: \"value=right\", then: \"Place the right of the icon on the geographical location\"}]",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -920,7 +976,7 @@
]
},
"rotation": {
- "description": "The rotation of an icon, useful for e.g. directions.\nUsage: as if it were a css property for 'rotate', thus has to end with 'deg', e.g. `90deg`, `{direction}deg`, `calc(90deg - {camera:direction}deg)``",
+ "description": "question: What rotation should be applied on the icon?\nThis is mostly useful for items that face a specific direction, such as surveillance cameras\nThis is interpreted as css property for 'rotate', thus has to end with 'deg', e.g. `90deg`, `{direction}deg`, `calc(90deg - {camera:direction}deg)``\nifunset: Do not rotate",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -931,7 +987,7 @@
]
},
"label": {
- "description": "A HTML-fragment that is shown below the icon, for example:\n{name}
\n\nIf the icon is undefined, then the label is shown in the center of the feature.\nNote that, if the wayhandling hides the icon then no label is shown as well.",
+ "description": "question: What label should be shown beneath the marker?\nFor example: `<div style=\"background: white\">{name}</div>`\n\nIf the icon is undefined, then the label is shown in the center of the feature.\ntypes: Dynamic value | string\ninline: Always show label {value} beneath the marker\nifunset: Do not show a label beneath the marker",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -942,7 +998,7 @@
]
},
"css": {
- "description": "A snippet of css code which is applied onto the container of the entire marker",
+ "description": "question: What CSS should be applied to the entire marker?\nYou can set the css-properties here, e.g. `background: red; font-size: 12px; `\nThis will be applied to the _container_ containing both the marker and the label\ninline: Apply CSS-style {value} to the _entire marker_\ntypes: Dynamic value ; string\nifunset: Do not apply extra CSS element to the entire marker",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -953,7 +1009,7 @@
]
},
"cssClasses": {
- "description": "A snippet of css-classes which are applied onto the container of the entire marker. They can be space-separated",
+ "description": "question: Which CSS-classes should be applied to the entire marker?\nThis will be applied to the _container_ containing both the marker and the label\n\nThe classes should be separated by a space (` `)\nYou can use most Tailwind-css classes, see https://tailwindcss.com/ for more information\nFor example: `center bg-gray-500 mx-2 my-1 rounded-full`\ninline: Apply CSS-classes {value} to the entire container\nifunset: Do not apply extra CSS-classes to the label\ntypes: Dynamic value ; string\nifunset: Do not apply extra CSS-classes to the entire marker",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -964,7 +1020,7 @@
]
},
"labelCss": {
- "description": "Css that is applied onto the label",
+ "description": "question: What CSS should be applied to the label?\nYou can set the css-properties here, e.g. `background: red; font-size: 12px; `\ninline: Apply CSS-style {value} to the label\ntypes: Dynamic value ; string\nifunset: Do not apply extra CSS-labels to the label",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -975,7 +1031,7 @@
]
},
"labelCssClasses": {
- "description": "Css classes that are applied onto the label; can be space-separated",
+ "description": "question: Which CSS-classes should be applied to the label?\n\nThe classes should be separated by a space (` `)\nYou can use most Tailwind-css classes, see https://tailwindcss.com/ for more information\nFor example: `center bg-gray-500 mx-2 my-1 rounded-full`\ninline: Apply CSS-classes {value} to the label\ntypes: Dynamic value ; string\nifunset: Do not apply extra CSS-classes to the label",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -986,7 +1042,7 @@
]
},
"pitchAlignment": {
- "description": "If the map is pitched, the marker will stay parallel to the screen.\nSet to 'map' if you want to put it flattened on the map",
+ "description": "question: If the map is pitched, should the icon stay parallel to the screen or to the groundplane?\nsuggestions: return [{if: \"value=canvas\", then: \"The icon will stay upward and not be transformed as if it sticks to the screen\"}, {if: \"value=map\", then: \"The icon will be transformed as if it were painted onto the ground. (Automatically sets rotationAlignment)\"}]",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -1001,7 +1057,7 @@
]
},
"rotationAlignment": {
- "description": "If the map is rotated, the icon will still point to the north if no rotation was applied",
+ "description": "question: Should the icon be rotated if the map is rotated?\nifunset: Do not rotate or tilt icons. Always keep the icons straight\nsuggestions: return [{if: \"value=canvas\", then: \"Never rotate the icon\"}, {if: \"value=map\", then: \"If the map is rotated, rotate the icon as well. This gives the impression of an icon that floats perpendicular above the ground.\"}]",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -1026,10 +1082,10 @@
"type": "object",
"properties": {
"color": {
- "description": "The color for way-elements and SVG-elements.\nIf the value starts with \"--\", the style of the body element will be queried for the corresponding variable instead",
+ "description": "question: What color should lines be drawn in?\n\nFor an area, this will be the colour of the outside line.\nIf the value starts with \"--\", the style of the body element will be queried for the corresponding variable instead\n\ntypes: dynamic value ; string\ntitle: Line Colour\ninline: The line colour always is {value}\ntype: color",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "string"
@@ -1037,10 +1093,10 @@
]
},
"width": {
- "description": "The stroke-width for way-elements",
+ "description": "question: How wide should the line be?\nThe stroke-width for way-elements\n\ntypes: dynamic value ; string\ntitle: Line width\ninline: The line width is {value} pixels\ntype: pnat\nifunset: Use the default-linewidth of 7 pixels",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": [
@@ -1051,47 +1107,25 @@
]
},
"dashArray": {
- "description": "A dasharray, e.g. \"5 6\"\nThe dasharray defines 'pixels of line, pixels of gap, pixels of line, pixels of gap',\nDefault value: \"\" (empty string == full line)",
- "anyOf": [
- {
- "$ref": "#/definitions/TagRenderingConfigJson"
- },
- {
- "type": "string"
- }
- ]
+ "description": "question: Should a dasharray be used to render the lines?\nThe dasharray defines 'pixels of line, pixels of gap, pixels of line, pixels of gap, ...'. For example, `5 6` will be 5 pixels of line followed by a 6 pixel gap.\nCannot be a dynamic property due to a mapbox limitation\nifunset: Ways are rendered with a full line",
+ "type": "string"
},
"lineCap": {
- "description": "The form at the end of a line",
+ "description": "question: What form should the line-ending have?\nsuggestions: return [{if:\"value=round\",then:\"Round endings\"}, {if: \"value=square\", then: \"square endings\"}, {if: \"value=butt\", then: \"no ending (square ending at the end, without padding)\"}]\ntypes: dynamic value ; string\ntitle: Line Cap\nifunset: Use the default value (round ending)",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "string"
}
]
},
- "fill": {
- "description": "Whether or not to fill polygons",
- "anyOf": [
- {
- "$ref": "#/definitions/TagRenderingConfigJson"
- },
- {
- "enum": [
- "no",
- "yes"
- ],
- "type": "string"
- }
- ]
- },
"fillColor": {
- "description": "The color to fill a polygon with.\nIf undefined, this will be slightly more opaque version of the stroke line",
+ "description": "question: What colour should be used as fill colour for polygons?\nifunset: The polygon fill colour will be a more transparent version of the stroke colour\nsuggestions: return [{if: \"value=#00000000\", then: \"Use a transparent fill (only render the outline)\"}]\ninline: The fill colour is {value}\ntypes: dynamic value ; string\ntype: color",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "string"
@@ -1099,10 +1133,10 @@
]
},
"offset": {
- "description": "The number of pixels this line should be moved.\nUse a positive numbe to move to the right, a negative to move to the left (left/right as defined by the drawing direction of the line).\n\nIMPORTANT: MapComplete will already normalize 'key:both:property' and 'key:both' into the corresponding 'key:left' and 'key:right' tagging (same for 'sidewalk=left/right/both' which is rewritten to 'sidewalk:left' and 'sidewalk:right')\nThis simplifies programming. Refer to the CalculatedTags.md-documentation for more details",
+ "description": "question: Should the lines be moved (offsetted) with a number of pixels against the geographical lines?\nThe number of pixels this line should be moved.\nUse a positive number to move to the right in the drawing direction or a negative to move to the left (left/right as defined by the drawing direction of the line).\n\nIMPORTANT: MapComplete will already normalize 'key:both:property' and 'key:both' into the corresponding 'key:left' and 'key:right' tagging (same for 'sidewalk=left/right/both' which is rewritten to 'sidewalk:left' and 'sidewalk:right')\nThis simplifies programming. Refer to the CalculatedTags.md-documentation for more details\nifunset: don't offset lines on the map\ninline: Pixel offset by {value} pixels\ntypes: dynamic value ; number\ntype: int",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "number"
@@ -1112,100 +1146,38 @@
},
"additionalProperties": false
},
- "default": {
- "description": "Rewrites and multiplies the given renderings of type T.\n\nThis can be used for introducing many similar questions automatically,\nwhich also makes translations easier.\n\n(Note that the key does _not_ need to be wrapped in {}.\nHowever, we recommend to use them if the key is used in a translation, as missing keys will be picked up and warned for by the translation scripts)\n\nFor example:\n\n```\n{\n rewrite: {\n sourceString: [\"key\", \"a|b|c\"],\n into: [\n [\"X\", 0]\n [\"Y\", 1],\n [\"Z\", 2]\n ],\n renderings: [{\n \"key\":\"a|b|c\"\n }]\n }\n}\n```\nwill result in _three_ copies (as the values to rewrite into have three values, namely:\n\n[\n {\n # The first pair: key --> X, a|b|c --> 0\n \"X\": 0\n },\n {\n \"Y\": 1\n },\n {\n \"Z\": 2\n }\n\n]",
- "type": "object",
- "properties": {
- "rewrite": {
- "type": "object",
- "properties": {
- "sourceString": {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "into": {
- "type": "array",
- "items": {
- "type": "array",
- "items": {}
- }
- }
- },
- "required": [
- "into",
- "sourceString"
- ]
- },
- "renderings": {
- "anyOf": [
- {
- "$ref": "#/definitions/default_4"
- },
- {
- "$ref": "#/definitions/default_5"
- },
- {
- "type": "array",
- "items": {
- "$ref": "#/definitions/default_5"
- }
- },
- {
- "type": "array",
- "items": {
- "$ref": "#/definitions/default_4"
- }
- }
- ]
- }
- },
- "required": [
- "renderings",
- "rewrite"
- ],
- "additionalProperties": false
- },
"QuestionableTagRenderingConfigJson": {
"description": "A QuestionableTagRenderingConfigJson is a single piece of code which converts one ore more tags into a HTML-snippet.\nIf the desired tags are missing and a question is defined, a question will be shown instead.",
"type": "object",
"properties": {
- "question": {
- "description": "If it turns out that this tagRendering doesn't match _any_ value, then we show this question.\nIf undefined, the question is never asked and this tagrendering is read-only",
- "anyOf": [
- {
- "$ref": "#/definitions/Record"
- },
- {
- "type": "string"
- }
- ]
+ "id": {
+ "type": "string"
},
- "questionHint": {
- "description": "A hint which is shown in subtle text under the question.\nThis can give some extra information on what the answer should ook like",
- "anyOf": [
- {
- "$ref": "#/definitions/Record"
- },
- {
- "type": "string"
- }
- ]
+ "mappings": {
+ "description": "Allows fixed-tag inputs, shown either as radiobuttons or as checkboxes\n\nquestion: What are common options?",
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/MappingConfigJson"
+ }
+ },
+ "multiAnswer": {
+ "description": "If true, use checkboxes instead of radio buttons when asking the question\n\nquestion: Should a contributor be allowed to select multiple mappings?\n\niftrue: allow to select multiple mappings\niffalse: only allow to select a single mapping\nifunset: only allow to select a single mapping",
+ "type": "boolean"
},
"freeform": {
"description": "Allow freeform text input from the user",
"type": "object",
"properties": {
"key": {
+ "description": "question: What is the name of the attribute that should be written to?\nifunset: do not offer a freeform textfield as answer option",
"type": "string"
},
"type": {
- "description": "The type of the text-field, e.g. 'string', 'nat', 'float', 'date',...\nSee Docs/SpecialInputElements.md and UI/Input/ValidatedTextField.ts for supported values",
+ "description": "question: What is the input type?\nThe type of the text-field, e.g. 'string', 'nat', 'float', 'date',...\nSee Docs/SpecialInputElements.md and UI/Input/ValidatedTextField.ts for supported values\nifunset: use an unconstrained string as input (default)\nsuggestions: return validators.AllValidators.filter(type => !type.isMeta).map((type) => ({if: \"value=\"+type.name, then: \"\"+type.name+\" \"+type.explanation.split(\"\\n\")[0]}))",
"type": "string"
},
"placeholder": {
- "description": "A (translated) text that is shown (as gray text) within the textfield"
+ "description": "question: What placeholder text should be shown in the input-element if there is no input?\nA (translated) text that is shown (as gray text) within the textfield\ntype: translation"
},
"helperArgs": {
"description": "Extra parameters to initialize the input helper arguments.\nFor semantics, see the 'SpecialInputElements.md'",
@@ -1220,56 +1192,34 @@
}
},
"inline": {
- "description": "When set, influences the way a question is asked.\nInstead of showing a full-width text field, the text field will be shown within the rendering of the question.\n\nThis combines badly with special input elements, as it'll distort the layout.\nNote that this will be set automatically if no special elements are present.",
+ "description": "question: Show the freeform as box within the question?\nInstead of showing a full-width text field, the text field will be shown within the rendering of the question.\n\nThis combines badly with special input elements, as it'll distort the layout.\nifunset: show the freeform input field full-width\niftrue: show the freeform input field as a small field within the question",
"type": "boolean"
},
"default": {
- "description": "default value to enter if no previous tagging is present.\nNormally undefined (aka do not enter anything)",
+ "description": "question: What value should be entered in the text field if no value is set?\nThis can help people to quickly enter the most common option\nifunset: do not prefill the textfield",
"type": "string"
+ },
+ "invalidValues": {
+ "description": "question: What values of the freeform key should be interpreted as 'unknown'?\nFor example, if a feature has `shop=yes`, the question 'what type of shop is this?' should still asked\nifunset: The question will be considered answered if any value is set for the key",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
+ },
+ {
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
+ },
+ {
+ "type": "string"
+ }
+ ]
}
},
"required": [
"key"
]
},
- "multiAnswer": {
- "description": "If true, use checkboxes instead of radio buttons when asking the question",
- "type": "boolean"
- },
- "mappings": {
- "description": "Allows fixed-tag inputs, shown either as radiobuttons or as checkboxes",
- "type": "array",
- "items": {
- "$ref": "#/definitions/MappingConfigJson"
- }
- },
- "id": {
- "description": "The id of the tagrendering, should be an unique string.\nUsed to keep the translations in sync. Only used in the tagRenderings-array of a layerConfig, not requered otherwise.\n\nUse 'questions' to trigger the question box of this group (if a group is defined)",
- "type": "string"
- },
- "labels": {
- "description": "A list of labels. These are strings that are used for various purposes, e.g. to filter them away",
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "classes": {
- "description": "A list of css-classes to apply to the entire tagRendering if the answer is known (not applied on the question).\nThis is only for advanced users",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "description": {
- "description": "A human-readable text explaining what this tagRendering does",
+ "question": {
+ "description": "question: What question should be shown to the contributor?\n\nA question is presented ot the user if no mapping matches and the 'freeform' key is not set as well.\n\nifunset: This tagrendering will be shown if it is known, but cannot be edited by the contributor, effectively resutling in a read-only rendering",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -1279,8 +1229,26 @@
}
]
},
+ "questionHint": {
+ "description": "question: Should some extra information be shown to the contributor, alongside the question?\nThis hint is shown in subtle text under the question.\nThis can give some extra information on what the answer should ook like\nifunset: No extra hint is given",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "labels": {
+ "description": "A list of labels. These are strings that are used for various purposes, e.g. to only include a subset of the tagRenderings when reusing a layer",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
"render": {
- "description": "Renders this value. Note that \"{key}\"-parts are substituted by the corresponding values of the element.\nIf neither 'textFieldQuestion' nor 'mappings' are defined, this text is simply shown as default value.\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '{website}' or include images such as `This is of type A
`\ntype: rendered",
+ "description": "question: What text should be rendered?\n\nThis piece of text will be shown in the infobox.\nIn this text, values within braces (such as {braced(key)}) are replaced by the corresponding `value` in the object.\nFor example, if the object contains tags `amenity=school; name=Windy Hill School`, the render string `This school is named {name}` will be shown to the user as `This school is named Windy Hill School`\n\nThis text will be shown if:\n- there is no mapping which matches (or there are no matches)\n- no question, no mappings and no 'freeform' is set\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '<a href='{website}'>{website}</a>' or include images such as `This is of type A <br><img src='typeA-icon.svg' />`\ntype: rendered",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -1316,16 +1284,38 @@
}
]
},
- "condition": {
- "description": "Only show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "icon": {
+ "description": "question: what icon should be shown next to the 'render' value?\nAn icon shown next to the rendering; typically shown pretty small\nThis is only shown next to the \"render\" value\nType: icon",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "object",
+ "properties": {
+ "path": {
+ "description": "The path to the icon\nType: icon",
+ "type": "string"
+ },
+ "class": {
+ "description": "A hint to mapcomplete on how to render this icon within the mapping.\nThis is translated to 'mapping-icon-', so defining your own in combination with a custom CSS is possible (but discouraged)",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path"
+ ]
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "string"
+ }
+ ]
+ },
+ "condition": {
+ "description": "question: When should this item be shown?\n\nOnly show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
+ },
+ {
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -1333,62 +1323,71 @@
]
},
"metacondition": {
- "description": "If set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
+ "description": "question: When should this item be shown (including special conditions)?\n\nIf set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
}
]
+ },
+ "description": {
+ "description": "A human-readable text explaining what this tagRendering does.\nMostly used for the shared tagrenderings",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "classes": {
+ "description": "question: What css-classes should be applied to showing this attribute?\n\nA list of css-classes to apply to the entire tagRendering.\nThese classes are applied in 'answer'-mode, not in question mode\nThis is only for advanced users.\n\nValues are split on ` ` (space)",
+ "type": "string"
}
},
+ "required": [
+ "id"
+ ],
"additionalProperties": false
},
"Partial": {
"type": "object",
"properties": {
- "question": {
- "description": "If it turns out that this tagRendering doesn't match _any_ value, then we show this question.\nIf undefined, the question is never asked and this tagrendering is read-only",
- "anyOf": [
- {
- "$ref": "#/definitions/Record"
- },
- {
- "type": "string"
- }
- ]
+ "id": {
+ "type": "string"
},
- "questionHint": {
- "description": "A hint which is shown in subtle text under the question.\nThis can give some extra information on what the answer should ook like",
- "anyOf": [
- {
- "$ref": "#/definitions/Record"
- },
- {
- "type": "string"
- }
- ]
+ "mappings": {
+ "description": "Allows fixed-tag inputs, shown either as radiobuttons or as checkboxes\n\nquestion: What are common options?",
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/MappingConfigJson"
+ }
+ },
+ "multiAnswer": {
+ "description": "If true, use checkboxes instead of radio buttons when asking the question\n\nquestion: Should a contributor be allowed to select multiple mappings?\n\niftrue: allow to select multiple mappings\niffalse: only allow to select a single mapping\nifunset: only allow to select a single mapping",
+ "type": "boolean"
},
"freeform": {
"description": "Allow freeform text input from the user",
"type": "object",
"properties": {
"key": {
+ "description": "question: What is the name of the attribute that should be written to?\nifunset: do not offer a freeform textfield as answer option",
"type": "string"
},
"type": {
- "description": "The type of the text-field, e.g. 'string', 'nat', 'float', 'date',...\nSee Docs/SpecialInputElements.md and UI/Input/ValidatedTextField.ts for supported values",
+ "description": "question: What is the input type?\nThe type of the text-field, e.g. 'string', 'nat', 'float', 'date',...\nSee Docs/SpecialInputElements.md and UI/Input/ValidatedTextField.ts for supported values\nifunset: use an unconstrained string as input (default)\nsuggestions: return validators.AllValidators.filter(type => !type.isMeta).map((type) => ({if: \"value=\"+type.name, then: \"\"+type.name+\" \"+type.explanation.split(\"\\n\")[0]}))",
"type": "string"
},
"placeholder": {
- "description": "A (translated) text that is shown (as gray text) within the textfield"
+ "description": "question: What placeholder text should be shown in the input-element if there is no input?\nA (translated) text that is shown (as gray text) within the textfield\ntype: translation"
},
"helperArgs": {
"description": "Extra parameters to initialize the input helper arguments.\nFor semantics, see the 'SpecialInputElements.md'",
@@ -1403,56 +1402,34 @@
}
},
"inline": {
- "description": "When set, influences the way a question is asked.\nInstead of showing a full-width text field, the text field will be shown within the rendering of the question.\n\nThis combines badly with special input elements, as it'll distort the layout.\nNote that this will be set automatically if no special elements are present.",
+ "description": "question: Show the freeform as box within the question?\nInstead of showing a full-width text field, the text field will be shown within the rendering of the question.\n\nThis combines badly with special input elements, as it'll distort the layout.\nifunset: show the freeform input field full-width\niftrue: show the freeform input field as a small field within the question",
"type": "boolean"
},
"default": {
- "description": "default value to enter if no previous tagging is present.\nNormally undefined (aka do not enter anything)",
+ "description": "question: What value should be entered in the text field if no value is set?\nThis can help people to quickly enter the most common option\nifunset: do not prefill the textfield",
"type": "string"
+ },
+ "invalidValues": {
+ "description": "question: What values of the freeform key should be interpreted as 'unknown'?\nFor example, if a feature has `shop=yes`, the question 'what type of shop is this?' should still asked\nifunset: The question will be considered answered if any value is set for the key",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
+ },
+ {
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
+ },
+ {
+ "type": "string"
+ }
+ ]
}
},
"required": [
"key"
]
},
- "multiAnswer": {
- "description": "If true, use checkboxes instead of radio buttons when asking the question",
- "type": "boolean"
- },
- "mappings": {
- "description": "Allows fixed-tag inputs, shown either as radiobuttons or as checkboxes",
- "type": "array",
- "items": {
- "$ref": "#/definitions/MappingConfigJson"
- }
- },
- "id": {
- "description": "The id of the tagrendering, should be an unique string.\nUsed to keep the translations in sync. Only used in the tagRenderings-array of a layerConfig, not requered otherwise.\n\nUse 'questions' to trigger the question box of this group (if a group is defined)",
- "type": "string"
- },
- "labels": {
- "description": "A list of labels. These are strings that are used for various purposes, e.g. to filter them away",
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "classes": {
- "description": "A list of css-classes to apply to the entire tagRendering if the answer is known (not applied on the question).\nThis is only for advanced users",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "description": {
- "description": "A human-readable text explaining what this tagRendering does",
+ "question": {
+ "description": "question: What question should be shown to the contributor?\n\nA question is presented ot the user if no mapping matches and the 'freeform' key is not set as well.\n\nifunset: This tagrendering will be shown if it is known, but cannot be edited by the contributor, effectively resutling in a read-only rendering",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -1462,8 +1439,26 @@
}
]
},
+ "questionHint": {
+ "description": "question: Should some extra information be shown to the contributor, alongside the question?\nThis hint is shown in subtle text under the question.\nThis can give some extra information on what the answer should ook like\nifunset: No extra hint is given",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "labels": {
+ "description": "A list of labels. These are strings that are used for various purposes, e.g. to only include a subset of the tagRenderings when reusing a layer",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
"render": {
- "description": "Renders this value. Note that \"{key}\"-parts are substituted by the corresponding values of the element.\nIf neither 'textFieldQuestion' nor 'mappings' are defined, this text is simply shown as default value.\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '{website}' or include images such as `This is of type A
`\ntype: rendered",
+ "description": "question: What text should be rendered?\n\nThis piece of text will be shown in the infobox.\nIn this text, values within braces (such as {braced(key)}) are replaced by the corresponding `value` in the object.\nFor example, if the object contains tags `amenity=school; name=Windy Hill School`, the render string `This school is named {name}` will be shown to the user as `This school is named Windy Hill School`\n\nThis text will be shown if:\n- there is no mapping which matches (or there are no matches)\n- no question, no mappings and no 'freeform' is set\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '<a href='{website}'>{website}</a>' or include images such as `This is of type A <br><img src='typeA-icon.svg' />`\ntype: rendered",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -1499,16 +1494,38 @@
}
]
},
- "condition": {
- "description": "Only show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "icon": {
+ "description": "question: what icon should be shown next to the 'render' value?\nAn icon shown next to the rendering; typically shown pretty small\nThis is only shown next to the \"render\" value\nType: icon",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "object",
+ "properties": {
+ "path": {
+ "description": "The path to the icon\nType: icon",
+ "type": "string"
+ },
+ "class": {
+ "description": "A hint to mapcomplete on how to render this icon within the mapping.\nThis is translated to 'mapping-icon-', so defining your own in combination with a custom CSS is possible (but discouraged)",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path"
+ ]
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "string"
+ }
+ ]
+ },
+ "condition": {
+ "description": "question: When should this item be shown?\n\nOnly show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
+ },
+ {
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -1516,20 +1533,33 @@
]
},
"metacondition": {
- "description": "If set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
+ "description": "question: When should this item be shown (including special conditions)?\n\nIf set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
}
]
+ },
+ "description": {
+ "description": "A human-readable text explaining what this tagRendering does.\nMostly used for the shared tagrenderings",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "classes": {
+ "description": "question: What css-classes should be applied to showing this attribute?\n\nA list of css-classes to apply to the entire tagRendering.\nThese classes are applied in 'answer'-mode, not in question mode\nThis is only for advanced users.\n\nValues are split on ` ` (space)",
+ "type": "string"
}
},
"additionalProperties": false
@@ -1610,15 +1640,13 @@
"properties": {
"question": {},
"osmTags": {
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation",
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -1666,6 +1694,10 @@
"DeleteConfigJson": {
"type": "object",
"properties": {
+ "neededChangesets": {
+ "description": "*\nBy default, the contributor needs 20 previous changesets to delete points edited by others.\nFor some small features (e.g. bicycle racks) this is too much and this requirement can be lowered or dropped, which can be done here.\n\ntype: nat\nquestion: How many changesets must a contributor have before being allowed to delete a point?",
+ "type": "number"
+ },
"extraDeleteReasons": {
"description": "*\nBy default, three reasons to delete a point are shown:\n\n- The point does not exist anymore\n- The point was a testing point\n- THe point could not be found\n\nHowever, for some layers, there might be different or more specific reasons for deletion which can be user friendly to set, e.g.:\n\n- the shop has closed\n- the climbing route has been closed of for nature conservation reasons\n- ...\n\nThese reasons can be stated here and will be shown in the list of options the user can choose from",
"type": "array",
@@ -1673,10 +1705,10 @@
"type": "object",
"properties": {
"explanation": {
- "description": "The text that will be shown to the user - translatable"
+ "description": "The text that will be shown to the user as option for why this point does not exist anymore.\nNote that the most common reasons (test point, does not exist anymore, cannot be found) are already offered by default\n\nquestion: For what extra reason might this feature be removed in real-life?"
},
"changesetMessage": {
- "description": "The text that will be uploaded into the changeset or will be used in the fixme in case of a soft deletion\nShould be a few words, in english",
+ "description": "The text that will be uploaded into the changeset or will be used in the fixme in case of a soft deletion\nShould be a few words, in english\n\nquestion: What should be added to the changeset as delete reason?",
"type": "string"
}
},
@@ -1694,10 +1726,10 @@
"properties": {
"if": {
"$ref": "#/definitions/TagConfigJson",
- "description": "The tags that will be given to the object.\nThis must remove tags so that the 'source/osmTags' won't match anymore"
+ "description": "The tags that will be given to the object.\nThis must remove tags so that the 'source/osmTags' won't match anymore\n\nquestion: What tags should be applied to the object?"
},
"then": {
- "description": "The human explanation for the options"
+ "description": "The human explanation for the options\n\nquestion: What text should be shown to the contributor for this reason?"
}
},
"required": [
@@ -1707,27 +1739,21 @@
}
},
"softDeletionTags": {
- "description": "In some cases, the contributor is not allowed to delete the current feature (e.g. because it isn't a point, the point is referenced by a relation or the user isn't experienced enough).\nTo still offer the user a 'delete'-option, the feature is retagged with these tags. This is a soft deletion, as the point isn't actually removed from OSM but rather marked as 'disused'\nIt is important that the feature will be retagged in such a way that it won't be picked up by the layer anymore!\n\nExample (note that \"amenity=\" erases the 'amenity'-key alltogether):\n```\n{\n \"and\": [\"disussed:amenity=public_bookcase\", \"amenity=\"]\n}\n```\n\nor (notice the use of the ':='-tag to copy the old value of 'shop=*' into 'disused:shop='):\n```\n{\n \"and\": [\"disused:shop:={shop}\", \"shop=\"]\n}\n```",
+ "description": "In some cases, the contributor is not allowed to delete the current feature (e.g. because it isn't a point, the point is referenced by a relation or the user isn't experienced enough).\nTo still offer the user a 'delete'-option, the feature is retagged with these tags. This is a soft deletion, as the point isn't actually removed from OSM but rather marked as 'disused'\nIt is important that the feature will be retagged in such a way that it won't be picked up by the layer anymore!\n\nExample (note that \"amenity=\" erases the 'amenity'-key alltogether):\n\n```\n{\n \"and\": [\"disussed:amenity=public_bookcase\", \"amenity=\"]\n}\n```\n\nor (notice the use of the ':='-tag to copy the old value of 'shop=*' into 'disused:shop='):\n\n```\n{\n \"and\": [\"disused:shop:={shop}\", \"shop=\"]\n}\n```\n\nquestion: If a hard delete is not possible, what tags should be applied to mark this feature as deleted?\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
}
]
},
- "neededChangesets": {
- "description": "*\nBy default, the contributor needs 20 previous changesets to delete points edited by others.\nFor some small features (e.g. bicycle racks) this is too much and this requirement can be lowered or dropped, which can be done here.",
- "type": "number"
- },
"omitDefaultDeleteReasons": {
- "description": "Set this flag if the default delete reasons should be omitted from the dialog.\nThis requires at least one extraDeleteReason or nonDeleteMapping",
+ "description": "Set this flag if the default delete reasons should be omitted from the dialog.\nThis requires at least one extraDeleteReason or nonDeleteMapping\n\nquestion: Should the default delete reasons be hidden?\niftrue: Hide the default delete reasons\niffalse: Show the default delete reasons\nifunset: Show the default delete reasons (default behaviour)",
"type": "boolean"
}
},
@@ -1737,11 +1763,11 @@
"type": "object",
"properties": {
"enableImproveAccuracy": {
- "description": "One default reason to move a point is to improve accuracy.\nSet to false to disable this reason",
+ "description": "question: Should moving this type of point to improve the accuracy be allowed?\niftrue: This point can be moved to improve the accuracy\nifunset: (default) This point can be moved to improve the accuracy\niffalse: This point cannot be moved to improve the accuracy",
"type": "boolean"
},
"enableRelocation": {
- "description": "One default reason to move a point is because it has relocated\nSet to false to disable this reason",
+ "description": "question: Should moving this type of point due to a relocation be allowed?\n\nThis will erase the attributes `addr:street`, `addr:housenumber`, `addr:city` and `addr:postcode`\n\niftrue: This type of point can be moved due to a relocation (and will remove address information when this is done)\nifunset: (default) This type of point can be moved due to a relocation (and will remove address information when this is done)\niffalse: This type of point cannot be moved due to a relocation",
"type": "boolean"
}
},
@@ -1752,7 +1778,7 @@
"type": "object",
"properties": {
"appliesToKey": {
- "description": "Every key from this list will be normalized.\n\nTo render a united value properly, use",
+ "description": "Every key from this list will be normalized.\n\nTo render the value properly (with a human readable denomination), use `{canonical()}`",
"type": "array",
"items": {
"type": "string"
diff --git a/Docs/Schemas/LayerConfigJsonJSC.ts b/Docs/Schemas/LayerConfigJsonJSC.ts
index 4eaf333efc..86a32ab8c5 100644
--- a/Docs/Schemas/LayerConfigJsonJSC.ts
+++ b/Docs/Schemas/LayerConfigJsonJSC.ts
@@ -3,11 +3,11 @@ export default {
"type": "object",
"properties": {
"id": {
- "description": "The id of this layer.\nThis should be a simple, lowercase, human readable string that is used to identify the layer.",
+ "description": "question: What is the identifier of this layer?\n\nThis should be a simple, lowercase, human readable string that is used to identify the layer.\n A good ID is:\n - a noun\n - written in singular\n - describes the object\n - in english\n - only has lowercase letters, numbers or underscores. Do not use a space or a dash\n\ntype: id\ngroup: Basic",
"type": "string"
},
"name": {
- "description": "The name of this layer\nUsed in the layer control panel and the 'Personal theme'.\n\nIf not given, will be hidden (and thus not toggable) in the layer control",
+ "description": "Used in the layer control panel to toggle a layer on and of.\n\nifunset: This will hide the layer in the layer control, making it not filterable and not toggleable\n\ngroup: Basic\nquestion: What is the name of this layer?",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -18,7 +18,7 @@ export default {
]
},
"description": {
- "description": "A description for this layer.\nShown in the layer selections and in the personel theme",
+ "description": "A description for the features shown in this layer.\nThis often resembles the introduction of the wiki.osm.org-page for this feature.\n\ngroup: Basic\nquestion: How would you describe the features that are shown on this layer?",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -29,17 +29,17 @@ export default {
]
},
"source": {
- "description": "This determines where the data for the layer is fetched: from OSM or from an external geojson dataset.\n\nIf no 'geojson' is defined, data will be fetched from overpass and the OSM-API.\n\nEvery source _must_ define which tags _must_ be present in order to be picked up.\n\nNote: a source must always be defined. 'special' is only allowed if this is a builtin-layer",
+ "description": "Question: Where should the data be fetched from?\ntitle: Data Source\n\nThis determines where the data for the layer is fetched: from OSM or from an external geojson dataset.\n\nIf no 'geojson' is defined, data will be fetched from overpass and the OSM-API.\n\nEvery source _must_ define which tags _must_ be present in order to be picked up.\n\nNote: a source must always be defined. 'special' is only allowed if this is a builtin-layer\n\ntypes: Load data with specific tags from OpenStreetMap ; Load data from an external geojson source ;\ntypesdefault: 0\ngroup: Basic",
"anyOf": [
{
"type": "object",
"properties": {
"osmTags": {
"$ref": "#/definitions/TagConfigJson",
- "description": "Every source must set which tags have to be present in order to load the given layer."
+ "description": "question: Which tags must be present on the feature to show it in this layer?\nEvery source must set which tags have to be present in order to load the given layer."
},
"maxCacheAge": {
- "description": "The maximum amount of seconds that a tile is allowed to linger in the cache",
+ "description": "question: How long (in seconds) is the data allowed to remain cached until it must be refreshed?\nThe maximum amount of seconds that a tile is allowed to linger in the cache\n\ntype: nat\ndefault: 30 days",
"type": "number"
}
},
@@ -51,23 +51,23 @@ export default {
"type": "object",
"properties": {
"geoJson": {
- "description": "The actual source of the data to load, if loaded via geojson.\n\n# A single geojson-file\nsource: {geoJson: \"https://my.source.net/some-geo-data.geojson\"}\n fetches a geojson from a third party source\n\n# A tiled geojson source\nsource: {geoJson: \"https://my.source.net/some-tile-geojson-{layer}-{z}-{x}-{y}.geojson\", geoJsonZoomLevel: 14}\n to use a tiled geojson source. The web server must offer multiple geojsons. {z}, {x} and {y} are substituted by the location; {layer} is substituted with the id of the loaded layer\n\nSome API's use a BBOX instead of a tile, this can be used by specifying {y_min}, {y_max}, {x_min} and {x_max}",
+ "description": "The actual source of the data to load, if loaded via geojson.\n\n# A single geojson-file\nsource: {geoJson: \"https://my.source.net/some-geo-data.geojson\"}\n fetches a geojson from a third party source\n\n# A tiled geojson source\nsource: {geoJson: \"https://my.source.net/some-tile-geojson-{layer}-{z}-{x}-{y}.geojson\", geoJsonZoomLevel: 14}\n to use a tiled geojson source. The web server must offer multiple geojsons. {z}, {x} and {y} are substituted by the location; {layer} is substituted with the id of the loaded layer\n\nSome API's use a BBOX instead of a tile, this can be used by specifying {y_min}, {y_max}, {x_min} and {x_max}\n\nquestion: What is the URL of the geojson?\ntype: url",
"type": "string"
},
"geoJsonZoomLevel": {
- "description": "To load a tiled geojson layer, set the zoomlevel of the tiles",
+ "description": "To load a tiled geojson layer, set the zoomlevel of the tiles\n\nquestion: If using a tiled geojson, what is the zoomlevel of the tiles?\nifunset: This is not a tiled geojson",
"type": "number"
},
"isOsmCache": {
- "description": "Indicates that the upstream geojson data is OSM-derived.\nUseful for e.g. merging or for scripts generating this cache",
+ "description": "Indicates that the upstream geojson data is OSM-derived.\nUseful for e.g. merging or for scripts generating this cache.\nThis also indicates that making changes on this data is possible\n\nquestion: Is this geojson a cache of OpenStreetMap data?\nifunset: This is not an OpenStreetMap cache\niftrue: this is based on OpenStreetMap and can thus be edited",
"type": "boolean"
},
"mercatorCrs": {
- "description": "Some API's use a mercator-projection (EPSG:900913) instead of WGS84. Set the flag `mercatorCrs: true` in the source for this",
+ "description": "Some API's use a mercator-projection (EPSG:900913) instead of WGS84. Set the flag `mercatorCrs: true` in the source for this\n\nquestion: Does this geojson use EPSG:900913 instead of WGS84 as projection?\niftrue: This geojson uses EPSG:900913 instead of WGS84\nifunset: This geojson uses WGS84 just like most geojson (default)",
"type": "boolean"
},
"idKey": {
- "description": "Some API's have an id-field, but give it a different name.\nSetting this key will rename this field into 'id'",
+ "description": "Some API's have an id-field, but give it a different name.\nSetting this key will rename this field into 'id'\n\nifunset: An id with key `id` will be assigned automatically if no attribute `id` is set\ninline: This geojson uses {value} as attribute to set the id\nquestion: What is the name of the attribute containing the ID of the object?",
"type": "string"
}
},
@@ -85,51 +85,44 @@ export default {
]
},
"calculatedTags": {
- "description": "A list of extra tags to calculate, specified as \"keyToAssignTo=javascript-expression\".\nThere are a few extra functions available. Refer to Docs/CalculatedTags.md for more information\nThe functions will be run in order, e.g.\n[\n \"_max_overlap_m2=Math.max(...feat.overlapsWith(\"someOtherLayer\").map(o => o.overlap))\n \"_max_overlap_ratio=Number(feat._max_overlap_m2)/feat.area\n]\n\nThe specified tags are evaluated lazily. E.g. if a calculated tag is only used in the popup (e.g. the number of nearby features),\nthe expensive calculation will only be performed then for that feature. This avoids clogging up the contributors PC when all features are loaded.\n\nIf a tag has to be evaluated strictly, use ':=' instead:\n\n[\n\"_some_key:=some_javascript_expression\"\n]",
+ "description": "A list of extra tags to calculate, specified as \"keyToAssignTo=javascript-expression\".\nThere are a few extra functions available. Refer to Docs/CalculatedTags.md for more information\nThe functions will be run in order, e.g.\n[\nNot found... * \"_max_overlap_m2=Math.max(...feat.overlapsWith(\"someOtherLayer\").map(o => o.overlap))\n \"_max_overlap_ratio=Number(feat._max_overlap_m2)/feat.area\n]\n\nThe specified tags are evaluated lazily. E.g. if a calculated tag is only used in the popup (e.g. the number of nearby features),\nthe expensive calculation will only be performed then for that feature. This avoids clogging up the contributors PC when all features are loaded.\n\nIf a tag has to be evaluated strictly, use ':=' instead:\n\n[\n\"_some_key:=some_javascript_expression\"\n]\n\nSee the full documentation on [https://github.com/pietervdvn/MapComplete/blob/master/Docs/CalculatedTags.md]\n\ngroup: expert\nquestion: What extra attributes should be calculated with javascript?",
"type": "array",
"items": {
"type": "string"
}
},
- "doNotDownload": {
- "description": "If set, this layer will not query overpass; but it'll still match the tags above which are by chance returned by other layers.\nWorks well together with 'passAllFeatures', to add decoration",
- "type": "boolean"
- },
"isShown": {
- "description": "If set, only features matching this extra tag will be shown.\nThis is useful to hide certain features from view.\n\nImportant: hiding features does not work dynamically, but is only calculated when the data is first renders.\nThis implies that it is not possible to hide a feature after a tagging change\n\nThe default value is 'yes'",
+ "description": "If set, only features matching this extra tag will be shown.\nThis is useful to hide certain features from view based on a calculated tag or if the features are provided by a different layer.\n\nquestion: What other tags should features match for being shown?\ngroup: advanced\nifunset: all features which match the 'source'-specification are shown.",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
}
]
},
- "forceLoad": {
- "description": "Advanced option - might be set by the theme compiler\n\nIf true, this data will _always_ be loaded, even if the theme is disabled",
- "type": "boolean"
- },
"minzoom": {
- "description": "The minimum needed zoomlevel required before loading of the data start\nDefault: 0",
+ "description": "The minimum needed zoomlevel required to start loading and displaying the data.\nThis can be used to only show common features (e.g. a bicycle parking) only when the map is zoomed in very much (17).\nThis prevents cluttering the map with thousands of parkings if one is looking to an entire city.\n\nDefault: 0\ngroup: Basic\ntype: nat\nquestion: At what zoom level should features of the layer be shown?\nifunset: Always load this layer, even if the entire world is in view.",
"type": "number"
},
"shownByDefault": {
- "description": "Indicates if this layer is shown by default;\ncan be used to hide a layer from start, or to load the layer but only to show it where appropriate (e.g. for snapping to it)",
+ "description": "Indicates if this layer is shown by default;\ncan be used to hide a layer from start, or to load the layer but only to show it when appropriate (e.g. for advanced users)\n\nquestion: Should this layer be enabled when opening the map for the first time?\niftrue: the layer is enabled when opening the map\niffalse: the layer is hidden until the contributor enables it. (If the filter-popup is disabled, this might never get enabled nor loaded)\ndefault: true\ngroup: advanced",
"type": "boolean"
},
"minzoomVisible": {
- "description": "The zoom level at which point the data is hidden again\nDefault: 100 (thus: always visible",
+ "description": "The zoom level at which point the data is hidden again\nDefault: 100 (thus: always visible\n\ngroup: expert",
"type": "number"
},
"title": {
- "description": "The title shown in a popup for elements of this layer.",
+ "description": "question: What title should be shown on the infobox?\nThe title shown in a popup for elements of this layer.\n\ngroup: title\ntypes: use a fixed translation ; Use a dynamic tagRendering ; hidden\ntypesdefault: 1\ntype: translation\ninline: {translated{value}}",
"anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
{
"$ref": "#/definitions/TagRenderingConfigJson"
},
@@ -138,8 +131,12 @@ export default {
}
]
},
+ "popupInFloatover": {
+ "description": "Question: Should the information for this layer be shown in the sidebar or in a splash screen?\n\nIf set, open the selectedElementView in a floatOver instead of on the right.\n\niftrue: show the infobox in the splashscreen floating over the entire UI\niffalse: show the infobox in a sidebar on the right\ngroup: advanced\ndefault: sidebar",
+ "type": "boolean"
+ },
"titleIcons": {
- "description": "Small icons shown next to the title.\nIf not specified, the OsmLink and wikipedia links will be used by default.\nUse an empty array to hide them.\nNote that \"defaults\" will insert all the default titleIcons (which are added automatically)\n\nType: icon[]",
+ "description": "Small icons shown next to the title.\nIf not specified, the OsmLink and wikipedia links will be used by default.\nUse an empty array to hide them.\nNote that \"defaults\" will insert all the default titleIcons (which are added automatically)\n\nType: icon[]\ngroup: infobox",
"anyOf": [
{
"type": "array",
@@ -169,42 +166,40 @@ export default {
}
]
},
- "mapRendering": {
- "description": "Visualisation of the items on the map",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "anyOf": [
- {
- "$ref": "#/definitions/default_4"
- },
- {
- "$ref": "#/definitions/default_5"
- },
- {
- "$ref": "#/definitions/default"
- }
- ]
- }
- },
- {
- "type": "null"
- }
- ]
+ "pointRendering": {
+ "description": "Creates points to render on the map.\nThis can render points for point-objects, lineobjects or areaobjects; use 'location' to indicate where it should be rendered\ngroup: pointrendering",
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/default_4"
+ }
+ },
+ "lineRendering": {
+ "description": "Creates lines and areas to render on the map\ngroup: linerendering",
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/default_5"
+ }
},
"passAllFeatures": {
- "description": "If set, this layer will pass all the features it receives onto the next layer.\nThis is ideal for decoration, e.g. directionss on cameras",
+ "description": "If set, this layer will pass all the features it receives onto the next layer.\nThis is ideal for decoration, e.g. directions on cameras\niftrue: Make the features from this layer also available to the other layer; might result in this object being rendered by multiple layers\niffalse: normal behaviour: don't pass features allong\nquestion: should this layer pass features to the next layers?\ngroup: expert",
+ "type": "boolean"
+ },
+ "doNotDownload": {
+ "description": "If set, this layer will not query overpass; but it'll still match the tags above which are by chance returned by other layers.\nWorks well together with 'passAllFeatures', to add decoration\nThe opposite of `forceLoad`\n\niftrue: Do not attempt to query the data for this layer from overpass/the OSM API\niffalse: download the data as usual\ngroup: expert\nquestion: Should this layer be downloaded or is the data provided by a different layer (which has 'passAllFeatures'-set)?\ndefault: false",
+ "type": "boolean"
+ },
+ "forceLoad": {
+ "description": "Advanced option - might be set by the theme compiler\n\nIf true, this data will _always_ be loaded, even if the theme is disabled by a filter or hidden.\nThe opposite of `doNotDownload`\n\nquestion: Should this layer be forcibly loaded?\nifftrue: always download this layer, even if it is disabled\niffalse: only download data for this layer when needed (default)\ndefault: false\ngroup: expert",
"type": "boolean"
},
"presets": {
- "description": "Presets for this layer.\nA preset shows up when clicking the map on a without data (or when right-clicking/long-pressing);\nit will prompt the user to add a new point.\n\nThe most important aspect are the tags, which define which tags the new point will have;\nThe title is shown in the dialog, along with the first sentence of the description.\n\nUpon confirmation, the full description is shown beneath the buttons - perfect to add pictures and examples.\n\nNote: the icon of the preset is determined automatically based on the tags and the icon above. Don't worry about that!\nNB: if no presets are defined, the popup to add new points doesn't show up at all",
+ "description": "Presets for this layer.\nA preset shows up when clicking the map on a without data (or when right-clicking/long-pressing);\nit will prompt the user to add a new point.\n\nThe most important aspect are the tags, which define which tags the new point will have;\nThe title is shown in the dialog, along with the first sentence of the description.\n\nUpon confirmation, the full description is shown beneath the buttons - perfect to add pictures and examples.\n\nNote: the icon of the preset is determined automatically based on the tags and the icon above. Don't worry about that!\nNB: if no presets are defined, the popup to add new points doesn't show up at all\n\ngroup: presets",
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
- "description": "The title - shown on the 'add-new'-button.\n\nThis should include the article of the noun, e.g. 'a hydrant', 'a bicycle pump'.\nThis text will be inserted into `Add {category} here`, becoming `Add a hydrant here`.\n\nDo _not_ indicate 'new': 'add a new shop here' is incorrect, as the shop might have existed forever, it could just be unmapped!",
+ "description": "The title - shown on the 'add-new'-button.\n\nThis should include the article of the noun, e.g. 'a hydrant', 'a bicycle pump'.\nThis text will be inserted into `Add {category} here`, becoming `Add a hydrant here`.\n\nDo _not_ indicate 'new': 'add a new shop here' is incorrect, as the shop might have existed forever, it could just be unmapped!\n\nquestion: What is the word to describe this object?\ninline: Add {translated(value)::font-bold} here",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -215,14 +210,14 @@ export default {
]
},
"tags": {
- "description": "The tags to add. It determines the icon too",
+ "description": "A single tag (encoded as key=value
) out of all the tags to add onto the newly created point.\nNote that the icon in the UI will be chosen automatically based on the tags provided here.\n\nquestion: What tag should be added to the new object?\ntype: simple_tag\ntypeHelper: uploadableOnly",
"type": "array",
"items": {
"type": "string"
}
},
"description": {
- "description": "The _first sentence_ of the description is shown on the button of the `add` menu.\nThe full description is shown in the confirmation dialog.\n\n(The first sentence is until the first '.'-character in the description)",
+ "description": "An extra explanation of what the feature is, if it is not immediately clear from the title alone.\n\nThe _first sentence_ of the description is shown on the button of the `add` menu.\nThe full description is shown in the confirmation dialog.\n\n(The first sentence is until the first '.'-character in the description)\n\nquestion: How would you describe this feature?",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -233,59 +228,22 @@ export default {
]
},
"exampleImages": {
- "description": "Example images, which show real-life pictures of what such a feature might look like\n\nType: image",
+ "description": "The URL of an example image which shows a real-life example of what such a feature might look like.\n\nType: image\nquestion: What is the URL of an image showing such a feature?",
"type": "array",
"items": {
"type": "string"
}
},
- "preciseInput": {
- "description": "If set, the user will prompted to confirm the location before actually adding the data.\nThis will be with a 'drag crosshair'-method.\n\nIf 'preferredBackgroundCategory' is set, the element will attempt to pick a background layer of that category.",
- "anyOf": [
- {
- "type": "object",
- "properties": {
- "preferredBackground": {
- "description": "The type of background picture",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "snapToLayer": {
- "description": "If specified, these layers will be shown to and the new point will be snapped towards it",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "maxSnapDistance": {
- "description": "If specified, a new point will only be snapped if it is within this range.\nDistance in meter\n\nDefault: 10",
- "type": "number"
- }
- }
- },
- {
- "enum": [
- true
- ],
- "type": "boolean"
- }
- ]
+ "snapToLayer": {
+ "description": "question: Should the created point be snapped to a line layer?\n\nIf specified, these layers will be shown in the precise location picker and the new point will be snapped towards it.\nFor example, this can be used to snap against `walls_and_buildings` (e.g. to attach a defibrillator, an entrance, an artwork, ... to the wall)\nor to snap an obstacle (such as a bollard) to the `cycleways_and_roads`.\n\nsuggestions: return Array.from(layers.keys()).map(key => ({if: \"value=\"+key, then: key+\" - \"+layers.get(key).description}))",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "maxSnapDistance": {
+ "description": "question: What is the maximum distance in the location-input that a point can be moved to be snapped to a way?\n\ninline: a point is snapped if the location input is at most {value}m away from an object\n\nIf specified, a new point will only be snapped if it is within this range.\nIf further away, it'll be placed in the center of the location input\nDistance in meter\n\nifunset: Do not snap to a layer",
+ "type": "number"
}
},
"required": [
@@ -295,7 +253,7 @@ export default {
}
},
"tagRenderings": {
- "description": "All the tag renderings.\nA tag rendering is a block that either shows the known value or asks a question.\n\nRefer to the class `TagRenderingConfigJson` to see the possibilities.\n\nNote that we can also use a string here - where the string refers to a tag rendering defined in `assets/questions/questions.json`,\nwhere a few very general questions are defined e.g. website, phone number, ...\nFurthermore, _all_ the questions of another layer can be reused with `otherlayer.*`\nIf you need only a single of the tagRenderings, use `otherlayer.tagrenderingId`\nIf one or more questions have a 'group' or 'label' set, select all the entries with the corresponding group or label with `otherlayer.*group`\nRemark: if a tagRendering is 'lent' from another layer, the 'source'-tags are copied and added as condition.\nIf they are not wanted, remove them with an override\n\nA special value is 'questions', which indicates the location of the questions box. If not specified, it'll be appended to the bottom of the featureInfobox.\n\nAt last, one can define a group of renderings where parts of all strings will be replaced by multiple other strings.\nThis is mainly create questions for a 'left' and a 'right' side of the road.\nThese will be grouped and questions will be asked together",
+ "description": "question: Which tagRenderings should be shown in the infobox?\n\nA tag rendering is a block that either shows the known value or asks a question.\n\nRefer to the class `TagRenderingConfigJson` to see the possibilities.\n\nNote that we can also use a string here - where the string refers to a tag rendering defined in `assets/questions/questions.json`,\nwhere a few very general questions are defined e.g. website, phone number, ...\nFurthermore, _all_ the questions of another layer can be reused with `otherlayer.*`\nIf you need only a single of the tagRenderings, use `otherlayer.tagrenderingId`\nIf one or more questions have a 'group' or 'label' set, select all the entries with the corresponding group or label with `otherlayer.*group`\nRemark: if a tagRendering is 'lent' from another layer, the 'source'-tags are copied and added as condition.\nIf they are not wanted, remove them with an override\n\nA special value is 'questions', which indicates the location of the questions box. If not specified, it'll be appended to the bottom of the featureInfobox.\n\nAt last, one can define a group of renderings where parts of all strings will be replaced by multiple other strings.\nThis is mainly create questions for a 'left' and a 'right' side of the road.\nThese will be grouped and questions will be asked together\n\ntype: tagrendering[]\ngroup: tagrenderings",
"type": "array",
"items": {
"anyOf": [
@@ -355,7 +313,7 @@ export default {
}
},
"filter": {
- "description": "All the extra questions for filtering.\nIf a string is given, mapComplete will search in 'filters.json' for the appropriate filter or will try to parse it as `layername.filterid` and us that one",
+ "description": "All the extra questions for filtering.\nIf a string is given, mapComplete will search in 'filters.json' for the appropriate filter or will try to parse it as `layername.filterid` and us that one\n\ngroup: filters",
"anyOf": [
{
"type": "array",
@@ -384,7 +342,7 @@ export default {
]
},
"deletion": {
- "description": "This block defines under what circumstances the delete dialog is shown for objects of this layer.\nIf set, a dialog is shown to the user to (soft) delete the point.\nThe dialog is built to be user friendly and to prevent mistakes.\nIf deletion is not possible, the dialog will hide itself and show the reason of non-deletability instead.\n\nTo configure, the following values are possible:\n\n- false: never ever show the delete button\n- true: show the default delete button\n- undefined: use the mapcomplete default to show deletion or not. Currently, this is the same as 'false' but this will change in the future\n- or: a hash with options (see below)\n\n The delete dialog\n =================\n\n\n\n#### Hard deletion if enough experience\n\nA feature can only be deleted from OpenStreetMap by mapcomplete if:\n\n- It is a node\n- No ways or relations use the node\n- The logged-in user has enough experience OR the user is the only one to have edited the point previously\n- The logged-in user has no unread messages (or has a ton of experience)\n- The user did not select one of the 'non-delete-options' (see below)\n\nIn all other cases, a 'soft deletion' is used.\n\n#### Soft deletion\n\nA 'soft deletion' is when the point isn't deleted from OSM but retagged so that it'll won't how up in the mapcomplete theme anymore.\nThis makes it look like it was deleted, without doing damage. A fixme will be added to the point.\n\nNote that a soft deletion is _only_ possible if these tags are provided by the theme creator, as they'll be different for every theme\n\n#### No-delete options\n\nIn some cases, the contributor might want to delete something for the wrong reason (e.g. someone who wants to have a path removed \"because the path is on their private property\").\nHowever, the path exists in reality and should thus be on OSM - otherwise the next contributor will pass by and notice \"hey, there is a path missing here! Let me redraw it in OSM!)\n\nThe correct approach is to retag the feature in such a way that it is semantically correct *and* that it doesn't show up on the theme anymore.\nA no-delete option is offered as 'reason to delete it', but secretly retags.",
+ "description": "This block defines under what circumstances the delete dialog is shown for objects of this layer.\nIf set, a dialog is shown to the user to (soft) delete the point.\nThe dialog is built to be user friendly and to prevent mistakes.\nIf deletion is not possible, the dialog will hide itself and show the reason of non-deletability instead.\n\nTo configure, the following values are possible:\n\n- false: never ever show the delete button\n- true: show the default delete button\n- undefined: use the mapcomplete default to show deletion or not. Currently, this is the same as 'false' but this will change in the future\n- or: a hash with options (see below)\n\n### The delete dialog\n\n\n\n#### Hard deletion if enough experience\n\nA feature can only be deleted from OpenStreetMap by mapcomplete if:\n\n- It is a node\n- No ways or relations use the node\n- The logged-in user has enough experience OR the user is the only one to have edited the point previously\n- The logged-in user has no unread messages (or has a ton of experience)\n- The user did not select one of the 'non-delete-options' (see below)\n\nIn all other cases, a 'soft deletion' is used.\n\n#### Soft deletion\n\nA 'soft deletion' is when the point isn't deleted fromOSM but retagged so that it'll won't how up in the mapcomplete theme anymore.\nThis makes it look like it was deleted, without doing damage. A fixme will be added to the point.\n\nNote that a soft deletion is _only_ possible if these tags are provided by the theme creator, as they'll be different for every theme\n\n##### No-delete options\n\nIn some cases, the contributor might want to delete something for the wrong reason (e.g. someone who wants to have a path removed \"because the path is on their private property\").\nHowever, the path exists in reality and should thus be on OSM - otherwise the next contributor will pass by and notice \"hey, there is a path missing here! Let me redraw it in OSM!)\n\nThe correct approach is to retag the feature in such a way that it is semantically correct *and* that it doesn't show up on the theme anymore.\nA no-delete option is offered as 'reason to delete it', but secretly retags.\n\ngroup: editing\ntypes: Use an advanced delete configuration ; boolean\niftrue: Allow deletion\niffalse: Do not allow deletion\nifunset: Do not allow deletion",
"anyOf": [
{
"$ref": "#/definitions/DeleteConfigJson"
@@ -395,7 +353,7 @@ export default {
]
},
"allowMove": {
- "description": "Indicates if a point can be moved and configures the modalities.\n\nA feature can be moved by MapComplete if:\n\n- It is a point\n- The point is _not_ part of a way or a a relation.\n\nOff by default. Can be enabled by setting this flag or by configuring.",
+ "description": "Indicates if a point can be moved and why.\n\nA feature can be moved by MapComplete if:\n\n- It is a point\n- The point is _not_ part of a way or a a relation.\n\ntypes: use an advanced move configuration ; boolean\ngroup: editing\nquestion: Is deleting a point allowed?\niftrue: Allow contributors to move a point (for accuracy or a relocation)\niffalse: Don't allow contributors to move points\nifunset: Don't allow contributors to move points (default)",
"anyOf": [
{
"$ref": "#/definitions/default_3"
@@ -406,7 +364,7 @@ export default {
]
},
"allowSplit": {
- "description": "If set, a 'split this way' button is shown on objects rendered as LineStrings, e.g. highways.\n\nIf the way is part of a relation, MapComplete will attempt to update this relation as well",
+ "description": "If set, a 'split this way' button is shown on objects rendered as LineStrings, e.g. highways.\n\nIf the way is part of a relation, MapComplete will attempt to update this relation as well\nquestion: Should the contributor be able to split ways using this layer?\niftrue: enable the 'split-roads'-component\niffalse: don't enable the split-roads componenet\nifunset: don't enable the split-roads component\ngroup: editing",
"type": "boolean"
},
"units": {
@@ -416,7 +374,7 @@ export default {
}
},
"syncSelection": {
- "description": "If set, synchronizes whether or not this layer is enabled.\n\nno: Do not sync at all, always revert to default\nlocal: keep selection on local storage\ntheme-only: sync via OSM, but this layer will only be toggled in this theme\nglobal: all layers with this ID will be synced accross all themes",
+ "description": "If set, synchronizes whether or not this layer is enabled.\n\ngroup: advanced\nquestion: Should enabling/disabling the layer be saved (locally or in the cloud)?\nsuggestions: return [{if: \"value=no\", then: \"Don't save, always revert to the default\"}, {if: \"value=local\", then: \"Save selection in local storage\"}, {if: \"value=theme-only\", then: \"Save the state in the OSM-usersettings, but apply on this theme only (default)\"}, {if: \"value=global\", then: \"Save in OSM-usersettings and toggle on _all_ themes using this layer\"}]",
"enum": [
"global",
"local",
@@ -426,24 +384,27 @@ export default {
"type": "string"
},
"#": {
- "description": "Used for comments and/or to disable some checks\n\nno-question-hint-check: disables a check in MiscTagRenderingChecks which complains about 'div', 'span' or 'class=subtle'-HTML elements in the tagRendering",
+ "description": "Used for comments and/or to disable some checks\n\nno-question-hint-check: disables a check in MiscTagRenderingChecks which complains about 'div', 'span' or 'class=subtle'-HTML elements in the tagRendering\n\ngroup: hidden",
"type": "string"
+ },
+ "fullNodeDatabase": {
+ "description": "_Set automatically by MapComplete, please ignore_\n\ngroup: hidden",
+ "type": "boolean"
}
},
"required": [
"id",
- "mapRendering",
+ "pointRendering",
"source"
],
"definitions": {
"TagConfigJson": {
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation",
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
"type": "object",
"properties": {
"or": {
@@ -462,8 +423,7 @@ export default {
}
]
},
- "AndTagConfigJson": {
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{and:TagConfigJson[];}": {
"type": "object",
"properties": {
"and": {
@@ -477,8 +437,7 @@ export default {
"and"
]
},
- "OrTagConfigJson": {
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{or:TagConfigJson[];}": {
"type": "object",
"properties": {
"or": {
@@ -561,48 +520,99 @@ export default {
"canonicalDenomination"
]
},
+ "MinimalTagRenderingConfigJson": {
+ "description": "Mostly used for lineRendering and pointRendering",
+ "type": "object",
+ "properties": {
+ "render": {
+ "description": "question: What value should be rendered?\n\nThis piece of text will be shown in the infobox.\nNote that \"&LBRACEkey&RBRACE\"-parts are substituted by the corresponding values of the element.\n\nThis value will be used if there is no mapping which matches (or there are no matches)\nNote that this is a HTML-interpreted value, so you can add links as e.g. '<a href='{website}'>{website}</a>' or include images such as `This is of type A <br><img src='typeA-icon.svg' />`",
+ "type": "string"
+ },
+ "mappings": {
+ "description": "Allows fixed-tag inputs, shown either as radiobuttons or as checkboxes",
+ "type": "array",
+ "items": {
+ "type": "object",
+ "properties": {
+ "if": {
+ "$ref": "#/definitions/TagConfigJson",
+ "description": "question: When should this single mapping match?\n\nIf this condition is met, then the text under `then` will be shown.\nIf no value matches, and the user selects this mapping as an option, then these tags will be uploaded to OSM.\n\nFor example: {'if': 'diet:vegetarion=yes', 'then':'A vegetarian option is offered here'}\n\nThis can be an substituting-tag as well, e.g. {'if': 'addr:street:={_calculated_nearby_streetname}', 'then': '{_calculated_nearby_streetname}'}"
+ },
+ "then": {
+ "description": "question: What text should be shown?\n\nIf the condition `if` is met, the text `then` will be rendered.\nIf not known yet, the user will be presented with `then` as an option",
+ "type": "string"
+ }
+ },
+ "required": [
+ "if",
+ "then"
+ ]
+ }
+ }
+ }
+ },
+ "IconConfigJson": {
+ "type": "object",
+ "properties": {
+ "icon": {
+ "description": "question: What icon should be used?\ntype: icon\nsuggestions: return [\"pin\",\"square\",\"circle\",\"checkmark\",\"clock\",\"close\",\"crosshair\",\"help\",\"home\",\"invalid\",\"location\",\"location_empty\",\"location_locked\",\"note\",\"resolved\",\"ring\",\"scissors\",\"teardrop\",\"teardrop_with_hole_green\",\"triangle\"].map(i => ({if: \"value=\"+i, then: i, icon: i}))",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
+ },
+ {
+ "type": "object",
+ "properties": {
+ "builtin": {
+ "type": "string"
+ },
+ "override": {}
+ },
+ "required": [
+ "builtin",
+ "override"
+ ]
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "color": {
+ "description": "question: What colour should the icon be?\nThis will only work for the default icons such as `pin`,`circle`,...\ntype: color",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
+ },
+ {
+ "type": "object",
+ "properties": {
+ "builtin": {
+ "type": "string"
+ },
+ "override": {}
+ },
+ "required": [
+ "builtin",
+ "override"
+ ]
+ },
+ {
+ "type": "string"
+ }
+ ]
+ }
+ },
+ "required": [
+ "icon"
+ ]
+ },
"TagRenderingConfigJson": {
"description": "A TagRenderingConfigJson is a single piece of code which converts one ore more tags into a HTML-snippet.\nFor an _editable_ tagRendering, use 'QuestionableTagRenderingConfigJson' instead, which extends this one",
"type": "object",
"properties": {
- "id": {
- "description": "The id of the tagrendering, should be an unique string.\nUsed to keep the translations in sync. Only used in the tagRenderings-array of a layerConfig, not requered otherwise.\n\nUse 'questions' to trigger the question box of this group (if a group is defined)",
- "type": "string"
- },
- "labels": {
- "description": "A list of labels. These are strings that are used for various purposes, e.g. to filter them away",
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "classes": {
- "description": "A list of css-classes to apply to the entire tagRendering if the answer is known (not applied on the question).\nThis is only for advanced users",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "description": {
- "description": "A human-readable text explaining what this tagRendering does",
- "anyOf": [
- {
- "$ref": "#/definitions/Record"
- },
- {
- "type": "string"
- }
- ]
- },
"render": {
- "description": "Renders this value. Note that \"{key}\"-parts are substituted by the corresponding values of the element.\nIf neither 'textFieldQuestion' nor 'mappings' are defined, this text is simply shown as default value.\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '{website}' or include images such as `This is of type A
`\ntype: rendered",
+ "description": "question: What text should be rendered?\n\nThis piece of text will be shown in the infobox.\nIn this text, values within braces (such as {braced(key)}) are replaced by the corresponding `value` in the object.\nFor example, if the object contains tags `amenity=school; name=Windy Hill School`, the render string `This school is named {name}` will be shown to the user as `This school is named Windy Hill School`\n\nThis text will be shown if:\n- there is no mapping which matches (or there are no matches)\n- no question, no mappings and no 'freeform' is set\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '<a href='{website}'>{website}</a>' or include images such as `This is of type A <br><img src='typeA-icon.svg' />`\ntype: rendered",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -638,16 +648,38 @@ export default {
}
]
},
- "condition": {
- "description": "Only show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "icon": {
+ "description": "question: what icon should be shown next to the 'render' value?\nAn icon shown next to the rendering; typically shown pretty small\nThis is only shown next to the \"render\" value\nType: icon",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "object",
+ "properties": {
+ "path": {
+ "description": "The path to the icon\nType: icon",
+ "type": "string"
+ },
+ "class": {
+ "description": "A hint to mapcomplete on how to render this icon within the mapping.\nThis is translated to 'mapping-icon-', so defining your own in combination with a custom CSS is possible (but discouraged)",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path"
+ ]
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "string"
+ }
+ ]
+ },
+ "condition": {
+ "description": "question: When should this item be shown?\n\nOnly show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
+ },
+ {
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -655,15 +687,13 @@ export default {
]
},
"metacondition": {
- "description": "If set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
+ "description": "question: When should this item be shown (including special conditions)?\n\nIf set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -671,11 +701,11 @@ export default {
]
},
"freeform": {
- "description": "Allow freeform text input from the user",
+ "description": "question: Should a freeform text field be shown?\nAllow freeform text input from the user\nifunset: Do not add a freeform text field",
"type": "object",
"properties": {
"key": {
- "description": "If this key is present, then 'render' is used to display the value.\nIf this is undefined, the rendering is _always_ shown",
+ "description": "What attribute should be filled out\nIf this key is present in the feature, then 'render' is used to display the value.\nIf this is undefined, the rendering is _always_ shown",
"type": "string"
}
},
@@ -691,10 +721,10 @@ export default {
"properties": {
"if": {
"$ref": "#/definitions/TagConfigJson",
- "description": "If this condition is met, then the text under `then` will be shown.\nIf no value matches, and the user selects this mapping as an option, then these tags will be uploaded to OSM.\n\nFor example: {'if': 'diet:vegetarion=yes', 'then':'A vegetarian option is offered here'}\n\nThis can be an substituting-tag as well, e.g. {'if': 'addr:street:={_calculated_nearby_streetname}', 'then': '{_calculated_nearby_streetname}'}"
+ "description": "question: When should this single mapping match?\n\nIf this condition is met, then the text under `then` will be shown.\nIf no value matches, and the user selects this mapping as an option, then these tags will be uploaded to OSM.\n\nFor example: {'if': 'diet:vegetarion=yes', 'then':'A vegetarian option is offered here'}\n\nThis can be an substituting-tag as well, e.g. {'if': 'addr:street:={_calculated_nearby_streetname}', 'then': '{_calculated_nearby_streetname}'}"
},
"then": {
- "description": "If the condition `if` is met, the text `then` will be rendered.\nIf not known yet, the user will be presented with `then` as an option\nType: rendered",
+ "description": "question: What text should be shown?\n\nIf the condition `if` is met, the text `then` will be rendered.\nIf not known yet, the user will be presented with `then` as an option\nType: rendered",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -705,7 +735,7 @@ export default {
]
},
"icon": {
- "description": "An icon supporting this mapping; typically shown pretty small\nType: icon",
+ "description": "question: What icon should be added to this mapping?\nAn icon supporting this mapping; typically shown pretty small\ninline:
{icon}\nType: icon",
"anyOf": [
{
"type": "object",
@@ -734,6 +764,21 @@ export default {
"then"
]
}
+ },
+ "description": {
+ "description": "A human-readable text explaining what this tagRendering does.\nMostly used for the shared tagrenderings",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "classes": {
+ "description": "question: What css-classes should be applied to showing this attribute?\n\nA list of css-classes to apply to the entire tagRendering.\nThese classes are applied in 'answer'-mode, not in question mode\nThis is only for advanced users.\n\nValues are split on ` ` (space)",
+ "type": "string"
}
}
},
@@ -745,13 +790,21 @@ export default {
"properties": {
"if": {
"$ref": "#/definitions/TagConfigJson",
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation"
+ "description": "question: What tags should be matched to show this option?\n\nIf in 'question'-mode and the contributor selects this option, these tags will be applied to the object"
},
"then": {
- "description": "Shown if the 'if is fulfilled\nType: rendered"
+ "description": "Question: What corresponding text should be shown?\nShown if the `if` is fulfilled\nType: rendered",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
},
"icon": {
- "description": "An extra icon supporting the choice\nType: icon",
+ "description": "question: What icon should be shown next to this mapping?\n\nThis icon will only be shown if the value is known, it is not displayed in the options (but might be in the future)\n\nifunset: Show no icon\nType: icon",
"anyOf": [
{
"type": "object",
@@ -775,15 +828,13 @@ export default {
]
},
"hideInAnswer": {
- "description": "In some cases, multiple taggings exist (e.g. a default assumption, or a commonly mapped abbreviation and a fully written variation).\n\nIn the latter case, a correct text should be shown, but only a single, canonical tagging should be selectable by the user.\nIn this case, one of the mappings can be hiden by setting this flag.\n\nTo demonstrate an example making a default assumption:\n\nmappings: [\n {\n if: \"access=\", -- no access tag present, we assume accessible\n then: \"Accessible to the general public\",\n hideInAnswer: true\n },\n {\n if: \"access=yes\",\n then: \"Accessible to the general public\", -- the user selected this, we add that to OSM\n },\n {\n if: \"access=no\",\n then: \"Not accessible to the public\"\n }\n]\n\n\nFor example, for an operator, we have `operator=Agentschap Natuur en Bos`, which is often abbreviated to `operator=ANB`.\nThen, we would add two mappings:\n{\n if: \"operator=Agentschap Natuur en Bos\" -- the non-abbreviated version which should be uploaded\n then: \"Maintained by Agentschap Natuur en Bos\"\n},\n{\n if: \"operator=ANB\", -- we don't want to upload abbreviations\n then: \"Maintained by Agentschap Natuur en Bos\"\n hideInAnswer: true\n}\n\nHide in answer can also be a tagsfilter, e.g. to make sure an option is only shown when appropriate.\nKeep in mind that this is reverse logic: it will be hidden in the answer if the condition is true, it will thus only show in the case of a mismatch\n\ne.g., for toilets: if \"wheelchair=no\", we know there is no wheelchair dedicated room.\nFor the location of the changing table, the option \"in the wheelchair accessible toilet is weird\", so we write:\n\n{\n \"question\": \"Where is the changing table located?\"\n \"mappings\": [\n {\"if\":\"changing_table:location=female\",\"then\":\"In the female restroom\"},\n {\"if\":\"changing_table:location=male\",\"then\":\"In the male restroom\"},\n {\"if\":\"changing_table:location=wheelchair\",\"then\":\"In the wheelchair accessible restroom\", \"hideInAnswer\": \"wheelchair=no\"},\n\n ]\n}\n\nAlso have a look for the meta-tags\n{\n if: \"operator=Agentschap Natuur en Bos\",\n then: \"Maintained by Agentschap Natuur en Bos\",\n hideInAnswer: \"_country!=be\"\n}",
+ "description": "question: Under what circumstances should this mapping be hidden from the possibilities a contributor can pick?\niftrue: Never show this mapping as option to pick\nifunset: Always show this mapping as option to pick\ntype: tag\n\nIn some cases, multiple taggings exist (e.g. a default assumption, or a commonly mapped abbreviation and a fully written variation).\n\nIn the latter case, a correct text should be shown, but only a single, canonical tagging should be selectable by the user.\nIn this case, one of the mappings can be hiden by setting this flag.\n\nTo demonstrate an example making a default assumption:\n\nmappings: [\n {\n if: \"access=\", -- no access tag present, we assume accessible\n then: \"Accessible to the general public\",\n hideInAnswer: true\n },\n {\n if: \"access=yes\",\n then: \"Accessible to the general public\", -- the user selected this, we add that to OSM\n },\n {\n if: \"access=no\",\n then: \"Not accessible to the public\"\n }\n]\n\n\nFor example, for an operator, we have `operator=Agentschap Natuur en Bos`, which is often abbreviated to `operator=ANB`.\nThen, we would add two mappings:\n{\n if: \"operator=Agentschap Natuur en Bos\" -- the non-abbreviated version which should be uploaded\n then: \"Maintained by Agentschap Natuur en Bos\"\n},\n{\n if: \"operator=ANB\", -- we don't want to upload abbreviations\n then: \"Maintained by Agentschap Natuur en Bos\"\n hideInAnswer: true\n}\n\nHide in answer can also be a tagsfilter, e.g. to make sure an option is only shown when appropriate.\nKeep in mind that this is reverse logic: it will be hidden in the answer if the condition is true, it will thus only show in the case of a mismatch\n\ne.g., for toilets: if \"wheelchair=no\", we know there is no wheelchair dedicated room.\nFor the location of the changing table, the option \"in the wheelchair accessible toilet is weird\", so we write:\n\n{\n \"question\": \"Where is the changing table located?\"\n \"mappings\": [\n {\"if\":\"changing_table:location=female\",\"then\":\"In the female restroom\"},\n {\"if\":\"changing_table:location=male\",\"then\":\"In the male restroom\"},\n {\"if\":\"changing_table:location=wheelchair\",\"then\":\"In the wheelchair accessible restroom\", \"hideInAnswer\": \"wheelchair=no\"},\n\n ]\n}\n\nAlso have a look for the meta-tags\n{\n if: \"operator=Agentschap Natuur en Bos\",\n then: \"Maintained by Agentschap Natuur en Bos\",\n hideInAnswer: \"_country!=be\"\n}",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": [
@@ -794,15 +845,13 @@ export default {
]
},
"ifnot": {
- "description": "Only applicable if 'multiAnswer' is set.\nThis is for situations such as:\n`accepts:coins=no` where one can select all the possible payment methods. However, we want to make explicit that some options _were not_ selected.\nThis can be done with `ifnot`\nNote that we can not explicitly render this negative case to the user, we cannot show `does _not_ accept coins`.\nIf this is important to your usecase, consider using multiple radiobutton-fields without `multiAnswer`",
+ "description": "question: What tags should be applied if this mapping is _not_ chosen?\n\nOnly applicable if 'multiAnswer' is set.\nThis is for situations such as:\n`accepts:coins=no` where one can select all the possible payment methods. However, we want to make explicit that some options _were not_ selected.\nThis can be done with `ifnot`\nNote that we can not explicitly render this negative case to the user, we cannot show `does _not_ accept coins`.\nIf this is important to your usecase, consider using multiple radiobutton-fields without `multiAnswer`",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -810,26 +859,24 @@ export default {
]
},
"addExtraTags": {
- "description": "If chosen as answer, these tags will be applied as well onto the object.\nNot compatible with multiAnswer.\n\nThis can be used e.g. to erase other keys which indicate the 'not' value:\n```json\n{\n \"if\": \"crossing:marking=rainbow\",\n \"then\": \"This is a rainbow crossing\",\n \"addExtraTags\": \"not:crossing:marking=\"\n}\n```",
+ "description": "question: What extra tags should be added to the object if this object is chosen?\ntype: simple_tag[]\n\nIf chosen as answer, these tags will be applied onto the object, together with the tags from the `if`\nNot compatible with multiAnswer.\n\nThis can be used e.g. to erase other keys which indicate the 'not' value:\n```json\n{\n \"if\": \"crossing:marking=rainbow\",\n \"then\": \"This is a rainbow crossing\",\n \"addExtraTags\": [\"not:crossing:marking=\"]\n}\n```",
"type": "array",
"items": {
"type": "string"
}
},
"searchTerms": {
- "description": "If there are many options, the mappings-radiobuttons will be replaced by an element with a searchfunction\n\nSearchterms (per language) allow to easily find an option if there are many options",
+ "description": "question: If there are many options, what search terms match too?\nIf there are many options, the mappings-radiobuttons will be replaced by an element with a searchfunction\n\nSearchterms (per language) allow to easily find an option if there are many options\ngroup: hidden",
"$ref": "#/definitions/Record"
},
"priorityIf": {
- "description": "If the searchable selector is picked, mappings with this item will have priority and show up even if the others are hidden\nUse this sparingly",
+ "description": "If the searchable selector is picked, mappings with this item will have priority and show up even if the others are hidden\nUse this sparingly\ngroup: hidden",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -837,7 +884,7 @@ export default {
]
},
"#": {
- "description": "Used for comments or to disable a validation\n\nignore-image-in-then: normally, a `then`-clause is not allowed to have an `img`-html-element as icons are preferred. In some cases (most notably title-icons), this is allowed",
+ "description": "Used for comments or to disable a validation\n\ngroup: hidden\nignore-image-in-then: normally, a `then`-clause is not allowed to have an `img`-html-element as icons are preferred. In some cases (most notably title-icons), this is allowed",
"type": "string"
}
},
@@ -854,22 +901,18 @@ export default {
"type": "object",
"properties": {
"location": {
- "description": "All the locations that this point should be rendered at.\nPossible values are:\n- `point`: only renders points at their location\n- `centroid`: show a symbol at the centerpoint of a (multi)Linestring and (multi)polygon. Points will _not_ be rendered with this\n- `projected_centerpoint`: Only on (multi)linestrings: calculate the centerpoint and snap it to the way\n- `start` and `end`: only on linestrings: add a point to the first/last coordinate of the LineString",
+ "description": "question: At what location should this icon be shown?\nmultianswer: true\nsuggestions: return [{if: \"value=point\",then: \"Show an icon for point (node) objects\"},{if: \"value=centroid\",then: \"Show an icon for line or polygon (way) objects at their centroid location\"}, {if: \"value=start\",then: \"Show an icon for line (way) objects at the start\"},{if: \"value=end\",then: \"Show an icon for line (way) object at the end\"},{if: \"value=projected_centerpoint\",then: \"Show an icon for line (way) object near the centroid location, but moved onto the line\"}]",
"type": "array",
"items": {
"type": "string"
}
},
- "icon": {
- "description": "The icon for an element.\nNote that this also doubles as the icon for this layer (rendered with the overpass-tags) ánd the icon in the presets.\n\nThe result of the icon is rendered as follows:\nthe resulting string is interpreted as a _list_ of items, separated by \";\". The bottommost layer is the first layer.\nAs a result, on could use a generic pin, then overlay it with a specific icon.\nTo make things even more practical, one can use all SVG's from the folder \"assets/svg\" and _substitute the color_ in it.\nE.g. to draw a red pin, use \"pin:#f00\", to have a green circle with your icon on top, use `circle:#0f0;`\n\nType: icon",
- "anyOf": [
- {
- "$ref": "#/definitions/TagRenderingConfigJson"
- },
- {
- "type": "string"
- }
- ]
+ "marker": {
+ "description": "The marker for an element.\nNote that this also defines the icon for this layer (rendered with the overpass-tags) and the icon in the presets.\n\nThe result of the icon is rendered as follows:\n- The first icon is rendered on the map\n- The second entry is overlayed on top of it\n- ...\n\nAs a result, on could use a generic icon (`pin`, `circle`, `square`) with a color, then overlay it with a specific icon.",
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/IconConfigJson"
+ }
},
"iconBadges": {
"description": "A list of extra badges to show next to the icon as small badge\nThey will be added as a 25% height icon at the bottom right of the icon, with all the badges in a flex layout.\n\nNote: strings are interpreted as icons, so layering and substituting is supported. You can use `circle:white;./my_icon.svg` to add a background circle",
@@ -879,13 +922,13 @@ export default {
"properties": {
"if": {
"$ref": "#/definitions/TagConfigJson",
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation"
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag"
},
"then": {
"description": "Badge to show\nType: icon",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "string"
@@ -900,7 +943,18 @@ export default {
}
},
"iconSize": {
- "description": "A string containing \"width,height\" or \"width,height,anchorpoint\" where anchorpoint is any of 'center', 'top', 'bottom', 'left', 'right', 'bottomleft','topright', ...\nDefault is '40,40,center'",
+ "description": "question: What size should the marker be on the map?\nA string containing \",\" in pixels\nifunset: Use the default size (40,40 px)",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TagRenderingConfigJson"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "anchor": {
+ "description": "question: What is the anchorpoint of the icon?\n\nThis matches the geographical point with a location on the icon.\n\nifunset: Use MapComplete-default (center)\nsuggestions: return [{if: \"value=center\", then: \"Place the center of the icon on the geographical location\"},{if: \"value=top\", then: \"Place the top of the icon on the geographical location\"},{if: \"value=bottom\", then: \"Place the bottom of the icon on the geographical location\"},{if: \"value=left\", then: \"Place the left of the icon on the geographical location\"},{if: \"value=right\", then: \"Place the right of the icon on the geographical location\"}]",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -911,7 +965,7 @@ export default {
]
},
"rotation": {
- "description": "The rotation of an icon, useful for e.g. directions.\nUsage: as if it were a css property for 'rotate', thus has to end with 'deg', e.g. `90deg`, `{direction}deg`, `calc(90deg - {camera:direction}deg)``",
+ "description": "question: What rotation should be applied on the icon?\nThis is mostly useful for items that face a specific direction, such as surveillance cameras\nThis is interpreted as css property for 'rotate', thus has to end with 'deg', e.g. `90deg`, `{direction}deg`, `calc(90deg - {camera:direction}deg)``\nifunset: Do not rotate",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -922,7 +976,7 @@ export default {
]
},
"label": {
- "description": "A HTML-fragment that is shown below the icon, for example:\n{name}
\n\nIf the icon is undefined, then the label is shown in the center of the feature.\nNote that, if the wayhandling hides the icon then no label is shown as well.",
+ "description": "question: What label should be shown beneath the marker?\nFor example: `<div style=\"background: white\">{name}</div>`\n\nIf the icon is undefined, then the label is shown in the center of the feature.\ntypes: Dynamic value | string\ninline: Always show label {value} beneath the marker\nifunset: Do not show a label beneath the marker",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -933,7 +987,7 @@ export default {
]
},
"css": {
- "description": "A snippet of css code which is applied onto the container of the entire marker",
+ "description": "question: What CSS should be applied to the entire marker?\nYou can set the css-properties here, e.g. `background: red; font-size: 12px; `\nThis will be applied to the _container_ containing both the marker and the label\ninline: Apply CSS-style {value} to the _entire marker_\ntypes: Dynamic value ; string\nifunset: Do not apply extra CSS element to the entire marker",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -944,7 +998,7 @@ export default {
]
},
"cssClasses": {
- "description": "A snippet of css-classes which are applied onto the container of the entire marker. They can be space-separated",
+ "description": "question: Which CSS-classes should be applied to the entire marker?\nThis will be applied to the _container_ containing both the marker and the label\n\nThe classes should be separated by a space (` `)\nYou can use most Tailwind-css classes, see https://tailwindcss.com/ for more information\nFor example: `center bg-gray-500 mx-2 my-1 rounded-full`\ninline: Apply CSS-classes {value} to the entire container\nifunset: Do not apply extra CSS-classes to the label\ntypes: Dynamic value ; string\nifunset: Do not apply extra CSS-classes to the entire marker",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -955,7 +1009,7 @@ export default {
]
},
"labelCss": {
- "description": "Css that is applied onto the label",
+ "description": "question: What CSS should be applied to the label?\nYou can set the css-properties here, e.g. `background: red; font-size: 12px; `\ninline: Apply CSS-style {value} to the label\ntypes: Dynamic value ; string\nifunset: Do not apply extra CSS-labels to the label",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -966,7 +1020,7 @@ export default {
]
},
"labelCssClasses": {
- "description": "Css classes that are applied onto the label; can be space-separated",
+ "description": "question: Which CSS-classes should be applied to the label?\n\nThe classes should be separated by a space (` `)\nYou can use most Tailwind-css classes, see https://tailwindcss.com/ for more information\nFor example: `center bg-gray-500 mx-2 my-1 rounded-full`\ninline: Apply CSS-classes {value} to the label\ntypes: Dynamic value ; string\nifunset: Do not apply extra CSS-classes to the label",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -977,7 +1031,7 @@ export default {
]
},
"pitchAlignment": {
- "description": "If the map is pitched, the marker will stay parallel to the screen.\nSet to 'map' if you want to put it flattened on the map",
+ "description": "question: If the map is pitched, should the icon stay parallel to the screen or to the groundplane?\nsuggestions: return [{if: \"value=canvas\", then: \"The icon will stay upward and not be transformed as if it sticks to the screen\"}, {if: \"value=map\", then: \"The icon will be transformed as if it were painted onto the ground. (Automatically sets rotationAlignment)\"}]",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -992,7 +1046,7 @@ export default {
]
},
"rotationAlignment": {
- "description": "If the map is rotated, the icon will still point to the north if no rotation was applied",
+ "description": "question: Should the icon be rotated if the map is rotated?\nifunset: Do not rotate or tilt icons. Always keep the icons straight\nsuggestions: return [{if: \"value=canvas\", then: \"Never rotate the icon\"}, {if: \"value=map\", then: \"If the map is rotated, rotate the icon as well. This gives the impression of an icon that floats perpendicular above the ground.\"}]",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -1016,10 +1070,10 @@ export default {
"type": "object",
"properties": {
"color": {
- "description": "The color for way-elements and SVG-elements.\nIf the value starts with \"--\", the style of the body element will be queried for the corresponding variable instead",
+ "description": "question: What color should lines be drawn in?\n\nFor an area, this will be the colour of the outside line.\nIf the value starts with \"--\", the style of the body element will be queried for the corresponding variable instead\n\ntypes: dynamic value ; string\ntitle: Line Colour\ninline: The line colour always is {value}\ntype: color",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "string"
@@ -1027,10 +1081,10 @@ export default {
]
},
"width": {
- "description": "The stroke-width for way-elements",
+ "description": "question: How wide should the line be?\nThe stroke-width for way-elements\n\ntypes: dynamic value ; string\ntitle: Line width\ninline: The line width is {value} pixels\ntype: pnat\nifunset: Use the default-linewidth of 7 pixels",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": [
@@ -1041,47 +1095,25 @@ export default {
]
},
"dashArray": {
- "description": "A dasharray, e.g. \"5 6\"\nThe dasharray defines 'pixels of line, pixels of gap, pixels of line, pixels of gap',\nDefault value: \"\" (empty string == full line)",
- "anyOf": [
- {
- "$ref": "#/definitions/TagRenderingConfigJson"
- },
- {
- "type": "string"
- }
- ]
+ "description": "question: Should a dasharray be used to render the lines?\nThe dasharray defines 'pixels of line, pixels of gap, pixels of line, pixels of gap, ...'. For example, `5 6` will be 5 pixels of line followed by a 6 pixel gap.\nCannot be a dynamic property due to a mapbox limitation\nifunset: Ways are rendered with a full line",
+ "type": "string"
},
"lineCap": {
- "description": "The form at the end of a line",
+ "description": "question: What form should the line-ending have?\nsuggestions: return [{if:\"value=round\",then:\"Round endings\"}, {if: \"value=square\", then: \"square endings\"}, {if: \"value=butt\", then: \"no ending (square ending at the end, without padding)\"}]\ntypes: dynamic value ; string\ntitle: Line Cap\nifunset: Use the default value (round ending)",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "string"
}
]
},
- "fill": {
- "description": "Whether or not to fill polygons",
- "anyOf": [
- {
- "$ref": "#/definitions/TagRenderingConfigJson"
- },
- {
- "enum": [
- "no",
- "yes"
- ],
- "type": "string"
- }
- ]
- },
"fillColor": {
- "description": "The color to fill a polygon with.\nIf undefined, this will be slightly more opaque version of the stroke line",
+ "description": "question: What colour should be used as fill colour for polygons?\nifunset: The polygon fill colour will be a more transparent version of the stroke colour\nsuggestions: return [{if: \"value=#00000000\", then: \"Use a transparent fill (only render the outline)\"}]\ninline: The fill colour is {value}\ntypes: dynamic value ; string\ntype: color",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "string"
@@ -1089,10 +1121,10 @@ export default {
]
},
"offset": {
- "description": "The number of pixels this line should be moved.\nUse a positive numbe to move to the right, a negative to move to the left (left/right as defined by the drawing direction of the line).\n\nIMPORTANT: MapComplete will already normalize 'key:both:property' and 'key:both' into the corresponding 'key:left' and 'key:right' tagging (same for 'sidewalk=left/right/both' which is rewritten to 'sidewalk:left' and 'sidewalk:right')\nThis simplifies programming. Refer to the CalculatedTags.md-documentation for more details",
+ "description": "question: Should the lines be moved (offsetted) with a number of pixels against the geographical lines?\nThe number of pixels this line should be moved.\nUse a positive number to move to the right in the drawing direction or a negative to move to the left (left/right as defined by the drawing direction of the line).\n\nIMPORTANT: MapComplete will already normalize 'key:both:property' and 'key:both' into the corresponding 'key:left' and 'key:right' tagging (same for 'sidewalk=left/right/both' which is rewritten to 'sidewalk:left' and 'sidewalk:right')\nThis simplifies programming. Refer to the CalculatedTags.md-documentation for more details\nifunset: don't offset lines on the map\ninline: Pixel offset by {value} pixels\ntypes: dynamic value ; number\ntype: int",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "number"
@@ -1101,99 +1133,38 @@ export default {
}
}
},
- "default": {
- "description": "Rewrites and multiplies the given renderings of type T.\n\nThis can be used for introducing many similar questions automatically,\nwhich also makes translations easier.\n\n(Note that the key does _not_ need to be wrapped in {}.\nHowever, we recommend to use them if the key is used in a translation, as missing keys will be picked up and warned for by the translation scripts)\n\nFor example:\n\n```\n{\n rewrite: {\n sourceString: [\"key\", \"a|b|c\"],\n into: [\n [\"X\", 0]\n [\"Y\", 1],\n [\"Z\", 2]\n ],\n renderings: [{\n \"key\":\"a|b|c\"\n }]\n }\n}\n```\nwill result in _three_ copies (as the values to rewrite into have three values, namely:\n\n[\n {\n # The first pair: key --> X, a|b|c --> 0\n \"X\": 0\n },\n {\n \"Y\": 1\n },\n {\n \"Z\": 2\n }\n\n]",
- "type": "object",
- "properties": {
- "rewrite": {
- "type": "object",
- "properties": {
- "sourceString": {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "into": {
- "type": "array",
- "items": {
- "type": "array",
- "items": {}
- }
- }
- },
- "required": [
- "into",
- "sourceString"
- ]
- },
- "renderings": {
- "anyOf": [
- {
- "$ref": "#/definitions/default_4"
- },
- {
- "$ref": "#/definitions/default_5"
- },
- {
- "type": "array",
- "items": {
- "$ref": "#/definitions/default_5"
- }
- },
- {
- "type": "array",
- "items": {
- "$ref": "#/definitions/default_4"
- }
- }
- ]
- }
- },
- "required": [
- "renderings",
- "rewrite"
- ]
- },
"QuestionableTagRenderingConfigJson": {
"description": "A QuestionableTagRenderingConfigJson is a single piece of code which converts one ore more tags into a HTML-snippet.\nIf the desired tags are missing and a question is defined, a question will be shown instead.",
"type": "object",
"properties": {
- "question": {
- "description": "If it turns out that this tagRendering doesn't match _any_ value, then we show this question.\nIf undefined, the question is never asked and this tagrendering is read-only",
- "anyOf": [
- {
- "$ref": "#/definitions/Record"
- },
- {
- "type": "string"
- }
- ]
+ "id": {
+ "type": "string"
},
- "questionHint": {
- "description": "A hint which is shown in subtle text under the question.\nThis can give some extra information on what the answer should ook like",
- "anyOf": [
- {
- "$ref": "#/definitions/Record"
- },
- {
- "type": "string"
- }
- ]
+ "mappings": {
+ "description": "Allows fixed-tag inputs, shown either as radiobuttons or as checkboxes\n\nquestion: What are common options?",
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/MappingConfigJson"
+ }
+ },
+ "multiAnswer": {
+ "description": "If true, use checkboxes instead of radio buttons when asking the question\n\nquestion: Should a contributor be allowed to select multiple mappings?\n\niftrue: allow to select multiple mappings\niffalse: only allow to select a single mapping\nifunset: only allow to select a single mapping",
+ "type": "boolean"
},
"freeform": {
"description": "Allow freeform text input from the user",
"type": "object",
"properties": {
"key": {
+ "description": "question: What is the name of the attribute that should be written to?\nifunset: do not offer a freeform textfield as answer option",
"type": "string"
},
"type": {
- "description": "The type of the text-field, e.g. 'string', 'nat', 'float', 'date',...\nSee Docs/SpecialInputElements.md and UI/Input/ValidatedTextField.ts for supported values",
+ "description": "question: What is the input type?\nThe type of the text-field, e.g. 'string', 'nat', 'float', 'date',...\nSee Docs/SpecialInputElements.md and UI/Input/ValidatedTextField.ts for supported values\nifunset: use an unconstrained string as input (default)\nsuggestions: return validators.AllValidators.filter(type => !type.isMeta).map((type) => ({if: \"value=\"+type.name, then: \"\"+type.name+\" \"+type.explanation.split(\"\\n\")[0]}))",
"type": "string"
},
"placeholder": {
- "description": "A (translated) text that is shown (as gray text) within the textfield"
+ "description": "question: What placeholder text should be shown in the input-element if there is no input?\nA (translated) text that is shown (as gray text) within the textfield\ntype: translation"
},
"helperArgs": {
"description": "Extra parameters to initialize the input helper arguments.\nFor semantics, see the 'SpecialInputElements.md'",
@@ -1208,56 +1179,34 @@ export default {
}
},
"inline": {
- "description": "When set, influences the way a question is asked.\nInstead of showing a full-width text field, the text field will be shown within the rendering of the question.\n\nThis combines badly with special input elements, as it'll distort the layout.\nNote that this will be set automatically if no special elements are present.",
+ "description": "question: Show the freeform as box within the question?\nInstead of showing a full-width text field, the text field will be shown within the rendering of the question.\n\nThis combines badly with special input elements, as it'll distort the layout.\nifunset: show the freeform input field full-width\niftrue: show the freeform input field as a small field within the question",
"type": "boolean"
},
"default": {
- "description": "default value to enter if no previous tagging is present.\nNormally undefined (aka do not enter anything)",
+ "description": "question: What value should be entered in the text field if no value is set?\nThis can help people to quickly enter the most common option\nifunset: do not prefill the textfield",
"type": "string"
+ },
+ "invalidValues": {
+ "description": "question: What values of the freeform key should be interpreted as 'unknown'?\nFor example, if a feature has `shop=yes`, the question 'what type of shop is this?' should still asked\nifunset: The question will be considered answered if any value is set for the key",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
+ },
+ {
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
+ },
+ {
+ "type": "string"
+ }
+ ]
}
},
"required": [
"key"
]
},
- "multiAnswer": {
- "description": "If true, use checkboxes instead of radio buttons when asking the question",
- "type": "boolean"
- },
- "mappings": {
- "description": "Allows fixed-tag inputs, shown either as radiobuttons or as checkboxes",
- "type": "array",
- "items": {
- "$ref": "#/definitions/MappingConfigJson"
- }
- },
- "id": {
- "description": "The id of the tagrendering, should be an unique string.\nUsed to keep the translations in sync. Only used in the tagRenderings-array of a layerConfig, not requered otherwise.\n\nUse 'questions' to trigger the question box of this group (if a group is defined)",
- "type": "string"
- },
- "labels": {
- "description": "A list of labels. These are strings that are used for various purposes, e.g. to filter them away",
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "classes": {
- "description": "A list of css-classes to apply to the entire tagRendering if the answer is known (not applied on the question).\nThis is only for advanced users",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "description": {
- "description": "A human-readable text explaining what this tagRendering does",
+ "question": {
+ "description": "question: What question should be shown to the contributor?\n\nA question is presented ot the user if no mapping matches and the 'freeform' key is not set as well.\n\nifunset: This tagrendering will be shown if it is known, but cannot be edited by the contributor, effectively resutling in a read-only rendering",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -1267,8 +1216,26 @@ export default {
}
]
},
+ "questionHint": {
+ "description": "question: Should some extra information be shown to the contributor, alongside the question?\nThis hint is shown in subtle text under the question.\nThis can give some extra information on what the answer should ook like\nifunset: No extra hint is given",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "labels": {
+ "description": "A list of labels. These are strings that are used for various purposes, e.g. to only include a subset of the tagRenderings when reusing a layer",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
"render": {
- "description": "Renders this value. Note that \"{key}\"-parts are substituted by the corresponding values of the element.\nIf neither 'textFieldQuestion' nor 'mappings' are defined, this text is simply shown as default value.\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '{website}' or include images such as `This is of type A
`\ntype: rendered",
+ "description": "question: What text should be rendered?\n\nThis piece of text will be shown in the infobox.\nIn this text, values within braces (such as {braced(key)}) are replaced by the corresponding `value` in the object.\nFor example, if the object contains tags `amenity=school; name=Windy Hill School`, the render string `This school is named {name}` will be shown to the user as `This school is named Windy Hill School`\n\nThis text will be shown if:\n- there is no mapping which matches (or there are no matches)\n- no question, no mappings and no 'freeform' is set\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '<a href='{website}'>{website}</a>' or include images such as `This is of type A <br><img src='typeA-icon.svg' />`\ntype: rendered",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -1304,16 +1271,38 @@ export default {
}
]
},
- "condition": {
- "description": "Only show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "icon": {
+ "description": "question: what icon should be shown next to the 'render' value?\nAn icon shown next to the rendering; typically shown pretty small\nThis is only shown next to the \"render\" value\nType: icon",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "object",
+ "properties": {
+ "path": {
+ "description": "The path to the icon\nType: icon",
+ "type": "string"
+ },
+ "class": {
+ "description": "A hint to mapcomplete on how to render this icon within the mapping.\nThis is translated to 'mapping-icon-', so defining your own in combination with a custom CSS is possible (but discouraged)",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path"
+ ]
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "string"
+ }
+ ]
+ },
+ "condition": {
+ "description": "question: When should this item be shown?\n\nOnly show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
+ },
+ {
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -1321,61 +1310,70 @@ export default {
]
},
"metacondition": {
- "description": "If set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
+ "description": "question: When should this item be shown (including special conditions)?\n\nIf set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
}
]
+ },
+ "description": {
+ "description": "A human-readable text explaining what this tagRendering does.\nMostly used for the shared tagrenderings",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "classes": {
+ "description": "question: What css-classes should be applied to showing this attribute?\n\nA list of css-classes to apply to the entire tagRendering.\nThese classes are applied in 'answer'-mode, not in question mode\nThis is only for advanced users.\n\nValues are split on ` ` (space)",
+ "type": "string"
}
- }
+ },
+ "required": [
+ "id"
+ ]
},
"Partial": {
"type": "object",
"properties": {
- "question": {
- "description": "If it turns out that this tagRendering doesn't match _any_ value, then we show this question.\nIf undefined, the question is never asked and this tagrendering is read-only",
- "anyOf": [
- {
- "$ref": "#/definitions/Record"
- },
- {
- "type": "string"
- }
- ]
+ "id": {
+ "type": "string"
},
- "questionHint": {
- "description": "A hint which is shown in subtle text under the question.\nThis can give some extra information on what the answer should ook like",
- "anyOf": [
- {
- "$ref": "#/definitions/Record"
- },
- {
- "type": "string"
- }
- ]
+ "mappings": {
+ "description": "Allows fixed-tag inputs, shown either as radiobuttons or as checkboxes\n\nquestion: What are common options?",
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/MappingConfigJson"
+ }
+ },
+ "multiAnswer": {
+ "description": "If true, use checkboxes instead of radio buttons when asking the question\n\nquestion: Should a contributor be allowed to select multiple mappings?\n\niftrue: allow to select multiple mappings\niffalse: only allow to select a single mapping\nifunset: only allow to select a single mapping",
+ "type": "boolean"
},
"freeform": {
"description": "Allow freeform text input from the user",
"type": "object",
"properties": {
"key": {
+ "description": "question: What is the name of the attribute that should be written to?\nifunset: do not offer a freeform textfield as answer option",
"type": "string"
},
"type": {
- "description": "The type of the text-field, e.g. 'string', 'nat', 'float', 'date',...\nSee Docs/SpecialInputElements.md and UI/Input/ValidatedTextField.ts for supported values",
+ "description": "question: What is the input type?\nThe type of the text-field, e.g. 'string', 'nat', 'float', 'date',...\nSee Docs/SpecialInputElements.md and UI/Input/ValidatedTextField.ts for supported values\nifunset: use an unconstrained string as input (default)\nsuggestions: return validators.AllValidators.filter(type => !type.isMeta).map((type) => ({if: \"value=\"+type.name, then: \"\"+type.name+\" \"+type.explanation.split(\"\\n\")[0]}))",
"type": "string"
},
"placeholder": {
- "description": "A (translated) text that is shown (as gray text) within the textfield"
+ "description": "question: What placeholder text should be shown in the input-element if there is no input?\nA (translated) text that is shown (as gray text) within the textfield\ntype: translation"
},
"helperArgs": {
"description": "Extra parameters to initialize the input helper arguments.\nFor semantics, see the 'SpecialInputElements.md'",
@@ -1390,56 +1388,34 @@ export default {
}
},
"inline": {
- "description": "When set, influences the way a question is asked.\nInstead of showing a full-width text field, the text field will be shown within the rendering of the question.\n\nThis combines badly with special input elements, as it'll distort the layout.\nNote that this will be set automatically if no special elements are present.",
+ "description": "question: Show the freeform as box within the question?\nInstead of showing a full-width text field, the text field will be shown within the rendering of the question.\n\nThis combines badly with special input elements, as it'll distort the layout.\nifunset: show the freeform input field full-width\niftrue: show the freeform input field as a small field within the question",
"type": "boolean"
},
"default": {
- "description": "default value to enter if no previous tagging is present.\nNormally undefined (aka do not enter anything)",
+ "description": "question: What value should be entered in the text field if no value is set?\nThis can help people to quickly enter the most common option\nifunset: do not prefill the textfield",
"type": "string"
+ },
+ "invalidValues": {
+ "description": "question: What values of the freeform key should be interpreted as 'unknown'?\nFor example, if a feature has `shop=yes`, the question 'what type of shop is this?' should still asked\nifunset: The question will be considered answered if any value is set for the key",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
+ },
+ {
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
+ },
+ {
+ "type": "string"
+ }
+ ]
}
},
"required": [
"key"
]
},
- "multiAnswer": {
- "description": "If true, use checkboxes instead of radio buttons when asking the question",
- "type": "boolean"
- },
- "mappings": {
- "description": "Allows fixed-tag inputs, shown either as radiobuttons or as checkboxes",
- "type": "array",
- "items": {
- "$ref": "#/definitions/MappingConfigJson"
- }
- },
- "id": {
- "description": "The id of the tagrendering, should be an unique string.\nUsed to keep the translations in sync. Only used in the tagRenderings-array of a layerConfig, not requered otherwise.\n\nUse 'questions' to trigger the question box of this group (if a group is defined)",
- "type": "string"
- },
- "labels": {
- "description": "A list of labels. These are strings that are used for various purposes, e.g. to filter them away",
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "classes": {
- "description": "A list of css-classes to apply to the entire tagRendering if the answer is known (not applied on the question).\nThis is only for advanced users",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "description": {
- "description": "A human-readable text explaining what this tagRendering does",
+ "question": {
+ "description": "question: What question should be shown to the contributor?\n\nA question is presented ot the user if no mapping matches and the 'freeform' key is not set as well.\n\nifunset: This tagrendering will be shown if it is known, but cannot be edited by the contributor, effectively resutling in a read-only rendering",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -1449,8 +1425,26 @@ export default {
}
]
},
+ "questionHint": {
+ "description": "question: Should some extra information be shown to the contributor, alongside the question?\nThis hint is shown in subtle text under the question.\nThis can give some extra information on what the answer should ook like\nifunset: No extra hint is given",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "labels": {
+ "description": "A list of labels. These are strings that are used for various purposes, e.g. to only include a subset of the tagRenderings when reusing a layer",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
"render": {
- "description": "Renders this value. Note that \"{key}\"-parts are substituted by the corresponding values of the element.\nIf neither 'textFieldQuestion' nor 'mappings' are defined, this text is simply shown as default value.\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '{website}' or include images such as `This is of type A
`\ntype: rendered",
+ "description": "question: What text should be rendered?\n\nThis piece of text will be shown in the infobox.\nIn this text, values within braces (such as {braced(key)}) are replaced by the corresponding `value` in the object.\nFor example, if the object contains tags `amenity=school; name=Windy Hill School`, the render string `This school is named {name}` will be shown to the user as `This school is named Windy Hill School`\n\nThis text will be shown if:\n- there is no mapping which matches (or there are no matches)\n- no question, no mappings and no 'freeform' is set\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '<a href='{website}'>{website}</a>' or include images such as `This is of type A <br><img src='typeA-icon.svg' />`\ntype: rendered",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -1486,16 +1480,38 @@ export default {
}
]
},
- "condition": {
- "description": "Only show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "icon": {
+ "description": "question: what icon should be shown next to the 'render' value?\nAn icon shown next to the rendering; typically shown pretty small\nThis is only shown next to the \"render\" value\nType: icon",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "object",
+ "properties": {
+ "path": {
+ "description": "The path to the icon\nType: icon",
+ "type": "string"
+ },
+ "class": {
+ "description": "A hint to mapcomplete on how to render this icon within the mapping.\nThis is translated to 'mapping-icon-', so defining your own in combination with a custom CSS is possible (but discouraged)",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path"
+ ]
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "string"
+ }
+ ]
+ },
+ "condition": {
+ "description": "question: When should this item be shown?\n\nOnly show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
+ },
+ {
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -1503,20 +1519,33 @@ export default {
]
},
"metacondition": {
- "description": "If set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
+ "description": "question: When should this item be shown (including special conditions)?\n\nIf set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
}
]
+ },
+ "description": {
+ "description": "A human-readable text explaining what this tagRendering does.\nMostly used for the shared tagrenderings",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "classes": {
+ "description": "question: What css-classes should be applied to showing this attribute?\n\nA list of css-classes to apply to the entire tagRendering.\nThese classes are applied in 'answer'-mode, not in question mode\nThis is only for advanced users.\n\nValues are split on ` ` (space)",
+ "type": "string"
}
}
},
@@ -1595,15 +1624,13 @@ export default {
"properties": {
"question": {},
"osmTags": {
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation",
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -1650,6 +1677,10 @@ export default {
"DeleteConfigJson": {
"type": "object",
"properties": {
+ "neededChangesets": {
+ "description": "*\nBy default, the contributor needs 20 previous changesets to delete points edited by others.\nFor some small features (e.g. bicycle racks) this is too much and this requirement can be lowered or dropped, which can be done here.\n\ntype: nat\nquestion: How many changesets must a contributor have before being allowed to delete a point?",
+ "type": "number"
+ },
"extraDeleteReasons": {
"description": "*\nBy default, three reasons to delete a point are shown:\n\n- The point does not exist anymore\n- The point was a testing point\n- THe point could not be found\n\nHowever, for some layers, there might be different or more specific reasons for deletion which can be user friendly to set, e.g.:\n\n- the shop has closed\n- the climbing route has been closed of for nature conservation reasons\n- ...\n\nThese reasons can be stated here and will be shown in the list of options the user can choose from",
"type": "array",
@@ -1657,10 +1688,10 @@ export default {
"type": "object",
"properties": {
"explanation": {
- "description": "The text that will be shown to the user - translatable"
+ "description": "The text that will be shown to the user as option for why this point does not exist anymore.\nNote that the most common reasons (test point, does not exist anymore, cannot be found) are already offered by default\n\nquestion: For what extra reason might this feature be removed in real-life?"
},
"changesetMessage": {
- "description": "The text that will be uploaded into the changeset or will be used in the fixme in case of a soft deletion\nShould be a few words, in english",
+ "description": "The text that will be uploaded into the changeset or will be used in the fixme in case of a soft deletion\nShould be a few words, in english\n\nquestion: What should be added to the changeset as delete reason?",
"type": "string"
}
},
@@ -1678,10 +1709,10 @@ export default {
"properties": {
"if": {
"$ref": "#/definitions/TagConfigJson",
- "description": "The tags that will be given to the object.\nThis must remove tags so that the 'source/osmTags' won't match anymore"
+ "description": "The tags that will be given to the object.\nThis must remove tags so that the 'source/osmTags' won't match anymore\n\nquestion: What tags should be applied to the object?"
},
"then": {
- "description": "The human explanation for the options"
+ "description": "The human explanation for the options\n\nquestion: What text should be shown to the contributor for this reason?"
}
},
"required": [
@@ -1691,27 +1722,21 @@ export default {
}
},
"softDeletionTags": {
- "description": "In some cases, the contributor is not allowed to delete the current feature (e.g. because it isn't a point, the point is referenced by a relation or the user isn't experienced enough).\nTo still offer the user a 'delete'-option, the feature is retagged with these tags. This is a soft deletion, as the point isn't actually removed from OSM but rather marked as 'disused'\nIt is important that the feature will be retagged in such a way that it won't be picked up by the layer anymore!\n\nExample (note that \"amenity=\" erases the 'amenity'-key alltogether):\n```\n{\n \"and\": [\"disussed:amenity=public_bookcase\", \"amenity=\"]\n}\n```\n\nor (notice the use of the ':='-tag to copy the old value of 'shop=*' into 'disused:shop='):\n```\n{\n \"and\": [\"disused:shop:={shop}\", \"shop=\"]\n}\n```",
+ "description": "In some cases, the contributor is not allowed to delete the current feature (e.g. because it isn't a point, the point is referenced by a relation or the user isn't experienced enough).\nTo still offer the user a 'delete'-option, the feature is retagged with these tags. This is a soft deletion, as the point isn't actually removed from OSM but rather marked as 'disused'\nIt is important that the feature will be retagged in such a way that it won't be picked up by the layer anymore!\n\nExample (note that \"amenity=\" erases the 'amenity'-key alltogether):\n\n```\n{\n \"and\": [\"disussed:amenity=public_bookcase\", \"amenity=\"]\n}\n```\n\nor (notice the use of the ':='-tag to copy the old value of 'shop=*' into 'disused:shop='):\n\n```\n{\n \"and\": [\"disused:shop:={shop}\", \"shop=\"]\n}\n```\n\nquestion: If a hard delete is not possible, what tags should be applied to mark this feature as deleted?\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
}
]
},
- "neededChangesets": {
- "description": "*\nBy default, the contributor needs 20 previous changesets to delete points edited by others.\nFor some small features (e.g. bicycle racks) this is too much and this requirement can be lowered or dropped, which can be done here.",
- "type": "number"
- },
"omitDefaultDeleteReasons": {
- "description": "Set this flag if the default delete reasons should be omitted from the dialog.\nThis requires at least one extraDeleteReason or nonDeleteMapping",
+ "description": "Set this flag if the default delete reasons should be omitted from the dialog.\nThis requires at least one extraDeleteReason or nonDeleteMapping\n\nquestion: Should the default delete reasons be hidden?\niftrue: Hide the default delete reasons\niffalse: Show the default delete reasons\nifunset: Show the default delete reasons (default behaviour)",
"type": "boolean"
}
}
@@ -1720,11 +1745,11 @@ export default {
"type": "object",
"properties": {
"enableImproveAccuracy": {
- "description": "One default reason to move a point is to improve accuracy.\nSet to false to disable this reason",
+ "description": "question: Should moving this type of point to improve the accuracy be allowed?\niftrue: This point can be moved to improve the accuracy\nifunset: (default) This point can be moved to improve the accuracy\niffalse: This point cannot be moved to improve the accuracy",
"type": "boolean"
},
"enableRelocation": {
- "description": "One default reason to move a point is because it has relocated\nSet to false to disable this reason",
+ "description": "question: Should moving this type of point due to a relocation be allowed?\n\nThis will erase the attributes `addr:street`, `addr:housenumber`, `addr:city` and `addr:postcode`\n\niftrue: This type of point can be moved due to a relocation (and will remove address information when this is done)\nifunset: (default) This type of point can be moved due to a relocation (and will remove address information when this is done)\niffalse: This type of point cannot be moved due to a relocation",
"type": "boolean"
}
}
@@ -1734,7 +1759,7 @@ export default {
"type": "object",
"properties": {
"appliesToKey": {
- "description": "Every key from this list will be normalized.\n\nTo render a united value properly, use",
+ "description": "Every key from this list will be normalized.\n\nTo render the value properly (with a human readable denomination), use `{canonical()}`",
"type": "array",
"items": {
"type": "string"
diff --git a/Docs/Schemas/LayoutConfigJson.schema.json b/Docs/Schemas/LayoutConfigJson.schema.json
index dc188a78b2..5932671e80 100644
--- a/Docs/Schemas/LayoutConfigJson.schema.json
+++ b/Docs/Schemas/LayoutConfigJson.schema.json
@@ -3,12 +3,22 @@
"type": "object",
"properties": {
"id": {
- "description": "The id of this layout.\n\nThis is used as hashtag in the changeset message, which will read something like \"Adding data with #mapcomplete for theme #\"\nMake sure it is something decent and descriptive, it should be a simple, lowercase string.\n\nOn official themes, it'll become the name of the page, e.g.\n'cyclestreets' which become 'cyclestreets.html'",
+ "description": "question: What is the id of this layout?\n\nThe id is a unique string to identify the theme\n\nIt should be\n- in english\n- describe the theme in a single word (or a few words)\n- all lowercase and with only [a-z] or underscores (_)\n\nThis is used as hashtag in the changeset message, which will read something like \"Adding data with #mapcomplete for theme #\"\n\nOn official themes, it'll become the name of the page, e.g.\n'cyclestreets' which become 'cyclestreets.html'\n\ntype: id\ngroup: basic",
"type": "string"
},
"credits": {
"description": "Who helped to create this theme and should be attributed?",
- "type": "string"
+ "anyOf": [
+ {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ {
+ "type": "string"
+ }
+ ]
},
"mustHaveLanguage": {
"description": "Only used in 'generateLayerOverview': if present, every translation will be checked to make sure it is fully translated.\n\nThis must be a list of two-letter, lowercase codes which identifies the language, e.g. \"en\", \"nl\", ...",
@@ -18,7 +28,7 @@
}
},
"title": {
- "description": "The title, as shown in the welcome message and the more-screen.",
+ "description": "question: What is the title of this theme?\n\nThe human-readable title, as shown in the welcome message and the index page\ngroup: basic",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -29,7 +39,7 @@
]
},
"shortDescription": {
- "description": "A short description, showed as social description and in the 'more theme'-buttons.\nNote that if this one is not defined, the first sentence of 'description' is used",
+ "description": "A short description, showed as social description and in the 'more theme'-buttons.\nNote that if this one is not defined, the first sentence of 'description' is used\ngroup: hidden",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -40,7 +50,7 @@
]
},
"description": {
- "description": "The description, as shown in the welcome message and the more-screen",
+ "description": "question: How would you describe this theme?\nThe description, as shown in the welcome message and the more-screen\ngroup: basic",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -51,7 +61,7 @@
]
},
"descriptionTail": {
- "description": "A part of the description, shown under the login-button.",
+ "description": "A part of the description, shown under the login-button.\ngroup: hidden",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -62,21 +72,23 @@
]
},
"icon": {
- "description": "The icon representing this theme.\nUsed as logo in the more-screen and (for official themes) as favicon, webmanifest logo, ...\nEither a URL or a base64 encoded value (which should include 'data:image/svg+xml;base64)\n\nType: icon",
+ "description": "question: What icon should be used to represent this theme?\n\nUsed as logo in the more-screen and (for official themes) as favicon, webmanifest logo, ...\n\nEither a URL or a base64 encoded value (which should include 'data:image/svg+xml;base64)\n\nType: icon\ngroup: basic",
"type": "string"
},
"socialImage": {
- "description": "Link to a 'social image' which is included as og:image-tag on official themes.\nUseful to share the theme on social media.\nSee https://www.h3xed.com/web-and-internet/how-to-use-og-image-meta-tag-facebook-reddit for more information$\n\nType: image",
+ "description": "question: What image should be used as social image preview?\nThis is included as og:image-tag on official themes.\n\nSee https://www.h3xed.com/web-and-internet/how-to-use-og-image-meta-tag-facebook-reddit for more information\nifunset: use the default social image of mapcomplete (or generate one based on the icon)\nType: image\ngroup: basic",
"type": "string"
},
"startZoom": {
- "description": "Default location and zoom to start.\nNote that this is barely used. Once the user has visited mapcomplete at least once, the previous location of the user will be used",
+ "description": "question: At what zoomlevel should this theme open?\nDefault location and zoom to start.\nNote that this is barely used. Once the user has visited mapcomplete at least once, the previous location of the user will be used\nifunset: Use the default startzoom (0)\ntype: float\ngroup: start_location",
"type": "number"
},
"startLat": {
+ "description": "question: At what start latitude should this theme open?\nDefault location and zoom to start.\nNote that this is barely used. Once the user has visited mapcomplete at least once, the previous location of the user will be used\nifunset: Use 0 as start latitude\ntype: float\ngroup: start_location",
"type": "number"
},
"startLon": {
+ "description": "question: At what start longitude should this theme open?\nDefault location and zoom to start.\nNote that this is barely used. Once the user has visited mapcomplete at least once, the previous location of the user will be used\nifunset: Use 0 as start longitude\ntype: float\ngroup: start_location",
"type": "number"
},
"widenFactor": {
@@ -119,7 +131,7 @@
}
},
"layers": {
- "description": "The layers to display.\n\nEvery layer contains a description of which feature to display - the overpassTags which are queried.\nInstead of running one query for every layer, the query is fused.\n\nAfterwards, every layer is given the list of features.\nEvery layer takes away the features that match with them*, and give the leftovers to the next layers.\n\nThis implies that the _order_ of the layers is important in the case of features with the same tags;\nas the later layers might never receive their feature.\n\n*layers can also remove 'leftover'-features if the leftovers overlap with a feature in the layer itself\n\nNote that builtin layers can be reused. Either put in the name of the layer to reuse, or use {builtin: \"layername\", override: ...}\n\nThe 'override'-object will be copied over the original values of the layer, which allows to change certain aspects of the layer\n\nFor example: If you would like to use layer nature reserves, but only from a specific operator (eg. Natuurpunt) you would use the following in your theme:\n\n```\n\"layer\": {\n \"builtin\": \"nature_reserve\",\n \"override\": {\"source\":\n {\"osmTags\": {\n \"+and\":[\"operator=Natuurpunt\"]\n }\n }\n }\n}\n```\n\nIt's also possible to load multiple layers at once, for example, if you would like for both drinking water and benches to start at the zoomlevel at 12, you would use the following:\n\n```\n\"layer\": {\n \"builtin\": [\"benches\", \"drinking_water\"],\n \"override\": {\"minzoom\": 12}\n}\n```",
+ "description": "question: What layers should this map show?\ntype: layer[]\ntypes: hidden | layer | hidden\ngroup: layers\nsuggestions: return Array.from(layers.keys()).map(key => ({if: \"value=\"+key, then: key+\" - \"+layers.get(key).description}))\nEvery layer contains a description of which feature to display - the overpassTags which are queried.\nInstead of running one query for every layer, the query is fused.\n\nAfterwards, every layer is given the list of features.\nEvery layer takes away the features that match with them*, and give the leftovers to the next layers.\n\nThis implies that the _order_ of the layers is important in the case of features with the same tags;\nas the later layers might never receive their feature.\n\n*layers can also remove 'leftover'-features if the leftovers overlap with a feature in the layer itself\n\nNote that builtin layers can be reused. Either put in the name of the layer to reuse, or use {builtin: \"layername\", override: ...}\n\nThe 'override'-object will be copied over the original values of the layer, which allows to change certain aspects of the layer\n\nFor example: If you would like to use layer nature reserves, but only from a specific operator (eg. Natuurpunt) you would use the following in your theme:\n\n```\n\"layer\": {\n \"builtin\": \"nature_reserve\",\n \"override\": {\"source\":\n {\"osmTags\": {\n \"+and\":[\"operator=Natuurpunt\"]\n }\n }\n }\n}\n```\n\nIt's also possible to load multiple layers at once, for example, if you would like for both drinking water and benches to start at the zoomlevel at 12, you would use the following:\n\n```\n\"layer\": {\n \"builtin\": [\"benches\", \"drinking_water\"],\n \"override\": {\"minzoom\": 12}\n}\n```",
"type": "array",
"items": {
"anyOf": [
@@ -165,7 +177,7 @@
}
},
"customCss": {
- "description": "The URL of a custom CSS stylesheet to modify the layout",
+ "description": "The URL of a custom CSS stylesheet to modify the layout\ngroup: advanced",
"type": "string"
},
"hideFromOverview": {
@@ -220,77 +232,70 @@
]
},
"extraLink": {
- "description": "Adds an additional button on the top-left of the application.\nThis can link to an arbitrary location.\n\nNote that {lat},{lon},{zoom}, {language} and {theme} will be replaced\n\nDefault: {icon: \"./assets/svg/pop-out.svg\", href: 'https://mapcomplete.org/{theme}.html?lat={lat}&lon={lon}&z={zoom}, requirements: [\"iframe\",\"no-welcome-message]},",
+ "description": "question: should an extra help button be shown in certain circumstances?\nAdds an additional button on the top-left of the application.\nThis can link to an arbitrary location.\n\nFor example {icon: \"./assets/svg/pop-out.svg\", href: 'https://mapcomplete.org/{theme}.html?lat={lat}&lon={lon}&z={zoom}, requirements: [\"iframe\",\"no-welcome-message]},\n\ngroup: advanced\nifunset: show a link to open MapComplete full screen if used in an iframe",
"$ref": "#/definitions/default"
},
"enableUserBadge": {
- "description": "If set to false, disables logging in.\nThe userbadge will be hidden, all login-buttons will be hidden and editing will be disabled",
+ "description": "question: Should a user be able to login with OpenStreetMap?\n\nIf not logged in, will not show the login buttons and hide all the editable elements.\nAs such, MapComplete will become read-only and a purely visualisation tool.\n\nifunset: Enable the possiblity to login with OpenStreetMap (default)\niffalse: Do not enable to login with OpenStreetMap, have a read-only view of MapComplete.\niftrue: Enable the possiblity to login with OpenStreetMap\ngroup: feature_switches",
"type": "boolean"
},
"enableShareScreen": {
- "description": "If false, hides the tab 'share'-tab in the welcomeMessage",
+ "description": "question: Should the tab with options to share the current screen be enabled?\n\nOn can get the iFrame embed code here\n\nifunset: Enable the sharescreen (default)\niffalse: Do not enable the share screen\niftrue: Enable the share screen\ngroup: feature_switches",
"type": "boolean"
},
"enableMoreQuests": {
- "description": "Hides the tab with more themes in the welcomeMessage",
+ "description": "question: Should the user be able to switch to different themes?\n\nTypically enabled in iframes and/or on commisioned themes\n\niftrue: enable to go back to the index page showing all themes\niffalse: do not enable to go back to the index page showing all themes; hide the 'more themes' buttons\nifunset: mapcomplete default: enable to go back to the index page showing all themes\ngroup: feature_switches",
"type": "boolean"
},
"enableLayers": {
- "description": "If false, the layer selection/filter view will be hidden\nThe corresponding URL-parameter is 'fs-filters' instead of 'fs-layers'",
+ "description": "question: Should the user be able to enable/disable layers and to filter the layers?\n\nThe corresponding URL-parameter is 'fs-filters' instead of 'fs-layers'\niftrue: enable the filters/layers pane\niffalse: do not enable to filter or to disable layers; hide the 'filter' tab from the overview and the button at the bottom-left\nifunset: mapcomplete default: enable to filter or to enable/disable layers\ngroup: feature_switches",
"type": "boolean"
},
"enableSearch": {
- "description": "If set to false, hides the search bar",
+ "description": "question: Should the user be able to search for locations?\n\nifunset: MapComplete default: allow to search\niftrue: Allow to search\niffalse: Do not allow to search; hide the search-bar\ngroup: feature_switches",
"type": "boolean"
},
"enableAddNewPoints": {
- "description": "If set to false, the ability to add new points or nodes will be disabled.\nEditing already existing features will still be possible",
+ "description": "question: Should the user be able to add new points?\n\nAdding new points is only possible if the loaded layers have presets set.\nSome layers do not have presets. If the theme only has layers without presets, then adding new points will not be possible.\n\nifunset: MapComplete default: allow to create new points\niftrue: Allow to create new points\niffalse: Do not allow to create new points, even if the layers in this theme support creating new points\ngroup: feature_switches",
"type": "boolean"
},
"enableGeolocation": {
- "description": "If set to false, the 'geolocation'-button will be hidden.",
+ "description": "question: Should the user be able to use their GPS to geolocate themselfes on the map?\nifunset: MapComplete default: allow to use the GPS\niftrue: Allow to use the GPS\niffalse: Do not allow to use the GPS, hide the geolocation-buttons\ngroup: feature_switches",
"type": "boolean"
},
"enableBackgroundLayerSelection": {
- "description": "Enable switching the backgroundlayer.\nIf false, the quickswitch-buttons are removed (bottom left) and the dropdown in the layer selection is removed as well",
+ "description": "Enable switching the backgroundlayer.\nIf false, the quickswitch-buttons are removed (bottom left) and the dropdown in the layer selection is removed as well\n\nquestion: Should the user be able to switch the background layer?\n\niftrue: Allow to switch the background layer\niffalse: Do not allow to switch the background layer\nifunset: MapComplete default: Allow to switch the background layer\ngroup: feature_switches",
"type": "boolean"
},
"enableShowAllQuestions": {
- "description": "If set to true, will show _all_ unanswered questions in a popup instead of just the next one",
+ "description": "question: Should the questions about a feature be presented one by one or all at once?\niftrue: Show all unanswered questions at the same time\niffalse: Show unanswered questions one by one\nifunset: MapComplete default: Use the preference of the user to show questions at the same time or one by one\ngroup: feature_switches",
"type": "boolean"
},
"enableDownload": {
- "description": "If set to true, download button for the data will be shown (offers downloading as geojson and csv)",
+ "description": "question: Should the 'download as CSV'- and 'download as Geojson'-buttons be enabled?\niftrue: Enable the option to download the map as CSV and GeoJson\niffalse: Enable the option to download the map as CSV and GeoJson\nifunset: MapComplete default: Enable the option to download the map as CSV and GeoJson\ngroup: feature_switches",
"type": "boolean"
},
"enablePdfDownload": {
- "description": "If set to true, exporting a pdf is enabled",
+ "description": "question: Should the 'download as PDF'-button be enabled?\niftrue: Enable the option to download the map as PDF\niffalse: Enable the option to download the map as PDF\nifunset: MapComplete default: Enable the option to download the map as PDF\ngroup: feature_switches",
"type": "boolean"
},
"enableNoteImports": {
- "description": "If true, notes will be loaded and parsed. If a note is an import (as created by the import_helper.html-tool from mapcomplete),\nthese notes will be shown if a relevant layer is present.\n\nDefault is true for official layers and false for unofficial (sideloaded) layers",
+ "description": "question: Should the 'notes' from OpenStreetMap be loaded and parsed for import helper notes?\nIf true, notes will be loaded and parsed. If a note is an import (as created by the import_helper.html-tool from mapcomplete),\nthese notes will be shown if a relevant layer is present.\n\nifunset: MapComplete default: do not load import notes for sideloaded themes but do load them for official themes\niftrue: Load notes and show import notes\niffalse: Do not load import notes\ngroup: advanced",
"type": "boolean"
},
"overpassUrl": {
- "description": "Set one or more overpass URLs to use for this theme..",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
+ "description": "question: What overpass-api instance should be used for this layout?\n\nifunset: Use the default, builtin collection of overpass instances\ngroup: advanced",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
},
"overpassTimeout": {
- "description": "Set a different timeout for overpass queries - in seconds. Default: 30s",
+ "description": "question: After how much seconds should the overpass-query stop?\nIf a query takes too long, the overpass-server will abort.\nOnce can set the amount of time before overpass gives up here.\nifunset: use the default amount of 30 seconds as timeout\ntype: pnat\ngroup: advanced",
"type": "number"
},
"enableNodeDatabase": {
- "description": "Enables tracking of all nodes when data is loaded.\nThis is useful for the 'ImportWay' and 'ConflateWay'-buttons who need this database.\n\nNote: this flag will be automatically set.",
+ "description": "Enables tracking of all nodes when data is loaded.\nThis is useful for the 'ImportWay' and 'ConflateWay'-buttons who need this database.\n\nNote: this flag will be automatically set and can thus be ignored.\ngroup: hidden",
"type": "boolean"
}
},
@@ -306,13 +311,12 @@
],
"definitions": {
"TagConfigJson": {
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation",
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
"type": "object",
"properties": {
"or": {
@@ -331,8 +335,7 @@
}
]
},
- "AndTagConfigJson": {
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{and:TagConfigJson[];}": {
"type": "object",
"properties": {
"and": {
@@ -347,8 +350,7 @@
],
"additionalProperties": false
},
- "OrTagConfigJson": {
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{or:TagConfigJson[];}": {
"type": "object",
"properties": {
"or": {
@@ -435,48 +437,101 @@
],
"additionalProperties": false
},
+ "MinimalTagRenderingConfigJson": {
+ "description": "Mostly used for lineRendering and pointRendering",
+ "type": "object",
+ "properties": {
+ "render": {
+ "description": "question: What value should be rendered?\n\nThis piece of text will be shown in the infobox.\nNote that \"&LBRACEkey&RBRACE\"-parts are substituted by the corresponding values of the element.\n\nThis value will be used if there is no mapping which matches (or there are no matches)\nNote that this is a HTML-interpreted value, so you can add links as e.g. '<a href='{website}'>{website}</a>' or include images such as `This is of type A <br><img src='typeA-icon.svg' />`",
+ "type": "string"
+ },
+ "mappings": {
+ "description": "Allows fixed-tag inputs, shown either as radiobuttons or as checkboxes",
+ "type": "array",
+ "items": {
+ "type": "object",
+ "properties": {
+ "if": {
+ "$ref": "#/definitions/TagConfigJson",
+ "description": "question: When should this single mapping match?\n\nIf this condition is met, then the text under `then` will be shown.\nIf no value matches, and the user selects this mapping as an option, then these tags will be uploaded to OSM.\n\nFor example: {'if': 'diet:vegetarion=yes', 'then':'A vegetarian option is offered here'}\n\nThis can be an substituting-tag as well, e.g. {'if': 'addr:street:={_calculated_nearby_streetname}', 'then': '{_calculated_nearby_streetname}'}"
+ },
+ "then": {
+ "description": "question: What text should be shown?\n\nIf the condition `if` is met, the text `then` will be rendered.\nIf not known yet, the user will be presented with `then` as an option",
+ "type": "string"
+ }
+ },
+ "required": [
+ "if",
+ "then"
+ ]
+ }
+ }
+ },
+ "additionalProperties": false
+ },
+ "IconConfigJson": {
+ "type": "object",
+ "properties": {
+ "icon": {
+ "description": "question: What icon should be used?\ntype: icon\nsuggestions: return [\"pin\",\"square\",\"circle\",\"checkmark\",\"clock\",\"close\",\"crosshair\",\"help\",\"home\",\"invalid\",\"location\",\"location_empty\",\"location_locked\",\"note\",\"resolved\",\"ring\",\"scissors\",\"teardrop\",\"teardrop_with_hole_green\",\"triangle\"].map(i => ({if: \"value=\"+i, then: i, icon: i}))",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
+ },
+ {
+ "type": "object",
+ "properties": {
+ "builtin": {
+ "type": "string"
+ },
+ "override": {}
+ },
+ "required": [
+ "builtin",
+ "override"
+ ]
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "color": {
+ "description": "question: What colour should the icon be?\nThis will only work for the default icons such as `pin`,`circle`,...\ntype: color",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
+ },
+ {
+ "type": "object",
+ "properties": {
+ "builtin": {
+ "type": "string"
+ },
+ "override": {}
+ },
+ "required": [
+ "builtin",
+ "override"
+ ]
+ },
+ {
+ "type": "string"
+ }
+ ]
+ }
+ },
+ "required": [
+ "icon"
+ ],
+ "additionalProperties": false
+ },
"TagRenderingConfigJson": {
"description": "A TagRenderingConfigJson is a single piece of code which converts one ore more tags into a HTML-snippet.\nFor an _editable_ tagRendering, use 'QuestionableTagRenderingConfigJson' instead, which extends this one",
"type": "object",
"properties": {
- "id": {
- "description": "The id of the tagrendering, should be an unique string.\nUsed to keep the translations in sync. Only used in the tagRenderings-array of a layerConfig, not requered otherwise.\n\nUse 'questions' to trigger the question box of this group (if a group is defined)",
- "type": "string"
- },
- "labels": {
- "description": "A list of labels. These are strings that are used for various purposes, e.g. to filter them away",
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "classes": {
- "description": "A list of css-classes to apply to the entire tagRendering if the answer is known (not applied on the question).\nThis is only for advanced users",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "description": {
- "description": "A human-readable text explaining what this tagRendering does",
- "anyOf": [
- {
- "$ref": "#/definitions/Record"
- },
- {
- "type": "string"
- }
- ]
- },
"render": {
- "description": "Renders this value. Note that \"{key}\"-parts are substituted by the corresponding values of the element.\nIf neither 'textFieldQuestion' nor 'mappings' are defined, this text is simply shown as default value.\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '{website}' or include images such as `This is of type A
`\ntype: rendered",
+ "description": "question: What text should be rendered?\n\nThis piece of text will be shown in the infobox.\nIn this text, values within braces (such as {braced(key)}) are replaced by the corresponding `value` in the object.\nFor example, if the object contains tags `amenity=school; name=Windy Hill School`, the render string `This school is named {name}` will be shown to the user as `This school is named Windy Hill School`\n\nThis text will be shown if:\n- there is no mapping which matches (or there are no matches)\n- no question, no mappings and no 'freeform' is set\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '<a href='{website}'>{website}</a>' or include images such as `This is of type A <br><img src='typeA-icon.svg' />`\ntype: rendered",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -512,16 +567,38 @@
}
]
},
- "condition": {
- "description": "Only show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "icon": {
+ "description": "question: what icon should be shown next to the 'render' value?\nAn icon shown next to the rendering; typically shown pretty small\nThis is only shown next to the \"render\" value\nType: icon",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "object",
+ "properties": {
+ "path": {
+ "description": "The path to the icon\nType: icon",
+ "type": "string"
+ },
+ "class": {
+ "description": "A hint to mapcomplete on how to render this icon within the mapping.\nThis is translated to 'mapping-icon-', so defining your own in combination with a custom CSS is possible (but discouraged)",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path"
+ ]
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "string"
+ }
+ ]
+ },
+ "condition": {
+ "description": "question: When should this item be shown?\n\nOnly show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
+ },
+ {
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -529,15 +606,13 @@
]
},
"metacondition": {
- "description": "If set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
+ "description": "question: When should this item be shown (including special conditions)?\n\nIf set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -545,11 +620,11 @@
]
},
"freeform": {
- "description": "Allow freeform text input from the user",
+ "description": "question: Should a freeform text field be shown?\nAllow freeform text input from the user\nifunset: Do not add a freeform text field",
"type": "object",
"properties": {
"key": {
- "description": "If this key is present, then 'render' is used to display the value.\nIf this is undefined, the rendering is _always_ shown",
+ "description": "What attribute should be filled out\nIf this key is present in the feature, then 'render' is used to display the value.\nIf this is undefined, the rendering is _always_ shown",
"type": "string"
}
},
@@ -565,10 +640,10 @@
"properties": {
"if": {
"$ref": "#/definitions/TagConfigJson",
- "description": "If this condition is met, then the text under `then` will be shown.\nIf no value matches, and the user selects this mapping as an option, then these tags will be uploaded to OSM.\n\nFor example: {'if': 'diet:vegetarion=yes', 'then':'A vegetarian option is offered here'}\n\nThis can be an substituting-tag as well, e.g. {'if': 'addr:street:={_calculated_nearby_streetname}', 'then': '{_calculated_nearby_streetname}'}"
+ "description": "question: When should this single mapping match?\n\nIf this condition is met, then the text under `then` will be shown.\nIf no value matches, and the user selects this mapping as an option, then these tags will be uploaded to OSM.\n\nFor example: {'if': 'diet:vegetarion=yes', 'then':'A vegetarian option is offered here'}\n\nThis can be an substituting-tag as well, e.g. {'if': 'addr:street:={_calculated_nearby_streetname}', 'then': '{_calculated_nearby_streetname}'}"
},
"then": {
- "description": "If the condition `if` is met, the text `then` will be rendered.\nIf not known yet, the user will be presented with `then` as an option\nType: rendered",
+ "description": "question: What text should be shown?\n\nIf the condition `if` is met, the text `then` will be rendered.\nIf not known yet, the user will be presented with `then` as an option\nType: rendered",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -579,7 +654,7 @@
]
},
"icon": {
- "description": "An icon supporting this mapping; typically shown pretty small\nType: icon",
+ "description": "question: What icon should be added to this mapping?\nAn icon supporting this mapping; typically shown pretty small\ninline:
{icon}\nType: icon",
"anyOf": [
{
"type": "object",
@@ -608,6 +683,21 @@
"then"
]
}
+ },
+ "description": {
+ "description": "A human-readable text explaining what this tagRendering does.\nMostly used for the shared tagrenderings",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "classes": {
+ "description": "question: What css-classes should be applied to showing this attribute?\n\nA list of css-classes to apply to the entire tagRendering.\nThese classes are applied in 'answer'-mode, not in question mode\nThis is only for advanced users.\n\nValues are split on ` ` (space)",
+ "type": "string"
}
},
"additionalProperties": false
@@ -621,13 +711,21 @@
"properties": {
"if": {
"$ref": "#/definitions/TagConfigJson",
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation"
+ "description": "question: What tags should be matched to show this option?\n\nIf in 'question'-mode and the contributor selects this option, these tags will be applied to the object"
},
"then": {
- "description": "Shown if the 'if is fulfilled\nType: rendered"
+ "description": "Question: What corresponding text should be shown?\nShown if the `if` is fulfilled\nType: rendered",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
},
"icon": {
- "description": "An extra icon supporting the choice\nType: icon",
+ "description": "question: What icon should be shown next to this mapping?\n\nThis icon will only be shown if the value is known, it is not displayed in the options (but might be in the future)\n\nifunset: Show no icon\nType: icon",
"anyOf": [
{
"type": "object",
@@ -651,15 +749,13 @@
]
},
"hideInAnswer": {
- "description": "In some cases, multiple taggings exist (e.g. a default assumption, or a commonly mapped abbreviation and a fully written variation).\n\nIn the latter case, a correct text should be shown, but only a single, canonical tagging should be selectable by the user.\nIn this case, one of the mappings can be hiden by setting this flag.\n\nTo demonstrate an example making a default assumption:\n\nmappings: [\n {\n if: \"access=\", -- no access tag present, we assume accessible\n then: \"Accessible to the general public\",\n hideInAnswer: true\n },\n {\n if: \"access=yes\",\n then: \"Accessible to the general public\", -- the user selected this, we add that to OSM\n },\n {\n if: \"access=no\",\n then: \"Not accessible to the public\"\n }\n]\n\n\nFor example, for an operator, we have `operator=Agentschap Natuur en Bos`, which is often abbreviated to `operator=ANB`.\nThen, we would add two mappings:\n{\n if: \"operator=Agentschap Natuur en Bos\" -- the non-abbreviated version which should be uploaded\n then: \"Maintained by Agentschap Natuur en Bos\"\n},\n{\n if: \"operator=ANB\", -- we don't want to upload abbreviations\n then: \"Maintained by Agentschap Natuur en Bos\"\n hideInAnswer: true\n}\n\nHide in answer can also be a tagsfilter, e.g. to make sure an option is only shown when appropriate.\nKeep in mind that this is reverse logic: it will be hidden in the answer if the condition is true, it will thus only show in the case of a mismatch\n\ne.g., for toilets: if \"wheelchair=no\", we know there is no wheelchair dedicated room.\nFor the location of the changing table, the option \"in the wheelchair accessible toilet is weird\", so we write:\n\n{\n \"question\": \"Where is the changing table located?\"\n \"mappings\": [\n {\"if\":\"changing_table:location=female\",\"then\":\"In the female restroom\"},\n {\"if\":\"changing_table:location=male\",\"then\":\"In the male restroom\"},\n {\"if\":\"changing_table:location=wheelchair\",\"then\":\"In the wheelchair accessible restroom\", \"hideInAnswer\": \"wheelchair=no\"},\n\n ]\n}\n\nAlso have a look for the meta-tags\n{\n if: \"operator=Agentschap Natuur en Bos\",\n then: \"Maintained by Agentschap Natuur en Bos\",\n hideInAnswer: \"_country!=be\"\n}",
+ "description": "question: Under what circumstances should this mapping be hidden from the possibilities a contributor can pick?\niftrue: Never show this mapping as option to pick\nifunset: Always show this mapping as option to pick\ntype: tag\n\nIn some cases, multiple taggings exist (e.g. a default assumption, or a commonly mapped abbreviation and a fully written variation).\n\nIn the latter case, a correct text should be shown, but only a single, canonical tagging should be selectable by the user.\nIn this case, one of the mappings can be hiden by setting this flag.\n\nTo demonstrate an example making a default assumption:\n\nmappings: [\n {\n if: \"access=\", -- no access tag present, we assume accessible\n then: \"Accessible to the general public\",\n hideInAnswer: true\n },\n {\n if: \"access=yes\",\n then: \"Accessible to the general public\", -- the user selected this, we add that to OSM\n },\n {\n if: \"access=no\",\n then: \"Not accessible to the public\"\n }\n]\n\n\nFor example, for an operator, we have `operator=Agentschap Natuur en Bos`, which is often abbreviated to `operator=ANB`.\nThen, we would add two mappings:\n{\n if: \"operator=Agentschap Natuur en Bos\" -- the non-abbreviated version which should be uploaded\n then: \"Maintained by Agentschap Natuur en Bos\"\n},\n{\n if: \"operator=ANB\", -- we don't want to upload abbreviations\n then: \"Maintained by Agentschap Natuur en Bos\"\n hideInAnswer: true\n}\n\nHide in answer can also be a tagsfilter, e.g. to make sure an option is only shown when appropriate.\nKeep in mind that this is reverse logic: it will be hidden in the answer if the condition is true, it will thus only show in the case of a mismatch\n\ne.g., for toilets: if \"wheelchair=no\", we know there is no wheelchair dedicated room.\nFor the location of the changing table, the option \"in the wheelchair accessible toilet is weird\", so we write:\n\n{\n \"question\": \"Where is the changing table located?\"\n \"mappings\": [\n {\"if\":\"changing_table:location=female\",\"then\":\"In the female restroom\"},\n {\"if\":\"changing_table:location=male\",\"then\":\"In the male restroom\"},\n {\"if\":\"changing_table:location=wheelchair\",\"then\":\"In the wheelchair accessible restroom\", \"hideInAnswer\": \"wheelchair=no\"},\n\n ]\n}\n\nAlso have a look for the meta-tags\n{\n if: \"operator=Agentschap Natuur en Bos\",\n then: \"Maintained by Agentschap Natuur en Bos\",\n hideInAnswer: \"_country!=be\"\n}",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": [
@@ -670,15 +766,13 @@
]
},
"ifnot": {
- "description": "Only applicable if 'multiAnswer' is set.\nThis is for situations such as:\n`accepts:coins=no` where one can select all the possible payment methods. However, we want to make explicit that some options _were not_ selected.\nThis can be done with `ifnot`\nNote that we can not explicitly render this negative case to the user, we cannot show `does _not_ accept coins`.\nIf this is important to your usecase, consider using multiple radiobutton-fields without `multiAnswer`",
+ "description": "question: What tags should be applied if this mapping is _not_ chosen?\n\nOnly applicable if 'multiAnswer' is set.\nThis is for situations such as:\n`accepts:coins=no` where one can select all the possible payment methods. However, we want to make explicit that some options _were not_ selected.\nThis can be done with `ifnot`\nNote that we can not explicitly render this negative case to the user, we cannot show `does _not_ accept coins`.\nIf this is important to your usecase, consider using multiple radiobutton-fields without `multiAnswer`",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -686,26 +780,24 @@
]
},
"addExtraTags": {
- "description": "If chosen as answer, these tags will be applied as well onto the object.\nNot compatible with multiAnswer.\n\nThis can be used e.g. to erase other keys which indicate the 'not' value:\n```json\n{\n \"if\": \"crossing:marking=rainbow\",\n \"then\": \"This is a rainbow crossing\",\n \"addExtraTags\": \"not:crossing:marking=\"\n}\n```",
+ "description": "question: What extra tags should be added to the object if this object is chosen?\ntype: simple_tag[]\n\nIf chosen as answer, these tags will be applied onto the object, together with the tags from the `if`\nNot compatible with multiAnswer.\n\nThis can be used e.g. to erase other keys which indicate the 'not' value:\n```json\n{\n \"if\": \"crossing:marking=rainbow\",\n \"then\": \"This is a rainbow crossing\",\n \"addExtraTags\": [\"not:crossing:marking=\"]\n}\n```",
"type": "array",
"items": {
"type": "string"
}
},
"searchTerms": {
- "description": "If there are many options, the mappings-radiobuttons will be replaced by an element with a searchfunction\n\nSearchterms (per language) allow to easily find an option if there are many options",
+ "description": "question: If there are many options, what search terms match too?\nIf there are many options, the mappings-radiobuttons will be replaced by an element with a searchfunction\n\nSearchterms (per language) allow to easily find an option if there are many options\ngroup: hidden",
"$ref": "#/definitions/Record"
},
"priorityIf": {
- "description": "If the searchable selector is picked, mappings with this item will have priority and show up even if the others are hidden\nUse this sparingly",
+ "description": "If the searchable selector is picked, mappings with this item will have priority and show up even if the others are hidden\nUse this sparingly\ngroup: hidden",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -713,7 +805,7 @@
]
},
"#": {
- "description": "Used for comments or to disable a validation\n\nignore-image-in-then: normally, a `then`-clause is not allowed to have an `img`-html-element as icons are preferred. In some cases (most notably title-icons), this is allowed",
+ "description": "Used for comments or to disable a validation\n\ngroup: hidden\nignore-image-in-then: normally, a `then`-clause is not allowed to have an `img`-html-element as icons are preferred. In some cases (most notably title-icons), this is allowed",
"type": "string"
}
},
@@ -732,22 +824,18 @@
"type": "object",
"properties": {
"location": {
- "description": "All the locations that this point should be rendered at.\nPossible values are:\n- `point`: only renders points at their location\n- `centroid`: show a symbol at the centerpoint of a (multi)Linestring and (multi)polygon. Points will _not_ be rendered with this\n- `projected_centerpoint`: Only on (multi)linestrings: calculate the centerpoint and snap it to the way\n- `start` and `end`: only on linestrings: add a point to the first/last coordinate of the LineString",
+ "description": "question: At what location should this icon be shown?\nmultianswer: true\nsuggestions: return [{if: \"value=point\",then: \"Show an icon for point (node) objects\"},{if: \"value=centroid\",then: \"Show an icon for line or polygon (way) objects at their centroid location\"}, {if: \"value=start\",then: \"Show an icon for line (way) objects at the start\"},{if: \"value=end\",then: \"Show an icon for line (way) object at the end\"},{if: \"value=projected_centerpoint\",then: \"Show an icon for line (way) object near the centroid location, but moved onto the line\"}]",
"type": "array",
"items": {
"type": "string"
}
},
- "icon": {
- "description": "The icon for an element.\nNote that this also doubles as the icon for this layer (rendered with the overpass-tags) ánd the icon in the presets.\n\nThe result of the icon is rendered as follows:\nthe resulting string is interpreted as a _list_ of items, separated by \";\". The bottommost layer is the first layer.\nAs a result, on could use a generic pin, then overlay it with a specific icon.\nTo make things even more practical, one can use all SVG's from the folder \"assets/svg\" and _substitute the color_ in it.\nE.g. to draw a red pin, use \"pin:#f00\", to have a green circle with your icon on top, use `circle:#0f0;`\n\nType: icon",
- "anyOf": [
- {
- "$ref": "#/definitions/TagRenderingConfigJson"
- },
- {
- "type": "string"
- }
- ]
+ "marker": {
+ "description": "The marker for an element.\nNote that this also defines the icon for this layer (rendered with the overpass-tags) and the icon in the presets.\n\nThe result of the icon is rendered as follows:\n- The first icon is rendered on the map\n- The second entry is overlayed on top of it\n- ...\n\nAs a result, on could use a generic icon (`pin`, `circle`, `square`) with a color, then overlay it with a specific icon.",
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/IconConfigJson"
+ }
},
"iconBadges": {
"description": "A list of extra badges to show next to the icon as small badge\nThey will be added as a 25% height icon at the bottom right of the icon, with all the badges in a flex layout.\n\nNote: strings are interpreted as icons, so layering and substituting is supported. You can use `circle:white;./my_icon.svg` to add a background circle",
@@ -757,13 +845,13 @@
"properties": {
"if": {
"$ref": "#/definitions/TagConfigJson",
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation"
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag"
},
"then": {
"description": "Badge to show\nType: icon",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "string"
@@ -778,7 +866,18 @@
}
},
"iconSize": {
- "description": "A string containing \"width,height\" or \"width,height,anchorpoint\" where anchorpoint is any of 'center', 'top', 'bottom', 'left', 'right', 'bottomleft','topright', ...\nDefault is '40,40,center'",
+ "description": "question: What size should the marker be on the map?\nA string containing \",\" in pixels\nifunset: Use the default size (40,40 px)",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TagRenderingConfigJson"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "anchor": {
+ "description": "question: What is the anchorpoint of the icon?\n\nThis matches the geographical point with a location on the icon.\n\nifunset: Use MapComplete-default (center)\nsuggestions: return [{if: \"value=center\", then: \"Place the center of the icon on the geographical location\"},{if: \"value=top\", then: \"Place the top of the icon on the geographical location\"},{if: \"value=bottom\", then: \"Place the bottom of the icon on the geographical location\"},{if: \"value=left\", then: \"Place the left of the icon on the geographical location\"},{if: \"value=right\", then: \"Place the right of the icon on the geographical location\"}]",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -789,7 +888,7 @@
]
},
"rotation": {
- "description": "The rotation of an icon, useful for e.g. directions.\nUsage: as if it were a css property for 'rotate', thus has to end with 'deg', e.g. `90deg`, `{direction}deg`, `calc(90deg - {camera:direction}deg)``",
+ "description": "question: What rotation should be applied on the icon?\nThis is mostly useful for items that face a specific direction, such as surveillance cameras\nThis is interpreted as css property for 'rotate', thus has to end with 'deg', e.g. `90deg`, `{direction}deg`, `calc(90deg - {camera:direction}deg)``\nifunset: Do not rotate",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -800,7 +899,7 @@
]
},
"label": {
- "description": "A HTML-fragment that is shown below the icon, for example:\n{name}
\n\nIf the icon is undefined, then the label is shown in the center of the feature.\nNote that, if the wayhandling hides the icon then no label is shown as well.",
+ "description": "question: What label should be shown beneath the marker?\nFor example: `<div style=\"background: white\">{name}</div>`\n\nIf the icon is undefined, then the label is shown in the center of the feature.\ntypes: Dynamic value | string\ninline: Always show label {value} beneath the marker\nifunset: Do not show a label beneath the marker",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -811,7 +910,7 @@
]
},
"css": {
- "description": "A snippet of css code which is applied onto the container of the entire marker",
+ "description": "question: What CSS should be applied to the entire marker?\nYou can set the css-properties here, e.g. `background: red; font-size: 12px; `\nThis will be applied to the _container_ containing both the marker and the label\ninline: Apply CSS-style {value} to the _entire marker_\ntypes: Dynamic value ; string\nifunset: Do not apply extra CSS element to the entire marker",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -822,7 +921,7 @@
]
},
"cssClasses": {
- "description": "A snippet of css-classes which are applied onto the container of the entire marker. They can be space-separated",
+ "description": "question: Which CSS-classes should be applied to the entire marker?\nThis will be applied to the _container_ containing both the marker and the label\n\nThe classes should be separated by a space (` `)\nYou can use most Tailwind-css classes, see https://tailwindcss.com/ for more information\nFor example: `center bg-gray-500 mx-2 my-1 rounded-full`\ninline: Apply CSS-classes {value} to the entire container\nifunset: Do not apply extra CSS-classes to the label\ntypes: Dynamic value ; string\nifunset: Do not apply extra CSS-classes to the entire marker",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -833,7 +932,7 @@
]
},
"labelCss": {
- "description": "Css that is applied onto the label",
+ "description": "question: What CSS should be applied to the label?\nYou can set the css-properties here, e.g. `background: red; font-size: 12px; `\ninline: Apply CSS-style {value} to the label\ntypes: Dynamic value ; string\nifunset: Do not apply extra CSS-labels to the label",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -844,7 +943,7 @@
]
},
"labelCssClasses": {
- "description": "Css classes that are applied onto the label; can be space-separated",
+ "description": "question: Which CSS-classes should be applied to the label?\n\nThe classes should be separated by a space (` `)\nYou can use most Tailwind-css classes, see https://tailwindcss.com/ for more information\nFor example: `center bg-gray-500 mx-2 my-1 rounded-full`\ninline: Apply CSS-classes {value} to the label\ntypes: Dynamic value ; string\nifunset: Do not apply extra CSS-classes to the label",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -855,7 +954,7 @@
]
},
"pitchAlignment": {
- "description": "If the map is pitched, the marker will stay parallel to the screen.\nSet to 'map' if you want to put it flattened on the map",
+ "description": "question: If the map is pitched, should the icon stay parallel to the screen or to the groundplane?\nsuggestions: return [{if: \"value=canvas\", then: \"The icon will stay upward and not be transformed as if it sticks to the screen\"}, {if: \"value=map\", then: \"The icon will be transformed as if it were painted onto the ground. (Automatically sets rotationAlignment)\"}]",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -870,7 +969,7 @@
]
},
"rotationAlignment": {
- "description": "If the map is rotated, the icon will still point to the north if no rotation was applied",
+ "description": "question: Should the icon be rotated if the map is rotated?\nifunset: Do not rotate or tilt icons. Always keep the icons straight\nsuggestions: return [{if: \"value=canvas\", then: \"Never rotate the icon\"}, {if: \"value=map\", then: \"If the map is rotated, rotate the icon as well. This gives the impression of an icon that floats perpendicular above the ground.\"}]",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -895,10 +994,10 @@
"type": "object",
"properties": {
"color": {
- "description": "The color for way-elements and SVG-elements.\nIf the value starts with \"--\", the style of the body element will be queried for the corresponding variable instead",
+ "description": "question: What color should lines be drawn in?\n\nFor an area, this will be the colour of the outside line.\nIf the value starts with \"--\", the style of the body element will be queried for the corresponding variable instead\n\ntypes: dynamic value ; string\ntitle: Line Colour\ninline: The line colour always is {value}\ntype: color",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "string"
@@ -906,10 +1005,10 @@
]
},
"width": {
- "description": "The stroke-width for way-elements",
+ "description": "question: How wide should the line be?\nThe stroke-width for way-elements\n\ntypes: dynamic value ; string\ntitle: Line width\ninline: The line width is {value} pixels\ntype: pnat\nifunset: Use the default-linewidth of 7 pixels",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": [
@@ -920,47 +1019,25 @@
]
},
"dashArray": {
- "description": "A dasharray, e.g. \"5 6\"\nThe dasharray defines 'pixels of line, pixels of gap, pixels of line, pixels of gap',\nDefault value: \"\" (empty string == full line)",
- "anyOf": [
- {
- "$ref": "#/definitions/TagRenderingConfigJson"
- },
- {
- "type": "string"
- }
- ]
+ "description": "question: Should a dasharray be used to render the lines?\nThe dasharray defines 'pixels of line, pixels of gap, pixels of line, pixels of gap, ...'. For example, `5 6` will be 5 pixels of line followed by a 6 pixel gap.\nCannot be a dynamic property due to a mapbox limitation\nifunset: Ways are rendered with a full line",
+ "type": "string"
},
"lineCap": {
- "description": "The form at the end of a line",
+ "description": "question: What form should the line-ending have?\nsuggestions: return [{if:\"value=round\",then:\"Round endings\"}, {if: \"value=square\", then: \"square endings\"}, {if: \"value=butt\", then: \"no ending (square ending at the end, without padding)\"}]\ntypes: dynamic value ; string\ntitle: Line Cap\nifunset: Use the default value (round ending)",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "string"
}
]
},
- "fill": {
- "description": "Whether or not to fill polygons",
- "anyOf": [
- {
- "$ref": "#/definitions/TagRenderingConfigJson"
- },
- {
- "enum": [
- "no",
- "yes"
- ],
- "type": "string"
- }
- ]
- },
"fillColor": {
- "description": "The color to fill a polygon with.\nIf undefined, this will be slightly more opaque version of the stroke line",
+ "description": "question: What colour should be used as fill colour for polygons?\nifunset: The polygon fill colour will be a more transparent version of the stroke colour\nsuggestions: return [{if: \"value=#00000000\", then: \"Use a transparent fill (only render the outline)\"}]\ninline: The fill colour is {value}\ntypes: dynamic value ; string\ntype: color",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "string"
@@ -968,10 +1045,10 @@
]
},
"offset": {
- "description": "The number of pixels this line should be moved.\nUse a positive numbe to move to the right, a negative to move to the left (left/right as defined by the drawing direction of the line).\n\nIMPORTANT: MapComplete will already normalize 'key:both:property' and 'key:both' into the corresponding 'key:left' and 'key:right' tagging (same for 'sidewalk=left/right/both' which is rewritten to 'sidewalk:left' and 'sidewalk:right')\nThis simplifies programming. Refer to the CalculatedTags.md-documentation for more details",
+ "description": "question: Should the lines be moved (offsetted) with a number of pixels against the geographical lines?\nThe number of pixels this line should be moved.\nUse a positive number to move to the right in the drawing direction or a negative to move to the left (left/right as defined by the drawing direction of the line).\n\nIMPORTANT: MapComplete will already normalize 'key:both:property' and 'key:both' into the corresponding 'key:left' and 'key:right' tagging (same for 'sidewalk=left/right/both' which is rewritten to 'sidewalk:left' and 'sidewalk:right')\nThis simplifies programming. Refer to the CalculatedTags.md-documentation for more details\nifunset: don't offset lines on the map\ninline: Pixel offset by {value} pixels\ntypes: dynamic value ; number\ntype: int",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "number"
@@ -981,100 +1058,38 @@
},
"additionalProperties": false
},
- "default": {
- "description": "Rewrites and multiplies the given renderings of type T.\n\nThis can be used for introducing many similar questions automatically,\nwhich also makes translations easier.\n\n(Note that the key does _not_ need to be wrapped in {}.\nHowever, we recommend to use them if the key is used in a translation, as missing keys will be picked up and warned for by the translation scripts)\n\nFor example:\n\n```\n{\n rewrite: {\n sourceString: [\"key\", \"a|b|c\"],\n into: [\n [\"X\", 0]\n [\"Y\", 1],\n [\"Z\", 2]\n ],\n renderings: [{\n \"key\":\"a|b|c\"\n }]\n }\n}\n```\nwill result in _three_ copies (as the values to rewrite into have three values, namely:\n\n[\n {\n # The first pair: key --> X, a|b|c --> 0\n \"X\": 0\n },\n {\n \"Y\": 1\n },\n {\n \"Z\": 2\n }\n\n]",
- "type": "object",
- "properties": {
- "rewrite": {
- "type": "object",
- "properties": {
- "sourceString": {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "into": {
- "type": "array",
- "items": {
- "type": "array",
- "items": {}
- }
- }
- },
- "required": [
- "into",
- "sourceString"
- ]
- },
- "renderings": {
- "anyOf": [
- {
- "$ref": "#/definitions/default_4"
- },
- {
- "$ref": "#/definitions/default_5"
- },
- {
- "type": "array",
- "items": {
- "$ref": "#/definitions/default_5"
- }
- },
- {
- "type": "array",
- "items": {
- "$ref": "#/definitions/default_4"
- }
- }
- ]
- }
- },
- "required": [
- "renderings",
- "rewrite"
- ],
- "additionalProperties": false
- },
"QuestionableTagRenderingConfigJson": {
"description": "A QuestionableTagRenderingConfigJson is a single piece of code which converts one ore more tags into a HTML-snippet.\nIf the desired tags are missing and a question is defined, a question will be shown instead.",
"type": "object",
"properties": {
- "question": {
- "description": "If it turns out that this tagRendering doesn't match _any_ value, then we show this question.\nIf undefined, the question is never asked and this tagrendering is read-only",
- "anyOf": [
- {
- "$ref": "#/definitions/Record"
- },
- {
- "type": "string"
- }
- ]
+ "id": {
+ "type": "string"
},
- "questionHint": {
- "description": "A hint which is shown in subtle text under the question.\nThis can give some extra information on what the answer should ook like",
- "anyOf": [
- {
- "$ref": "#/definitions/Record"
- },
- {
- "type": "string"
- }
- ]
+ "mappings": {
+ "description": "Allows fixed-tag inputs, shown either as radiobuttons or as checkboxes\n\nquestion: What are common options?",
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/MappingConfigJson"
+ }
+ },
+ "multiAnswer": {
+ "description": "If true, use checkboxes instead of radio buttons when asking the question\n\nquestion: Should a contributor be allowed to select multiple mappings?\n\niftrue: allow to select multiple mappings\niffalse: only allow to select a single mapping\nifunset: only allow to select a single mapping",
+ "type": "boolean"
},
"freeform": {
"description": "Allow freeform text input from the user",
"type": "object",
"properties": {
"key": {
+ "description": "question: What is the name of the attribute that should be written to?\nifunset: do not offer a freeform textfield as answer option",
"type": "string"
},
"type": {
- "description": "The type of the text-field, e.g. 'string', 'nat', 'float', 'date',...\nSee Docs/SpecialInputElements.md and UI/Input/ValidatedTextField.ts for supported values",
+ "description": "question: What is the input type?\nThe type of the text-field, e.g. 'string', 'nat', 'float', 'date',...\nSee Docs/SpecialInputElements.md and UI/Input/ValidatedTextField.ts for supported values\nifunset: use an unconstrained string as input (default)\nsuggestions: return validators.AllValidators.filter(type => !type.isMeta).map((type) => ({if: \"value=\"+type.name, then: \"\"+type.name+\" \"+type.explanation.split(\"\\n\")[0]}))",
"type": "string"
},
"placeholder": {
- "description": "A (translated) text that is shown (as gray text) within the textfield"
+ "description": "question: What placeholder text should be shown in the input-element if there is no input?\nA (translated) text that is shown (as gray text) within the textfield\ntype: translation"
},
"helperArgs": {
"description": "Extra parameters to initialize the input helper arguments.\nFor semantics, see the 'SpecialInputElements.md'",
@@ -1089,56 +1104,34 @@
}
},
"inline": {
- "description": "When set, influences the way a question is asked.\nInstead of showing a full-width text field, the text field will be shown within the rendering of the question.\n\nThis combines badly with special input elements, as it'll distort the layout.\nNote that this will be set automatically if no special elements are present.",
+ "description": "question: Show the freeform as box within the question?\nInstead of showing a full-width text field, the text field will be shown within the rendering of the question.\n\nThis combines badly with special input elements, as it'll distort the layout.\nifunset: show the freeform input field full-width\niftrue: show the freeform input field as a small field within the question",
"type": "boolean"
},
"default": {
- "description": "default value to enter if no previous tagging is present.\nNormally undefined (aka do not enter anything)",
+ "description": "question: What value should be entered in the text field if no value is set?\nThis can help people to quickly enter the most common option\nifunset: do not prefill the textfield",
"type": "string"
+ },
+ "invalidValues": {
+ "description": "question: What values of the freeform key should be interpreted as 'unknown'?\nFor example, if a feature has `shop=yes`, the question 'what type of shop is this?' should still asked\nifunset: The question will be considered answered if any value is set for the key",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
+ },
+ {
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
+ },
+ {
+ "type": "string"
+ }
+ ]
}
},
"required": [
"key"
]
},
- "multiAnswer": {
- "description": "If true, use checkboxes instead of radio buttons when asking the question",
- "type": "boolean"
- },
- "mappings": {
- "description": "Allows fixed-tag inputs, shown either as radiobuttons or as checkboxes",
- "type": "array",
- "items": {
- "$ref": "#/definitions/MappingConfigJson"
- }
- },
- "id": {
- "description": "The id of the tagrendering, should be an unique string.\nUsed to keep the translations in sync. Only used in the tagRenderings-array of a layerConfig, not requered otherwise.\n\nUse 'questions' to trigger the question box of this group (if a group is defined)",
- "type": "string"
- },
- "labels": {
- "description": "A list of labels. These are strings that are used for various purposes, e.g. to filter them away",
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "classes": {
- "description": "A list of css-classes to apply to the entire tagRendering if the answer is known (not applied on the question).\nThis is only for advanced users",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "description": {
- "description": "A human-readable text explaining what this tagRendering does",
+ "question": {
+ "description": "question: What question should be shown to the contributor?\n\nA question is presented ot the user if no mapping matches and the 'freeform' key is not set as well.\n\nifunset: This tagrendering will be shown if it is known, but cannot be edited by the contributor, effectively resutling in a read-only rendering",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -1148,8 +1141,26 @@
}
]
},
+ "questionHint": {
+ "description": "question: Should some extra information be shown to the contributor, alongside the question?\nThis hint is shown in subtle text under the question.\nThis can give some extra information on what the answer should ook like\nifunset: No extra hint is given",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "labels": {
+ "description": "A list of labels. These are strings that are used for various purposes, e.g. to only include a subset of the tagRenderings when reusing a layer",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
"render": {
- "description": "Renders this value. Note that \"{key}\"-parts are substituted by the corresponding values of the element.\nIf neither 'textFieldQuestion' nor 'mappings' are defined, this text is simply shown as default value.\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '{website}' or include images such as `This is of type A
`\ntype: rendered",
+ "description": "question: What text should be rendered?\n\nThis piece of text will be shown in the infobox.\nIn this text, values within braces (such as {braced(key)}) are replaced by the corresponding `value` in the object.\nFor example, if the object contains tags `amenity=school; name=Windy Hill School`, the render string `This school is named {name}` will be shown to the user as `This school is named Windy Hill School`\n\nThis text will be shown if:\n- there is no mapping which matches (or there are no matches)\n- no question, no mappings and no 'freeform' is set\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '<a href='{website}'>{website}</a>' or include images such as `This is of type A <br><img src='typeA-icon.svg' />`\ntype: rendered",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -1185,16 +1196,38 @@
}
]
},
- "condition": {
- "description": "Only show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "icon": {
+ "description": "question: what icon should be shown next to the 'render' value?\nAn icon shown next to the rendering; typically shown pretty small\nThis is only shown next to the \"render\" value\nType: icon",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "object",
+ "properties": {
+ "path": {
+ "description": "The path to the icon\nType: icon",
+ "type": "string"
+ },
+ "class": {
+ "description": "A hint to mapcomplete on how to render this icon within the mapping.\nThis is translated to 'mapping-icon-', so defining your own in combination with a custom CSS is possible (but discouraged)",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path"
+ ]
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "string"
+ }
+ ]
+ },
+ "condition": {
+ "description": "question: When should this item be shown?\n\nOnly show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
+ },
+ {
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -1202,62 +1235,71 @@
]
},
"metacondition": {
- "description": "If set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
+ "description": "question: When should this item be shown (including special conditions)?\n\nIf set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
}
]
+ },
+ "description": {
+ "description": "A human-readable text explaining what this tagRendering does.\nMostly used for the shared tagrenderings",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "classes": {
+ "description": "question: What css-classes should be applied to showing this attribute?\n\nA list of css-classes to apply to the entire tagRendering.\nThese classes are applied in 'answer'-mode, not in question mode\nThis is only for advanced users.\n\nValues are split on ` ` (space)",
+ "type": "string"
}
},
+ "required": [
+ "id"
+ ],
"additionalProperties": false
},
"Partial": {
"type": "object",
"properties": {
- "question": {
- "description": "If it turns out that this tagRendering doesn't match _any_ value, then we show this question.\nIf undefined, the question is never asked and this tagrendering is read-only",
- "anyOf": [
- {
- "$ref": "#/definitions/Record"
- },
- {
- "type": "string"
- }
- ]
+ "id": {
+ "type": "string"
},
- "questionHint": {
- "description": "A hint which is shown in subtle text under the question.\nThis can give some extra information on what the answer should ook like",
- "anyOf": [
- {
- "$ref": "#/definitions/Record"
- },
- {
- "type": "string"
- }
- ]
+ "mappings": {
+ "description": "Allows fixed-tag inputs, shown either as radiobuttons or as checkboxes\n\nquestion: What are common options?",
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/MappingConfigJson"
+ }
+ },
+ "multiAnswer": {
+ "description": "If true, use checkboxes instead of radio buttons when asking the question\n\nquestion: Should a contributor be allowed to select multiple mappings?\n\niftrue: allow to select multiple mappings\niffalse: only allow to select a single mapping\nifunset: only allow to select a single mapping",
+ "type": "boolean"
},
"freeform": {
"description": "Allow freeform text input from the user",
"type": "object",
"properties": {
"key": {
+ "description": "question: What is the name of the attribute that should be written to?\nifunset: do not offer a freeform textfield as answer option",
"type": "string"
},
"type": {
- "description": "The type of the text-field, e.g. 'string', 'nat', 'float', 'date',...\nSee Docs/SpecialInputElements.md and UI/Input/ValidatedTextField.ts for supported values",
+ "description": "question: What is the input type?\nThe type of the text-field, e.g. 'string', 'nat', 'float', 'date',...\nSee Docs/SpecialInputElements.md and UI/Input/ValidatedTextField.ts for supported values\nifunset: use an unconstrained string as input (default)\nsuggestions: return validators.AllValidators.filter(type => !type.isMeta).map((type) => ({if: \"value=\"+type.name, then: \"\"+type.name+\" \"+type.explanation.split(\"\\n\")[0]}))",
"type": "string"
},
"placeholder": {
- "description": "A (translated) text that is shown (as gray text) within the textfield"
+ "description": "question: What placeholder text should be shown in the input-element if there is no input?\nA (translated) text that is shown (as gray text) within the textfield\ntype: translation"
},
"helperArgs": {
"description": "Extra parameters to initialize the input helper arguments.\nFor semantics, see the 'SpecialInputElements.md'",
@@ -1272,56 +1314,34 @@
}
},
"inline": {
- "description": "When set, influences the way a question is asked.\nInstead of showing a full-width text field, the text field will be shown within the rendering of the question.\n\nThis combines badly with special input elements, as it'll distort the layout.\nNote that this will be set automatically if no special elements are present.",
+ "description": "question: Show the freeform as box within the question?\nInstead of showing a full-width text field, the text field will be shown within the rendering of the question.\n\nThis combines badly with special input elements, as it'll distort the layout.\nifunset: show the freeform input field full-width\niftrue: show the freeform input field as a small field within the question",
"type": "boolean"
},
"default": {
- "description": "default value to enter if no previous tagging is present.\nNormally undefined (aka do not enter anything)",
+ "description": "question: What value should be entered in the text field if no value is set?\nThis can help people to quickly enter the most common option\nifunset: do not prefill the textfield",
"type": "string"
+ },
+ "invalidValues": {
+ "description": "question: What values of the freeform key should be interpreted as 'unknown'?\nFor example, if a feature has `shop=yes`, the question 'what type of shop is this?' should still asked\nifunset: The question will be considered answered if any value is set for the key",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
+ },
+ {
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
+ },
+ {
+ "type": "string"
+ }
+ ]
}
},
"required": [
"key"
]
},
- "multiAnswer": {
- "description": "If true, use checkboxes instead of radio buttons when asking the question",
- "type": "boolean"
- },
- "mappings": {
- "description": "Allows fixed-tag inputs, shown either as radiobuttons or as checkboxes",
- "type": "array",
- "items": {
- "$ref": "#/definitions/MappingConfigJson"
- }
- },
- "id": {
- "description": "The id of the tagrendering, should be an unique string.\nUsed to keep the translations in sync. Only used in the tagRenderings-array of a layerConfig, not requered otherwise.\n\nUse 'questions' to trigger the question box of this group (if a group is defined)",
- "type": "string"
- },
- "labels": {
- "description": "A list of labels. These are strings that are used for various purposes, e.g. to filter them away",
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "classes": {
- "description": "A list of css-classes to apply to the entire tagRendering if the answer is known (not applied on the question).\nThis is only for advanced users",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "description": {
- "description": "A human-readable text explaining what this tagRendering does",
+ "question": {
+ "description": "question: What question should be shown to the contributor?\n\nA question is presented ot the user if no mapping matches and the 'freeform' key is not set as well.\n\nifunset: This tagrendering will be shown if it is known, but cannot be edited by the contributor, effectively resutling in a read-only rendering",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -1331,8 +1351,26 @@
}
]
},
+ "questionHint": {
+ "description": "question: Should some extra information be shown to the contributor, alongside the question?\nThis hint is shown in subtle text under the question.\nThis can give some extra information on what the answer should ook like\nifunset: No extra hint is given",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "labels": {
+ "description": "A list of labels. These are strings that are used for various purposes, e.g. to only include a subset of the tagRenderings when reusing a layer",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
"render": {
- "description": "Renders this value. Note that \"{key}\"-parts are substituted by the corresponding values of the element.\nIf neither 'textFieldQuestion' nor 'mappings' are defined, this text is simply shown as default value.\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '{website}' or include images such as `This is of type A
`\ntype: rendered",
+ "description": "question: What text should be rendered?\n\nThis piece of text will be shown in the infobox.\nIn this text, values within braces (such as {braced(key)}) are replaced by the corresponding `value` in the object.\nFor example, if the object contains tags `amenity=school; name=Windy Hill School`, the render string `This school is named {name}` will be shown to the user as `This school is named Windy Hill School`\n\nThis text will be shown if:\n- there is no mapping which matches (or there are no matches)\n- no question, no mappings and no 'freeform' is set\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '<a href='{website}'>{website}</a>' or include images such as `This is of type A <br><img src='typeA-icon.svg' />`\ntype: rendered",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -1368,16 +1406,38 @@
}
]
},
- "condition": {
- "description": "Only show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "icon": {
+ "description": "question: what icon should be shown next to the 'render' value?\nAn icon shown next to the rendering; typically shown pretty small\nThis is only shown next to the \"render\" value\nType: icon",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "object",
+ "properties": {
+ "path": {
+ "description": "The path to the icon\nType: icon",
+ "type": "string"
+ },
+ "class": {
+ "description": "A hint to mapcomplete on how to render this icon within the mapping.\nThis is translated to 'mapping-icon-', so defining your own in combination with a custom CSS is possible (but discouraged)",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path"
+ ]
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "string"
+ }
+ ]
+ },
+ "condition": {
+ "description": "question: When should this item be shown?\n\nOnly show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
+ },
+ {
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -1385,20 +1445,33 @@
]
},
"metacondition": {
- "description": "If set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
+ "description": "question: When should this item be shown (including special conditions)?\n\nIf set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
}
]
+ },
+ "description": {
+ "description": "A human-readable text explaining what this tagRendering does.\nMostly used for the shared tagrenderings",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "classes": {
+ "description": "question: What css-classes should be applied to showing this attribute?\n\nA list of css-classes to apply to the entire tagRendering.\nThese classes are applied in 'answer'-mode, not in question mode\nThis is only for advanced users.\n\nValues are split on ` ` (space)",
+ "type": "string"
}
},
"additionalProperties": false
@@ -1479,15 +1552,13 @@
"properties": {
"question": {},
"osmTags": {
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation",
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -1535,6 +1606,10 @@
"DeleteConfigJson": {
"type": "object",
"properties": {
+ "neededChangesets": {
+ "description": "*\nBy default, the contributor needs 20 previous changesets to delete points edited by others.\nFor some small features (e.g. bicycle racks) this is too much and this requirement can be lowered or dropped, which can be done here.\n\ntype: nat\nquestion: How many changesets must a contributor have before being allowed to delete a point?",
+ "type": "number"
+ },
"extraDeleteReasons": {
"description": "*\nBy default, three reasons to delete a point are shown:\n\n- The point does not exist anymore\n- The point was a testing point\n- THe point could not be found\n\nHowever, for some layers, there might be different or more specific reasons for deletion which can be user friendly to set, e.g.:\n\n- the shop has closed\n- the climbing route has been closed of for nature conservation reasons\n- ...\n\nThese reasons can be stated here and will be shown in the list of options the user can choose from",
"type": "array",
@@ -1542,10 +1617,10 @@
"type": "object",
"properties": {
"explanation": {
- "description": "The text that will be shown to the user - translatable"
+ "description": "The text that will be shown to the user as option for why this point does not exist anymore.\nNote that the most common reasons (test point, does not exist anymore, cannot be found) are already offered by default\n\nquestion: For what extra reason might this feature be removed in real-life?"
},
"changesetMessage": {
- "description": "The text that will be uploaded into the changeset or will be used in the fixme in case of a soft deletion\nShould be a few words, in english",
+ "description": "The text that will be uploaded into the changeset or will be used in the fixme in case of a soft deletion\nShould be a few words, in english\n\nquestion: What should be added to the changeset as delete reason?",
"type": "string"
}
},
@@ -1563,10 +1638,10 @@
"properties": {
"if": {
"$ref": "#/definitions/TagConfigJson",
- "description": "The tags that will be given to the object.\nThis must remove tags so that the 'source/osmTags' won't match anymore"
+ "description": "The tags that will be given to the object.\nThis must remove tags so that the 'source/osmTags' won't match anymore\n\nquestion: What tags should be applied to the object?"
},
"then": {
- "description": "The human explanation for the options"
+ "description": "The human explanation for the options\n\nquestion: What text should be shown to the contributor for this reason?"
}
},
"required": [
@@ -1576,27 +1651,21 @@
}
},
"softDeletionTags": {
- "description": "In some cases, the contributor is not allowed to delete the current feature (e.g. because it isn't a point, the point is referenced by a relation or the user isn't experienced enough).\nTo still offer the user a 'delete'-option, the feature is retagged with these tags. This is a soft deletion, as the point isn't actually removed from OSM but rather marked as 'disused'\nIt is important that the feature will be retagged in such a way that it won't be picked up by the layer anymore!\n\nExample (note that \"amenity=\" erases the 'amenity'-key alltogether):\n```\n{\n \"and\": [\"disussed:amenity=public_bookcase\", \"amenity=\"]\n}\n```\n\nor (notice the use of the ':='-tag to copy the old value of 'shop=*' into 'disused:shop='):\n```\n{\n \"and\": [\"disused:shop:={shop}\", \"shop=\"]\n}\n```",
+ "description": "In some cases, the contributor is not allowed to delete the current feature (e.g. because it isn't a point, the point is referenced by a relation or the user isn't experienced enough).\nTo still offer the user a 'delete'-option, the feature is retagged with these tags. This is a soft deletion, as the point isn't actually removed from OSM but rather marked as 'disused'\nIt is important that the feature will be retagged in such a way that it won't be picked up by the layer anymore!\n\nExample (note that \"amenity=\" erases the 'amenity'-key alltogether):\n\n```\n{\n \"and\": [\"disussed:amenity=public_bookcase\", \"amenity=\"]\n}\n```\n\nor (notice the use of the ':='-tag to copy the old value of 'shop=*' into 'disused:shop='):\n\n```\n{\n \"and\": [\"disused:shop:={shop}\", \"shop=\"]\n}\n```\n\nquestion: If a hard delete is not possible, what tags should be applied to mark this feature as deleted?\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
}
]
},
- "neededChangesets": {
- "description": "*\nBy default, the contributor needs 20 previous changesets to delete points edited by others.\nFor some small features (e.g. bicycle racks) this is too much and this requirement can be lowered or dropped, which can be done here.",
- "type": "number"
- },
"omitDefaultDeleteReasons": {
- "description": "Set this flag if the default delete reasons should be omitted from the dialog.\nThis requires at least one extraDeleteReason or nonDeleteMapping",
+ "description": "Set this flag if the default delete reasons should be omitted from the dialog.\nThis requires at least one extraDeleteReason or nonDeleteMapping\n\nquestion: Should the default delete reasons be hidden?\niftrue: Hide the default delete reasons\niffalse: Show the default delete reasons\nifunset: Show the default delete reasons (default behaviour)",
"type": "boolean"
}
},
@@ -1606,11 +1675,11 @@
"type": "object",
"properties": {
"enableImproveAccuracy": {
- "description": "One default reason to move a point is to improve accuracy.\nSet to false to disable this reason",
+ "description": "question: Should moving this type of point to improve the accuracy be allowed?\niftrue: This point can be moved to improve the accuracy\nifunset: (default) This point can be moved to improve the accuracy\niffalse: This point cannot be moved to improve the accuracy",
"type": "boolean"
},
"enableRelocation": {
- "description": "One default reason to move a point is because it has relocated\nSet to false to disable this reason",
+ "description": "question: Should moving this type of point due to a relocation be allowed?\n\nThis will erase the attributes `addr:street`, `addr:housenumber`, `addr:city` and `addr:postcode`\n\niftrue: This type of point can be moved due to a relocation (and will remove address information when this is done)\nifunset: (default) This type of point can be moved due to a relocation (and will remove address information when this is done)\niffalse: This type of point cannot be moved due to a relocation",
"type": "boolean"
}
},
@@ -1621,7 +1690,7 @@
"type": "object",
"properties": {
"appliesToKey": {
- "description": "Every key from this list will be normalized.\n\nTo render a united value properly, use",
+ "description": "Every key from this list will be normalized.\n\nTo render the value properly (with a human readable denomination), use `{canonical()}`",
"type": "array",
"items": {
"type": "string"
@@ -1679,6 +1748,9 @@
"category": {
"type": "string"
},
+ "type": {
+ "type": "string"
+ },
"attribution": {
"type": "object",
"properties": {
@@ -1718,11 +1790,11 @@
"type": "object",
"properties": {
"id": {
- "description": "The id of this layer.\nThis should be a simple, lowercase, human readable string that is used to identify the layer.",
+ "description": "question: What is the identifier of this layer?\n\nThis should be a simple, lowercase, human readable string that is used to identify the layer.\n A good ID is:\n - a noun\n - written in singular\n - describes the object\n - in english\n - only has lowercase letters, numbers or underscores. Do not use a space or a dash\n\ntype: id\ngroup: Basic",
"type": "string"
},
"name": {
- "description": "The name of this layer\nUsed in the layer control panel and the 'Personal theme'.\n\nIf not given, will be hidden (and thus not toggable) in the layer control",
+ "description": "Used in the layer control panel to toggle a layer on and of.\n\nifunset: This will hide the layer in the layer control, making it not filterable and not toggleable\n\ngroup: Basic\nquestion: What is the name of this layer?",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -1733,7 +1805,7 @@
]
},
"description": {
- "description": "A description for this layer.\nShown in the layer selections and in the personel theme",
+ "description": "A description for the features shown in this layer.\nThis often resembles the introduction of the wiki.osm.org-page for this feature.\n\ngroup: Basic\nquestion: How would you describe the features that are shown on this layer?",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -1744,17 +1816,17 @@
]
},
"source": {
- "description": "This determines where the data for the layer is fetched: from OSM or from an external geojson dataset.\n\nIf no 'geojson' is defined, data will be fetched from overpass and the OSM-API.\n\nEvery source _must_ define which tags _must_ be present in order to be picked up.\n\nNote: a source must always be defined. 'special' is only allowed if this is a builtin-layer",
+ "description": "Question: Where should the data be fetched from?\ntitle: Data Source\n\nThis determines where the data for the layer is fetched: from OSM or from an external geojson dataset.\n\nIf no 'geojson' is defined, data will be fetched from overpass and the OSM-API.\n\nEvery source _must_ define which tags _must_ be present in order to be picked up.\n\nNote: a source must always be defined. 'special' is only allowed if this is a builtin-layer\n\ntypes: Load data with specific tags from OpenStreetMap ; Load data from an external geojson source ;\ntypesdefault: 0\ngroup: Basic",
"anyOf": [
{
"type": "object",
"properties": {
"osmTags": {
"$ref": "#/definitions/TagConfigJson",
- "description": "Every source must set which tags have to be present in order to load the given layer."
+ "description": "question: Which tags must be present on the feature to show it in this layer?\nEvery source must set which tags have to be present in order to load the given layer."
},
"maxCacheAge": {
- "description": "The maximum amount of seconds that a tile is allowed to linger in the cache",
+ "description": "question: How long (in seconds) is the data allowed to remain cached until it must be refreshed?\nThe maximum amount of seconds that a tile is allowed to linger in the cache\n\ntype: nat\ndefault: 30 days",
"type": "number"
}
},
@@ -1766,23 +1838,23 @@
"type": "object",
"properties": {
"geoJson": {
- "description": "The actual source of the data to load, if loaded via geojson.\n\n# A single geojson-file\nsource: {geoJson: \"https://my.source.net/some-geo-data.geojson\"}\n fetches a geojson from a third party source\n\n# A tiled geojson source\nsource: {geoJson: \"https://my.source.net/some-tile-geojson-{layer}-{z}-{x}-{y}.geojson\", geoJsonZoomLevel: 14}\n to use a tiled geojson source. The web server must offer multiple geojsons. {z}, {x} and {y} are substituted by the location; {layer} is substituted with the id of the loaded layer\n\nSome API's use a BBOX instead of a tile, this can be used by specifying {y_min}, {y_max}, {x_min} and {x_max}",
+ "description": "The actual source of the data to load, if loaded via geojson.\n\n# A single geojson-file\nsource: {geoJson: \"https://my.source.net/some-geo-data.geojson\"}\n fetches a geojson from a third party source\n\n# A tiled geojson source\nsource: {geoJson: \"https://my.source.net/some-tile-geojson-{layer}-{z}-{x}-{y}.geojson\", geoJsonZoomLevel: 14}\n to use a tiled geojson source. The web server must offer multiple geojsons. {z}, {x} and {y} are substituted by the location; {layer} is substituted with the id of the loaded layer\n\nSome API's use a BBOX instead of a tile, this can be used by specifying {y_min}, {y_max}, {x_min} and {x_max}\n\nquestion: What is the URL of the geojson?\ntype: url",
"type": "string"
},
"geoJsonZoomLevel": {
- "description": "To load a tiled geojson layer, set the zoomlevel of the tiles",
+ "description": "To load a tiled geojson layer, set the zoomlevel of the tiles\n\nquestion: If using a tiled geojson, what is the zoomlevel of the tiles?\nifunset: This is not a tiled geojson",
"type": "number"
},
"isOsmCache": {
- "description": "Indicates that the upstream geojson data is OSM-derived.\nUseful for e.g. merging or for scripts generating this cache",
+ "description": "Indicates that the upstream geojson data is OSM-derived.\nUseful for e.g. merging or for scripts generating this cache.\nThis also indicates that making changes on this data is possible\n\nquestion: Is this geojson a cache of OpenStreetMap data?\nifunset: This is not an OpenStreetMap cache\niftrue: this is based on OpenStreetMap and can thus be edited",
"type": "boolean"
},
"mercatorCrs": {
- "description": "Some API's use a mercator-projection (EPSG:900913) instead of WGS84. Set the flag `mercatorCrs: true` in the source for this",
+ "description": "Some API's use a mercator-projection (EPSG:900913) instead of WGS84. Set the flag `mercatorCrs: true` in the source for this\n\nquestion: Does this geojson use EPSG:900913 instead of WGS84 as projection?\niftrue: This geojson uses EPSG:900913 instead of WGS84\nifunset: This geojson uses WGS84 just like most geojson (default)",
"type": "boolean"
},
"idKey": {
- "description": "Some API's have an id-field, but give it a different name.\nSetting this key will rename this field into 'id'",
+ "description": "Some API's have an id-field, but give it a different name.\nSetting this key will rename this field into 'id'\n\nifunset: An id with key `id` will be assigned automatically if no attribute `id` is set\ninline: This geojson uses {value} as attribute to set the id\nquestion: What is the name of the attribute containing the ID of the object?",
"type": "string"
}
},
@@ -1800,51 +1872,44 @@
]
},
"calculatedTags": {
- "description": "A list of extra tags to calculate, specified as \"keyToAssignTo=javascript-expression\".\nThere are a few extra functions available. Refer to Docs/CalculatedTags.md for more information\nThe functions will be run in order, e.g.\n[\n \"_max_overlap_m2=Math.max(...feat.overlapsWith(\"someOtherLayer\").map(o => o.overlap))\n \"_max_overlap_ratio=Number(feat._max_overlap_m2)/feat.area\n]\n\nThe specified tags are evaluated lazily. E.g. if a calculated tag is only used in the popup (e.g. the number of nearby features),\nthe expensive calculation will only be performed then for that feature. This avoids clogging up the contributors PC when all features are loaded.\n\nIf a tag has to be evaluated strictly, use ':=' instead:\n\n[\n\"_some_key:=some_javascript_expression\"\n]",
+ "description": "A list of extra tags to calculate, specified as \"keyToAssignTo=javascript-expression\".\nThere are a few extra functions available. Refer to Docs/CalculatedTags.md for more information\nThe functions will be run in order, e.g.\n[\nNot found... * \"_max_overlap_m2=Math.max(...feat.overlapsWith(\"someOtherLayer\").map(o => o.overlap))\n \"_max_overlap_ratio=Number(feat._max_overlap_m2)/feat.area\n]\n\nThe specified tags are evaluated lazily. E.g. if a calculated tag is only used in the popup (e.g. the number of nearby features),\nthe expensive calculation will only be performed then for that feature. This avoids clogging up the contributors PC when all features are loaded.\n\nIf a tag has to be evaluated strictly, use ':=' instead:\n\n[\n\"_some_key:=some_javascript_expression\"\n]\n\nSee the full documentation on [https://github.com/pietervdvn/MapComplete/blob/master/Docs/CalculatedTags.md]\n\ngroup: expert\nquestion: What extra attributes should be calculated with javascript?",
"type": "array",
"items": {
"type": "string"
}
},
- "doNotDownload": {
- "description": "If set, this layer will not query overpass; but it'll still match the tags above which are by chance returned by other layers.\nWorks well together with 'passAllFeatures', to add decoration",
- "type": "boolean"
- },
"isShown": {
- "description": "If set, only features matching this extra tag will be shown.\nThis is useful to hide certain features from view.\n\nImportant: hiding features does not work dynamically, but is only calculated when the data is first renders.\nThis implies that it is not possible to hide a feature after a tagging change\n\nThe default value is 'yes'",
+ "description": "If set, only features matching this extra tag will be shown.\nThis is useful to hide certain features from view based on a calculated tag or if the features are provided by a different layer.\n\nquestion: What other tags should features match for being shown?\ngroup: advanced\nifunset: all features which match the 'source'-specification are shown.",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
}
]
},
- "forceLoad": {
- "description": "Advanced option - might be set by the theme compiler\n\nIf true, this data will _always_ be loaded, even if the theme is disabled",
- "type": "boolean"
- },
"minzoom": {
- "description": "The minimum needed zoomlevel required before loading of the data start\nDefault: 0",
+ "description": "The minimum needed zoomlevel required to start loading and displaying the data.\nThis can be used to only show common features (e.g. a bicycle parking) only when the map is zoomed in very much (17).\nThis prevents cluttering the map with thousands of parkings if one is looking to an entire city.\n\nDefault: 0\ngroup: Basic\ntype: nat\nquestion: At what zoom level should features of the layer be shown?\nifunset: Always load this layer, even if the entire world is in view.",
"type": "number"
},
"shownByDefault": {
- "description": "Indicates if this layer is shown by default;\ncan be used to hide a layer from start, or to load the layer but only to show it where appropriate (e.g. for snapping to it)",
+ "description": "Indicates if this layer is shown by default;\ncan be used to hide a layer from start, or to load the layer but only to show it when appropriate (e.g. for advanced users)\n\nquestion: Should this layer be enabled when opening the map for the first time?\niftrue: the layer is enabled when opening the map\niffalse: the layer is hidden until the contributor enables it. (If the filter-popup is disabled, this might never get enabled nor loaded)\ndefault: true\ngroup: advanced",
"type": "boolean"
},
"minzoomVisible": {
- "description": "The zoom level at which point the data is hidden again\nDefault: 100 (thus: always visible",
+ "description": "The zoom level at which point the data is hidden again\nDefault: 100 (thus: always visible\n\ngroup: expert",
"type": "number"
},
"title": {
- "description": "The title shown in a popup for elements of this layer.",
+ "description": "question: What title should be shown on the infobox?\nThe title shown in a popup for elements of this layer.\n\ngroup: title\ntypes: use a fixed translation ; Use a dynamic tagRendering ; hidden\ntypesdefault: 1\ntype: translation\ninline: {translated{value}}",
"anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
{
"$ref": "#/definitions/TagRenderingConfigJson"
},
@@ -1853,8 +1918,12 @@
}
]
},
+ "popupInFloatover": {
+ "description": "Question: Should the information for this layer be shown in the sidebar or in a splash screen?\n\nIf set, open the selectedElementView in a floatOver instead of on the right.\n\niftrue: show the infobox in the splashscreen floating over the entire UI\niffalse: show the infobox in a sidebar on the right\ngroup: advanced\ndefault: sidebar",
+ "type": "boolean"
+ },
"titleIcons": {
- "description": "Small icons shown next to the title.\nIf not specified, the OsmLink and wikipedia links will be used by default.\nUse an empty array to hide them.\nNote that \"defaults\" will insert all the default titleIcons (which are added automatically)\n\nType: icon[]",
+ "description": "Small icons shown next to the title.\nIf not specified, the OsmLink and wikipedia links will be used by default.\nUse an empty array to hide them.\nNote that \"defaults\" will insert all the default titleIcons (which are added automatically)\n\nType: icon[]\ngroup: infobox",
"anyOf": [
{
"type": "array",
@@ -1884,42 +1953,40 @@
}
]
},
- "mapRendering": {
- "description": "Visualisation of the items on the map",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "anyOf": [
- {
- "$ref": "#/definitions/default_4"
- },
- {
- "$ref": "#/definitions/default_5"
- },
- {
- "$ref": "#/definitions/default"
- }
- ]
- }
- },
- {
- "type": "null"
- }
- ]
+ "pointRendering": {
+ "description": "Creates points to render on the map.\nThis can render points for point-objects, lineobjects or areaobjects; use 'location' to indicate where it should be rendered\ngroup: pointrendering",
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/default_4"
+ }
+ },
+ "lineRendering": {
+ "description": "Creates lines and areas to render on the map\ngroup: linerendering",
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/default_5"
+ }
},
"passAllFeatures": {
- "description": "If set, this layer will pass all the features it receives onto the next layer.\nThis is ideal for decoration, e.g. directionss on cameras",
+ "description": "If set, this layer will pass all the features it receives onto the next layer.\nThis is ideal for decoration, e.g. directions on cameras\niftrue: Make the features from this layer also available to the other layer; might result in this object being rendered by multiple layers\niffalse: normal behaviour: don't pass features allong\nquestion: should this layer pass features to the next layers?\ngroup: expert",
+ "type": "boolean"
+ },
+ "doNotDownload": {
+ "description": "If set, this layer will not query overpass; but it'll still match the tags above which are by chance returned by other layers.\nWorks well together with 'passAllFeatures', to add decoration\nThe opposite of `forceLoad`\n\niftrue: Do not attempt to query the data for this layer from overpass/the OSM API\niffalse: download the data as usual\ngroup: expert\nquestion: Should this layer be downloaded or is the data provided by a different layer (which has 'passAllFeatures'-set)?\ndefault: false",
+ "type": "boolean"
+ },
+ "forceLoad": {
+ "description": "Advanced option - might be set by the theme compiler\n\nIf true, this data will _always_ be loaded, even if the theme is disabled by a filter or hidden.\nThe opposite of `doNotDownload`\n\nquestion: Should this layer be forcibly loaded?\nifftrue: always download this layer, even if it is disabled\niffalse: only download data for this layer when needed (default)\ndefault: false\ngroup: expert",
"type": "boolean"
},
"presets": {
- "description": "Presets for this layer.\nA preset shows up when clicking the map on a without data (or when right-clicking/long-pressing);\nit will prompt the user to add a new point.\n\nThe most important aspect are the tags, which define which tags the new point will have;\nThe title is shown in the dialog, along with the first sentence of the description.\n\nUpon confirmation, the full description is shown beneath the buttons - perfect to add pictures and examples.\n\nNote: the icon of the preset is determined automatically based on the tags and the icon above. Don't worry about that!\nNB: if no presets are defined, the popup to add new points doesn't show up at all",
+ "description": "Presets for this layer.\nA preset shows up when clicking the map on a without data (or when right-clicking/long-pressing);\nit will prompt the user to add a new point.\n\nThe most important aspect are the tags, which define which tags the new point will have;\nThe title is shown in the dialog, along with the first sentence of the description.\n\nUpon confirmation, the full description is shown beneath the buttons - perfect to add pictures and examples.\n\nNote: the icon of the preset is determined automatically based on the tags and the icon above. Don't worry about that!\nNB: if no presets are defined, the popup to add new points doesn't show up at all\n\ngroup: presets",
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
- "description": "The title - shown on the 'add-new'-button.\n\nThis should include the article of the noun, e.g. 'a hydrant', 'a bicycle pump'.\nThis text will be inserted into `Add {category} here`, becoming `Add a hydrant here`.\n\nDo _not_ indicate 'new': 'add a new shop here' is incorrect, as the shop might have existed forever, it could just be unmapped!",
+ "description": "The title - shown on the 'add-new'-button.\n\nThis should include the article of the noun, e.g. 'a hydrant', 'a bicycle pump'.\nThis text will be inserted into `Add {category} here`, becoming `Add a hydrant here`.\n\nDo _not_ indicate 'new': 'add a new shop here' is incorrect, as the shop might have existed forever, it could just be unmapped!\n\nquestion: What is the word to describe this object?\ninline: Add {translated(value)::font-bold} here",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -1930,14 +1997,14 @@
]
},
"tags": {
- "description": "The tags to add. It determines the icon too",
+ "description": "A single tag (encoded as key=value
) out of all the tags to add onto the newly created point.\nNote that the icon in the UI will be chosen automatically based on the tags provided here.\n\nquestion: What tag should be added to the new object?\ntype: simple_tag\ntypeHelper: uploadableOnly",
"type": "array",
"items": {
"type": "string"
}
},
"description": {
- "description": "The _first sentence_ of the description is shown on the button of the `add` menu.\nThe full description is shown in the confirmation dialog.\n\n(The first sentence is until the first '.'-character in the description)",
+ "description": "An extra explanation of what the feature is, if it is not immediately clear from the title alone.\n\nThe _first sentence_ of the description is shown on the button of the `add` menu.\nThe full description is shown in the confirmation dialog.\n\n(The first sentence is until the first '.'-character in the description)\n\nquestion: How would you describe this feature?",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -1948,59 +2015,22 @@
]
},
"exampleImages": {
- "description": "Example images, which show real-life pictures of what such a feature might look like\n\nType: image",
+ "description": "The URL of an example image which shows a real-life example of what such a feature might look like.\n\nType: image\nquestion: What is the URL of an image showing such a feature?",
"type": "array",
"items": {
"type": "string"
}
},
- "preciseInput": {
- "description": "If set, the user will prompted to confirm the location before actually adding the data.\nThis will be with a 'drag crosshair'-method.\n\nIf 'preferredBackgroundCategory' is set, the element will attempt to pick a background layer of that category.",
- "anyOf": [
- {
- "type": "object",
- "properties": {
- "preferredBackground": {
- "description": "The type of background picture",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "snapToLayer": {
- "description": "If specified, these layers will be shown to and the new point will be snapped towards it",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "maxSnapDistance": {
- "description": "If specified, a new point will only be snapped if it is within this range.\nDistance in meter\n\nDefault: 10",
- "type": "number"
- }
- }
- },
- {
- "enum": [
- true
- ],
- "type": "boolean"
- }
- ]
+ "snapToLayer": {
+ "description": "question: Should the created point be snapped to a line layer?\n\nIf specified, these layers will be shown in the precise location picker and the new point will be snapped towards it.\nFor example, this can be used to snap against `walls_and_buildings` (e.g. to attach a defibrillator, an entrance, an artwork, ... to the wall)\nor to snap an obstacle (such as a bollard) to the `cycleways_and_roads`.\n\nsuggestions: return Array.from(layers.keys()).map(key => ({if: \"value=\"+key, then: key+\" - \"+layers.get(key).description}))",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "maxSnapDistance": {
+ "description": "question: What is the maximum distance in the location-input that a point can be moved to be snapped to a way?\n\ninline: a point is snapped if the location input is at most {value}m away from an object\n\nIf specified, a new point will only be snapped if it is within this range.\nIf further away, it'll be placed in the center of the location input\nDistance in meter\n\nifunset: Do not snap to a layer",
+ "type": "number"
}
},
"required": [
@@ -2010,7 +2040,7 @@
}
},
"tagRenderings": {
- "description": "All the tag renderings.\nA tag rendering is a block that either shows the known value or asks a question.\n\nRefer to the class `TagRenderingConfigJson` to see the possibilities.\n\nNote that we can also use a string here - where the string refers to a tag rendering defined in `assets/questions/questions.json`,\nwhere a few very general questions are defined e.g. website, phone number, ...\nFurthermore, _all_ the questions of another layer can be reused with `otherlayer.*`\nIf you need only a single of the tagRenderings, use `otherlayer.tagrenderingId`\nIf one or more questions have a 'group' or 'label' set, select all the entries with the corresponding group or label with `otherlayer.*group`\nRemark: if a tagRendering is 'lent' from another layer, the 'source'-tags are copied and added as condition.\nIf they are not wanted, remove them with an override\n\nA special value is 'questions', which indicates the location of the questions box. If not specified, it'll be appended to the bottom of the featureInfobox.\n\nAt last, one can define a group of renderings where parts of all strings will be replaced by multiple other strings.\nThis is mainly create questions for a 'left' and a 'right' side of the road.\nThese will be grouped and questions will be asked together",
+ "description": "question: Which tagRenderings should be shown in the infobox?\n\nA tag rendering is a block that either shows the known value or asks a question.\n\nRefer to the class `TagRenderingConfigJson` to see the possibilities.\n\nNote that we can also use a string here - where the string refers to a tag rendering defined in `assets/questions/questions.json`,\nwhere a few very general questions are defined e.g. website, phone number, ...\nFurthermore, _all_ the questions of another layer can be reused with `otherlayer.*`\nIf you need only a single of the tagRenderings, use `otherlayer.tagrenderingId`\nIf one or more questions have a 'group' or 'label' set, select all the entries with the corresponding group or label with `otherlayer.*group`\nRemark: if a tagRendering is 'lent' from another layer, the 'source'-tags are copied and added as condition.\nIf they are not wanted, remove them with an override\n\nA special value is 'questions', which indicates the location of the questions box. If not specified, it'll be appended to the bottom of the featureInfobox.\n\nAt last, one can define a group of renderings where parts of all strings will be replaced by multiple other strings.\nThis is mainly create questions for a 'left' and a 'right' side of the road.\nThese will be grouped and questions will be asked together\n\ntype: tagrendering[]\ngroup: tagrenderings",
"type": "array",
"items": {
"anyOf": [
@@ -2070,7 +2100,7 @@
}
},
"filter": {
- "description": "All the extra questions for filtering.\nIf a string is given, mapComplete will search in 'filters.json' for the appropriate filter or will try to parse it as `layername.filterid` and us that one",
+ "description": "All the extra questions for filtering.\nIf a string is given, mapComplete will search in 'filters.json' for the appropriate filter or will try to parse it as `layername.filterid` and us that one\n\ngroup: filters",
"anyOf": [
{
"type": "array",
@@ -2099,7 +2129,7 @@
]
},
"deletion": {
- "description": "This block defines under what circumstances the delete dialog is shown for objects of this layer.\nIf set, a dialog is shown to the user to (soft) delete the point.\nThe dialog is built to be user friendly and to prevent mistakes.\nIf deletion is not possible, the dialog will hide itself and show the reason of non-deletability instead.\n\nTo configure, the following values are possible:\n\n- false: never ever show the delete button\n- true: show the default delete button\n- undefined: use the mapcomplete default to show deletion or not. Currently, this is the same as 'false' but this will change in the future\n- or: a hash with options (see below)\n\n The delete dialog\n =================\n\n\n\n#### Hard deletion if enough experience\n\nA feature can only be deleted from OpenStreetMap by mapcomplete if:\n\n- It is a node\n- No ways or relations use the node\n- The logged-in user has enough experience OR the user is the only one to have edited the point previously\n- The logged-in user has no unread messages (or has a ton of experience)\n- The user did not select one of the 'non-delete-options' (see below)\n\nIn all other cases, a 'soft deletion' is used.\n\n#### Soft deletion\n\nA 'soft deletion' is when the point isn't deleted from OSM but retagged so that it'll won't how up in the mapcomplete theme anymore.\nThis makes it look like it was deleted, without doing damage. A fixme will be added to the point.\n\nNote that a soft deletion is _only_ possible if these tags are provided by the theme creator, as they'll be different for every theme\n\n#### No-delete options\n\nIn some cases, the contributor might want to delete something for the wrong reason (e.g. someone who wants to have a path removed \"because the path is on their private property\").\nHowever, the path exists in reality and should thus be on OSM - otherwise the next contributor will pass by and notice \"hey, there is a path missing here! Let me redraw it in OSM!)\n\nThe correct approach is to retag the feature in such a way that it is semantically correct *and* that it doesn't show up on the theme anymore.\nA no-delete option is offered as 'reason to delete it', but secretly retags.",
+ "description": "This block defines under what circumstances the delete dialog is shown for objects of this layer.\nIf set, a dialog is shown to the user to (soft) delete the point.\nThe dialog is built to be user friendly and to prevent mistakes.\nIf deletion is not possible, the dialog will hide itself and show the reason of non-deletability instead.\n\nTo configure, the following values are possible:\n\n- false: never ever show the delete button\n- true: show the default delete button\n- undefined: use the mapcomplete default to show deletion or not. Currently, this is the same as 'false' but this will change in the future\n- or: a hash with options (see below)\n\n### The delete dialog\n\n\n\n#### Hard deletion if enough experience\n\nA feature can only be deleted from OpenStreetMap by mapcomplete if:\n\n- It is a node\n- No ways or relations use the node\n- The logged-in user has enough experience OR the user is the only one to have edited the point previously\n- The logged-in user has no unread messages (or has a ton of experience)\n- The user did not select one of the 'non-delete-options' (see below)\n\nIn all other cases, a 'soft deletion' is used.\n\n#### Soft deletion\n\nA 'soft deletion' is when the point isn't deleted fromOSM but retagged so that it'll won't how up in the mapcomplete theme anymore.\nThis makes it look like it was deleted, without doing damage. A fixme will be added to the point.\n\nNote that a soft deletion is _only_ possible if these tags are provided by the theme creator, as they'll be different for every theme\n\n##### No-delete options\n\nIn some cases, the contributor might want to delete something for the wrong reason (e.g. someone who wants to have a path removed \"because the path is on their private property\").\nHowever, the path exists in reality and should thus be on OSM - otherwise the next contributor will pass by and notice \"hey, there is a path missing here! Let me redraw it in OSM!)\n\nThe correct approach is to retag the feature in such a way that it is semantically correct *and* that it doesn't show up on the theme anymore.\nA no-delete option is offered as 'reason to delete it', but secretly retags.\n\ngroup: editing\ntypes: Use an advanced delete configuration ; boolean\niftrue: Allow deletion\niffalse: Do not allow deletion\nifunset: Do not allow deletion",
"anyOf": [
{
"$ref": "#/definitions/DeleteConfigJson"
@@ -2110,7 +2140,7 @@
]
},
"allowMove": {
- "description": "Indicates if a point can be moved and configures the modalities.\n\nA feature can be moved by MapComplete if:\n\n- It is a point\n- The point is _not_ part of a way or a a relation.\n\nOff by default. Can be enabled by setting this flag or by configuring.",
+ "description": "Indicates if a point can be moved and why.\n\nA feature can be moved by MapComplete if:\n\n- It is a point\n- The point is _not_ part of a way or a a relation.\n\ntypes: use an advanced move configuration ; boolean\ngroup: editing\nquestion: Is deleting a point allowed?\niftrue: Allow contributors to move a point (for accuracy or a relocation)\niffalse: Don't allow contributors to move points\nifunset: Don't allow contributors to move points (default)",
"anyOf": [
{
"$ref": "#/definitions/default_3"
@@ -2121,7 +2151,7 @@
]
},
"allowSplit": {
- "description": "If set, a 'split this way' button is shown on objects rendered as LineStrings, e.g. highways.\n\nIf the way is part of a relation, MapComplete will attempt to update this relation as well",
+ "description": "If set, a 'split this way' button is shown on objects rendered as LineStrings, e.g. highways.\n\nIf the way is part of a relation, MapComplete will attempt to update this relation as well\nquestion: Should the contributor be able to split ways using this layer?\niftrue: enable the 'split-roads'-component\niffalse: don't enable the split-roads componenet\nifunset: don't enable the split-roads component\ngroup: editing",
"type": "boolean"
},
"units": {
@@ -2131,7 +2161,7 @@
}
},
"syncSelection": {
- "description": "If set, synchronizes whether or not this layer is enabled.\n\nno: Do not sync at all, always revert to default\nlocal: keep selection on local storage\ntheme-only: sync via OSM, but this layer will only be toggled in this theme\nglobal: all layers with this ID will be synced accross all themes",
+ "description": "If set, synchronizes whether or not this layer is enabled.\n\ngroup: advanced\nquestion: Should enabling/disabling the layer be saved (locally or in the cloud)?\nsuggestions: return [{if: \"value=no\", then: \"Don't save, always revert to the default\"}, {if: \"value=local\", then: \"Save selection in local storage\"}, {if: \"value=theme-only\", then: \"Save the state in the OSM-usersettings, but apply on this theme only (default)\"}, {if: \"value=global\", then: \"Save in OSM-usersettings and toggle on _all_ themes using this layer\"}]",
"enum": [
"global",
"local",
@@ -2141,13 +2171,17 @@
"type": "string"
},
"#": {
- "description": "Used for comments and/or to disable some checks\n\nno-question-hint-check: disables a check in MiscTagRenderingChecks which complains about 'div', 'span' or 'class=subtle'-HTML elements in the tagRendering",
+ "description": "Used for comments and/or to disable some checks\n\nno-question-hint-check: disables a check in MiscTagRenderingChecks which complains about 'div', 'span' or 'class=subtle'-HTML elements in the tagRendering\n\ngroup: hidden",
"type": "string"
+ },
+ "fullNodeDatabase": {
+ "description": "_Set automatically by MapComplete, please ignore_\n\ngroup: hidden",
+ "type": "boolean"
}
},
"required": [
"id",
- "mapRendering",
+ "pointRendering",
"source"
],
"additionalProperties": false
@@ -2156,11 +2190,11 @@
"type": "object",
"properties": {
"id": {
- "description": "The id of this layer.\nThis should be a simple, lowercase, human readable string that is used to identify the layer.",
+ "description": "question: What is the identifier of this layer?\n\nThis should be a simple, lowercase, human readable string that is used to identify the layer.\n A good ID is:\n - a noun\n - written in singular\n - describes the object\n - in english\n - only has lowercase letters, numbers or underscores. Do not use a space or a dash\n\ntype: id\ngroup: Basic",
"type": "string"
},
"name": {
- "description": "The name of this layer\nUsed in the layer control panel and the 'Personal theme'.\n\nIf not given, will be hidden (and thus not toggable) in the layer control",
+ "description": "Used in the layer control panel to toggle a layer on and of.\n\nifunset: This will hide the layer in the layer control, making it not filterable and not toggleable\n\ngroup: Basic\nquestion: What is the name of this layer?",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -2171,7 +2205,7 @@
]
},
"description": {
- "description": "A description for this layer.\nShown in the layer selections and in the personel theme",
+ "description": "A description for the features shown in this layer.\nThis often resembles the introduction of the wiki.osm.org-page for this feature.\n\ngroup: Basic\nquestion: How would you describe the features that are shown on this layer?",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -2182,17 +2216,17 @@
]
},
"source": {
- "description": "This determines where the data for the layer is fetched: from OSM or from an external geojson dataset.\n\nIf no 'geojson' is defined, data will be fetched from overpass and the OSM-API.\n\nEvery source _must_ define which tags _must_ be present in order to be picked up.\n\nNote: a source must always be defined. 'special' is only allowed if this is a builtin-layer",
+ "description": "Question: Where should the data be fetched from?\ntitle: Data Source\n\nThis determines where the data for the layer is fetched: from OSM or from an external geojson dataset.\n\nIf no 'geojson' is defined, data will be fetched from overpass and the OSM-API.\n\nEvery source _must_ define which tags _must_ be present in order to be picked up.\n\nNote: a source must always be defined. 'special' is only allowed if this is a builtin-layer\n\ntypes: Load data with specific tags from OpenStreetMap ; Load data from an external geojson source ;\ntypesdefault: 0\ngroup: Basic",
"anyOf": [
{
"type": "object",
"properties": {
"osmTags": {
"$ref": "#/definitions/TagConfigJson",
- "description": "Every source must set which tags have to be present in order to load the given layer."
+ "description": "question: Which tags must be present on the feature to show it in this layer?\nEvery source must set which tags have to be present in order to load the given layer."
},
"maxCacheAge": {
- "description": "The maximum amount of seconds that a tile is allowed to linger in the cache",
+ "description": "question: How long (in seconds) is the data allowed to remain cached until it must be refreshed?\nThe maximum amount of seconds that a tile is allowed to linger in the cache\n\ntype: nat\ndefault: 30 days",
"type": "number"
}
},
@@ -2204,23 +2238,23 @@
"type": "object",
"properties": {
"geoJson": {
- "description": "The actual source of the data to load, if loaded via geojson.\n\n# A single geojson-file\nsource: {geoJson: \"https://my.source.net/some-geo-data.geojson\"}\n fetches a geojson from a third party source\n\n# A tiled geojson source\nsource: {geoJson: \"https://my.source.net/some-tile-geojson-{layer}-{z}-{x}-{y}.geojson\", geoJsonZoomLevel: 14}\n to use a tiled geojson source. The web server must offer multiple geojsons. {z}, {x} and {y} are substituted by the location; {layer} is substituted with the id of the loaded layer\n\nSome API's use a BBOX instead of a tile, this can be used by specifying {y_min}, {y_max}, {x_min} and {x_max}",
+ "description": "The actual source of the data to load, if loaded via geojson.\n\n# A single geojson-file\nsource: {geoJson: \"https://my.source.net/some-geo-data.geojson\"}\n fetches a geojson from a third party source\n\n# A tiled geojson source\nsource: {geoJson: \"https://my.source.net/some-tile-geojson-{layer}-{z}-{x}-{y}.geojson\", geoJsonZoomLevel: 14}\n to use a tiled geojson source. The web server must offer multiple geojsons. {z}, {x} and {y} are substituted by the location; {layer} is substituted with the id of the loaded layer\n\nSome API's use a BBOX instead of a tile, this can be used by specifying {y_min}, {y_max}, {x_min} and {x_max}\n\nquestion: What is the URL of the geojson?\ntype: url",
"type": "string"
},
"geoJsonZoomLevel": {
- "description": "To load a tiled geojson layer, set the zoomlevel of the tiles",
+ "description": "To load a tiled geojson layer, set the zoomlevel of the tiles\n\nquestion: If using a tiled geojson, what is the zoomlevel of the tiles?\nifunset: This is not a tiled geojson",
"type": "number"
},
"isOsmCache": {
- "description": "Indicates that the upstream geojson data is OSM-derived.\nUseful for e.g. merging or for scripts generating this cache",
+ "description": "Indicates that the upstream geojson data is OSM-derived.\nUseful for e.g. merging or for scripts generating this cache.\nThis also indicates that making changes on this data is possible\n\nquestion: Is this geojson a cache of OpenStreetMap data?\nifunset: This is not an OpenStreetMap cache\niftrue: this is based on OpenStreetMap and can thus be edited",
"type": "boolean"
},
"mercatorCrs": {
- "description": "Some API's use a mercator-projection (EPSG:900913) instead of WGS84. Set the flag `mercatorCrs: true` in the source for this",
+ "description": "Some API's use a mercator-projection (EPSG:900913) instead of WGS84. Set the flag `mercatorCrs: true` in the source for this\n\nquestion: Does this geojson use EPSG:900913 instead of WGS84 as projection?\niftrue: This geojson uses EPSG:900913 instead of WGS84\nifunset: This geojson uses WGS84 just like most geojson (default)",
"type": "boolean"
},
"idKey": {
- "description": "Some API's have an id-field, but give it a different name.\nSetting this key will rename this field into 'id'",
+ "description": "Some API's have an id-field, but give it a different name.\nSetting this key will rename this field into 'id'\n\nifunset: An id with key `id` will be assigned automatically if no attribute `id` is set\ninline: This geojson uses {value} as attribute to set the id\nquestion: What is the name of the attribute containing the ID of the object?",
"type": "string"
}
},
@@ -2238,51 +2272,44 @@
]
},
"calculatedTags": {
- "description": "A list of extra tags to calculate, specified as \"keyToAssignTo=javascript-expression\".\nThere are a few extra functions available. Refer to Docs/CalculatedTags.md for more information\nThe functions will be run in order, e.g.\n[\n \"_max_overlap_m2=Math.max(...feat.overlapsWith(\"someOtherLayer\").map(o => o.overlap))\n \"_max_overlap_ratio=Number(feat._max_overlap_m2)/feat.area\n]\n\nThe specified tags are evaluated lazily. E.g. if a calculated tag is only used in the popup (e.g. the number of nearby features),\nthe expensive calculation will only be performed then for that feature. This avoids clogging up the contributors PC when all features are loaded.\n\nIf a tag has to be evaluated strictly, use ':=' instead:\n\n[\n\"_some_key:=some_javascript_expression\"\n]",
+ "description": "A list of extra tags to calculate, specified as \"keyToAssignTo=javascript-expression\".\nThere are a few extra functions available. Refer to Docs/CalculatedTags.md for more information\nThe functions will be run in order, e.g.\n[\nNot found... * \"_max_overlap_m2=Math.max(...feat.overlapsWith(\"someOtherLayer\").map(o => o.overlap))\n \"_max_overlap_ratio=Number(feat._max_overlap_m2)/feat.area\n]\n\nThe specified tags are evaluated lazily. E.g. if a calculated tag is only used in the popup (e.g. the number of nearby features),\nthe expensive calculation will only be performed then for that feature. This avoids clogging up the contributors PC when all features are loaded.\n\nIf a tag has to be evaluated strictly, use ':=' instead:\n\n[\n\"_some_key:=some_javascript_expression\"\n]\n\nSee the full documentation on [https://github.com/pietervdvn/MapComplete/blob/master/Docs/CalculatedTags.md]\n\ngroup: expert\nquestion: What extra attributes should be calculated with javascript?",
"type": "array",
"items": {
"type": "string"
}
},
- "doNotDownload": {
- "description": "If set, this layer will not query overpass; but it'll still match the tags above which are by chance returned by other layers.\nWorks well together with 'passAllFeatures', to add decoration",
- "type": "boolean"
- },
"isShown": {
- "description": "If set, only features matching this extra tag will be shown.\nThis is useful to hide certain features from view.\n\nImportant: hiding features does not work dynamically, but is only calculated when the data is first renders.\nThis implies that it is not possible to hide a feature after a tagging change\n\nThe default value is 'yes'",
+ "description": "If set, only features matching this extra tag will be shown.\nThis is useful to hide certain features from view based on a calculated tag or if the features are provided by a different layer.\n\nquestion: What other tags should features match for being shown?\ngroup: advanced\nifunset: all features which match the 'source'-specification are shown.",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
}
]
},
- "forceLoad": {
- "description": "Advanced option - might be set by the theme compiler\n\nIf true, this data will _always_ be loaded, even if the theme is disabled",
- "type": "boolean"
- },
"minzoom": {
- "description": "The minimum needed zoomlevel required before loading of the data start\nDefault: 0",
+ "description": "The minimum needed zoomlevel required to start loading and displaying the data.\nThis can be used to only show common features (e.g. a bicycle parking) only when the map is zoomed in very much (17).\nThis prevents cluttering the map with thousands of parkings if one is looking to an entire city.\n\nDefault: 0\ngroup: Basic\ntype: nat\nquestion: At what zoom level should features of the layer be shown?\nifunset: Always load this layer, even if the entire world is in view.",
"type": "number"
},
"shownByDefault": {
- "description": "Indicates if this layer is shown by default;\ncan be used to hide a layer from start, or to load the layer but only to show it where appropriate (e.g. for snapping to it)",
+ "description": "Indicates if this layer is shown by default;\ncan be used to hide a layer from start, or to load the layer but only to show it when appropriate (e.g. for advanced users)\n\nquestion: Should this layer be enabled when opening the map for the first time?\niftrue: the layer is enabled when opening the map\niffalse: the layer is hidden until the contributor enables it. (If the filter-popup is disabled, this might never get enabled nor loaded)\ndefault: true\ngroup: advanced",
"type": "boolean"
},
"minzoomVisible": {
- "description": "The zoom level at which point the data is hidden again\nDefault: 100 (thus: always visible",
+ "description": "The zoom level at which point the data is hidden again\nDefault: 100 (thus: always visible\n\ngroup: expert",
"type": "number"
},
"title": {
- "description": "The title shown in a popup for elements of this layer.",
+ "description": "question: What title should be shown on the infobox?\nThe title shown in a popup for elements of this layer.\n\ngroup: title\ntypes: use a fixed translation ; Use a dynamic tagRendering ; hidden\ntypesdefault: 1\ntype: translation\ninline: {translated{value}}",
"anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
{
"$ref": "#/definitions/TagRenderingConfigJson"
},
@@ -2291,8 +2318,12 @@
}
]
},
+ "popupInFloatover": {
+ "description": "Question: Should the information for this layer be shown in the sidebar or in a splash screen?\n\nIf set, open the selectedElementView in a floatOver instead of on the right.\n\niftrue: show the infobox in the splashscreen floating over the entire UI\niffalse: show the infobox in a sidebar on the right\ngroup: advanced\ndefault: sidebar",
+ "type": "boolean"
+ },
"titleIcons": {
- "description": "Small icons shown next to the title.\nIf not specified, the OsmLink and wikipedia links will be used by default.\nUse an empty array to hide them.\nNote that \"defaults\" will insert all the default titleIcons (which are added automatically)\n\nType: icon[]",
+ "description": "Small icons shown next to the title.\nIf not specified, the OsmLink and wikipedia links will be used by default.\nUse an empty array to hide them.\nNote that \"defaults\" will insert all the default titleIcons (which are added automatically)\n\nType: icon[]\ngroup: infobox",
"anyOf": [
{
"type": "array",
@@ -2322,42 +2353,40 @@
}
]
},
- "mapRendering": {
- "description": "Visualisation of the items on the map",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "anyOf": [
- {
- "$ref": "#/definitions/default_4"
- },
- {
- "$ref": "#/definitions/default_5"
- },
- {
- "$ref": "#/definitions/default"
- }
- ]
- }
- },
- {
- "type": "null"
- }
- ]
+ "pointRendering": {
+ "description": "Creates points to render on the map.\nThis can render points for point-objects, lineobjects or areaobjects; use 'location' to indicate where it should be rendered\ngroup: pointrendering",
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/default_4"
+ }
+ },
+ "lineRendering": {
+ "description": "Creates lines and areas to render on the map\ngroup: linerendering",
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/default_5"
+ }
},
"passAllFeatures": {
- "description": "If set, this layer will pass all the features it receives onto the next layer.\nThis is ideal for decoration, e.g. directionss on cameras",
+ "description": "If set, this layer will pass all the features it receives onto the next layer.\nThis is ideal for decoration, e.g. directions on cameras\niftrue: Make the features from this layer also available to the other layer; might result in this object being rendered by multiple layers\niffalse: normal behaviour: don't pass features allong\nquestion: should this layer pass features to the next layers?\ngroup: expert",
+ "type": "boolean"
+ },
+ "doNotDownload": {
+ "description": "If set, this layer will not query overpass; but it'll still match the tags above which are by chance returned by other layers.\nWorks well together with 'passAllFeatures', to add decoration\nThe opposite of `forceLoad`\n\niftrue: Do not attempt to query the data for this layer from overpass/the OSM API\niffalse: download the data as usual\ngroup: expert\nquestion: Should this layer be downloaded or is the data provided by a different layer (which has 'passAllFeatures'-set)?\ndefault: false",
+ "type": "boolean"
+ },
+ "forceLoad": {
+ "description": "Advanced option - might be set by the theme compiler\n\nIf true, this data will _always_ be loaded, even if the theme is disabled by a filter or hidden.\nThe opposite of `doNotDownload`\n\nquestion: Should this layer be forcibly loaded?\nifftrue: always download this layer, even if it is disabled\niffalse: only download data for this layer when needed (default)\ndefault: false\ngroup: expert",
"type": "boolean"
},
"presets": {
- "description": "Presets for this layer.\nA preset shows up when clicking the map on a without data (or when right-clicking/long-pressing);\nit will prompt the user to add a new point.\n\nThe most important aspect are the tags, which define which tags the new point will have;\nThe title is shown in the dialog, along with the first sentence of the description.\n\nUpon confirmation, the full description is shown beneath the buttons - perfect to add pictures and examples.\n\nNote: the icon of the preset is determined automatically based on the tags and the icon above. Don't worry about that!\nNB: if no presets are defined, the popup to add new points doesn't show up at all",
+ "description": "Presets for this layer.\nA preset shows up when clicking the map on a without data (or when right-clicking/long-pressing);\nit will prompt the user to add a new point.\n\nThe most important aspect are the tags, which define which tags the new point will have;\nThe title is shown in the dialog, along with the first sentence of the description.\n\nUpon confirmation, the full description is shown beneath the buttons - perfect to add pictures and examples.\n\nNote: the icon of the preset is determined automatically based on the tags and the icon above. Don't worry about that!\nNB: if no presets are defined, the popup to add new points doesn't show up at all\n\ngroup: presets",
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
- "description": "The title - shown on the 'add-new'-button.\n\nThis should include the article of the noun, e.g. 'a hydrant', 'a bicycle pump'.\nThis text will be inserted into `Add {category} here`, becoming `Add a hydrant here`.\n\nDo _not_ indicate 'new': 'add a new shop here' is incorrect, as the shop might have existed forever, it could just be unmapped!",
+ "description": "The title - shown on the 'add-new'-button.\n\nThis should include the article of the noun, e.g. 'a hydrant', 'a bicycle pump'.\nThis text will be inserted into `Add {category} here`, becoming `Add a hydrant here`.\n\nDo _not_ indicate 'new': 'add a new shop here' is incorrect, as the shop might have existed forever, it could just be unmapped!\n\nquestion: What is the word to describe this object?\ninline: Add {translated(value)::font-bold} here",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -2368,14 +2397,14 @@
]
},
"tags": {
- "description": "The tags to add. It determines the icon too",
+ "description": "A single tag (encoded as key=value
) out of all the tags to add onto the newly created point.\nNote that the icon in the UI will be chosen automatically based on the tags provided here.\n\nquestion: What tag should be added to the new object?\ntype: simple_tag\ntypeHelper: uploadableOnly",
"type": "array",
"items": {
"type": "string"
}
},
"description": {
- "description": "The _first sentence_ of the description is shown on the button of the `add` menu.\nThe full description is shown in the confirmation dialog.\n\n(The first sentence is until the first '.'-character in the description)",
+ "description": "An extra explanation of what the feature is, if it is not immediately clear from the title alone.\n\nThe _first sentence_ of the description is shown on the button of the `add` menu.\nThe full description is shown in the confirmation dialog.\n\n(The first sentence is until the first '.'-character in the description)\n\nquestion: How would you describe this feature?",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -2386,59 +2415,22 @@
]
},
"exampleImages": {
- "description": "Example images, which show real-life pictures of what such a feature might look like\n\nType: image",
+ "description": "The URL of an example image which shows a real-life example of what such a feature might look like.\n\nType: image\nquestion: What is the URL of an image showing such a feature?",
"type": "array",
"items": {
"type": "string"
}
},
- "preciseInput": {
- "description": "If set, the user will prompted to confirm the location before actually adding the data.\nThis will be with a 'drag crosshair'-method.\n\nIf 'preferredBackgroundCategory' is set, the element will attempt to pick a background layer of that category.",
- "anyOf": [
- {
- "type": "object",
- "properties": {
- "preferredBackground": {
- "description": "The type of background picture",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "snapToLayer": {
- "description": "If specified, these layers will be shown to and the new point will be snapped towards it",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "maxSnapDistance": {
- "description": "If specified, a new point will only be snapped if it is within this range.\nDistance in meter\n\nDefault: 10",
- "type": "number"
- }
- }
- },
- {
- "enum": [
- true
- ],
- "type": "boolean"
- }
- ]
+ "snapToLayer": {
+ "description": "question: Should the created point be snapped to a line layer?\n\nIf specified, these layers will be shown in the precise location picker and the new point will be snapped towards it.\nFor example, this can be used to snap against `walls_and_buildings` (e.g. to attach a defibrillator, an entrance, an artwork, ... to the wall)\nor to snap an obstacle (such as a bollard) to the `cycleways_and_roads`.\n\nsuggestions: return Array.from(layers.keys()).map(key => ({if: \"value=\"+key, then: key+\" - \"+layers.get(key).description}))",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "maxSnapDistance": {
+ "description": "question: What is the maximum distance in the location-input that a point can be moved to be snapped to a way?\n\ninline: a point is snapped if the location input is at most {value}m away from an object\n\nIf specified, a new point will only be snapped if it is within this range.\nIf further away, it'll be placed in the center of the location input\nDistance in meter\n\nifunset: Do not snap to a layer",
+ "type": "number"
}
},
"required": [
@@ -2448,7 +2440,7 @@
}
},
"tagRenderings": {
- "description": "All the tag renderings.\nA tag rendering is a block that either shows the known value or asks a question.\n\nRefer to the class `TagRenderingConfigJson` to see the possibilities.\n\nNote that we can also use a string here - where the string refers to a tag rendering defined in `assets/questions/questions.json`,\nwhere a few very general questions are defined e.g. website, phone number, ...\nFurthermore, _all_ the questions of another layer can be reused with `otherlayer.*`\nIf you need only a single of the tagRenderings, use `otherlayer.tagrenderingId`\nIf one or more questions have a 'group' or 'label' set, select all the entries with the corresponding group or label with `otherlayer.*group`\nRemark: if a tagRendering is 'lent' from another layer, the 'source'-tags are copied and added as condition.\nIf they are not wanted, remove them with an override\n\nA special value is 'questions', which indicates the location of the questions box. If not specified, it'll be appended to the bottom of the featureInfobox.\n\nAt last, one can define a group of renderings where parts of all strings will be replaced by multiple other strings.\nThis is mainly create questions for a 'left' and a 'right' side of the road.\nThese will be grouped and questions will be asked together",
+ "description": "question: Which tagRenderings should be shown in the infobox?\n\nA tag rendering is a block that either shows the known value or asks a question.\n\nRefer to the class `TagRenderingConfigJson` to see the possibilities.\n\nNote that we can also use a string here - where the string refers to a tag rendering defined in `assets/questions/questions.json`,\nwhere a few very general questions are defined e.g. website, phone number, ...\nFurthermore, _all_ the questions of another layer can be reused with `otherlayer.*`\nIf you need only a single of the tagRenderings, use `otherlayer.tagrenderingId`\nIf one or more questions have a 'group' or 'label' set, select all the entries with the corresponding group or label with `otherlayer.*group`\nRemark: if a tagRendering is 'lent' from another layer, the 'source'-tags are copied and added as condition.\nIf they are not wanted, remove them with an override\n\nA special value is 'questions', which indicates the location of the questions box. If not specified, it'll be appended to the bottom of the featureInfobox.\n\nAt last, one can define a group of renderings where parts of all strings will be replaced by multiple other strings.\nThis is mainly create questions for a 'left' and a 'right' side of the road.\nThese will be grouped and questions will be asked together\n\ntype: tagrendering[]\ngroup: tagrenderings",
"type": "array",
"items": {
"anyOf": [
@@ -2508,7 +2500,7 @@
}
},
"filter": {
- "description": "All the extra questions for filtering.\nIf a string is given, mapComplete will search in 'filters.json' for the appropriate filter or will try to parse it as `layername.filterid` and us that one",
+ "description": "All the extra questions for filtering.\nIf a string is given, mapComplete will search in 'filters.json' for the appropriate filter or will try to parse it as `layername.filterid` and us that one\n\ngroup: filters",
"anyOf": [
{
"type": "array",
@@ -2537,7 +2529,7 @@
]
},
"deletion": {
- "description": "This block defines under what circumstances the delete dialog is shown for objects of this layer.\nIf set, a dialog is shown to the user to (soft) delete the point.\nThe dialog is built to be user friendly and to prevent mistakes.\nIf deletion is not possible, the dialog will hide itself and show the reason of non-deletability instead.\n\nTo configure, the following values are possible:\n\n- false: never ever show the delete button\n- true: show the default delete button\n- undefined: use the mapcomplete default to show deletion or not. Currently, this is the same as 'false' but this will change in the future\n- or: a hash with options (see below)\n\n The delete dialog\n =================\n\n\n\n#### Hard deletion if enough experience\n\nA feature can only be deleted from OpenStreetMap by mapcomplete if:\n\n- It is a node\n- No ways or relations use the node\n- The logged-in user has enough experience OR the user is the only one to have edited the point previously\n- The logged-in user has no unread messages (or has a ton of experience)\n- The user did not select one of the 'non-delete-options' (see below)\n\nIn all other cases, a 'soft deletion' is used.\n\n#### Soft deletion\n\nA 'soft deletion' is when the point isn't deleted from OSM but retagged so that it'll won't how up in the mapcomplete theme anymore.\nThis makes it look like it was deleted, without doing damage. A fixme will be added to the point.\n\nNote that a soft deletion is _only_ possible if these tags are provided by the theme creator, as they'll be different for every theme\n\n#### No-delete options\n\nIn some cases, the contributor might want to delete something for the wrong reason (e.g. someone who wants to have a path removed \"because the path is on their private property\").\nHowever, the path exists in reality and should thus be on OSM - otherwise the next contributor will pass by and notice \"hey, there is a path missing here! Let me redraw it in OSM!)\n\nThe correct approach is to retag the feature in such a way that it is semantically correct *and* that it doesn't show up on the theme anymore.\nA no-delete option is offered as 'reason to delete it', but secretly retags.",
+ "description": "This block defines under what circumstances the delete dialog is shown for objects of this layer.\nIf set, a dialog is shown to the user to (soft) delete the point.\nThe dialog is built to be user friendly and to prevent mistakes.\nIf deletion is not possible, the dialog will hide itself and show the reason of non-deletability instead.\n\nTo configure, the following values are possible:\n\n- false: never ever show the delete button\n- true: show the default delete button\n- undefined: use the mapcomplete default to show deletion or not. Currently, this is the same as 'false' but this will change in the future\n- or: a hash with options (see below)\n\n### The delete dialog\n\n\n\n#### Hard deletion if enough experience\n\nA feature can only be deleted from OpenStreetMap by mapcomplete if:\n\n- It is a node\n- No ways or relations use the node\n- The logged-in user has enough experience OR the user is the only one to have edited the point previously\n- The logged-in user has no unread messages (or has a ton of experience)\n- The user did not select one of the 'non-delete-options' (see below)\n\nIn all other cases, a 'soft deletion' is used.\n\n#### Soft deletion\n\nA 'soft deletion' is when the point isn't deleted fromOSM but retagged so that it'll won't how up in the mapcomplete theme anymore.\nThis makes it look like it was deleted, without doing damage. A fixme will be added to the point.\n\nNote that a soft deletion is _only_ possible if these tags are provided by the theme creator, as they'll be different for every theme\n\n##### No-delete options\n\nIn some cases, the contributor might want to delete something for the wrong reason (e.g. someone who wants to have a path removed \"because the path is on their private property\").\nHowever, the path exists in reality and should thus be on OSM - otherwise the next contributor will pass by and notice \"hey, there is a path missing here! Let me redraw it in OSM!)\n\nThe correct approach is to retag the feature in such a way that it is semantically correct *and* that it doesn't show up on the theme anymore.\nA no-delete option is offered as 'reason to delete it', but secretly retags.\n\ngroup: editing\ntypes: Use an advanced delete configuration ; boolean\niftrue: Allow deletion\niffalse: Do not allow deletion\nifunset: Do not allow deletion",
"anyOf": [
{
"$ref": "#/definitions/DeleteConfigJson"
@@ -2548,7 +2540,7 @@
]
},
"allowMove": {
- "description": "Indicates if a point can be moved and configures the modalities.\n\nA feature can be moved by MapComplete if:\n\n- It is a point\n- The point is _not_ part of a way or a a relation.\n\nOff by default. Can be enabled by setting this flag or by configuring.",
+ "description": "Indicates if a point can be moved and why.\n\nA feature can be moved by MapComplete if:\n\n- It is a point\n- The point is _not_ part of a way or a a relation.\n\ntypes: use an advanced move configuration ; boolean\ngroup: editing\nquestion: Is deleting a point allowed?\niftrue: Allow contributors to move a point (for accuracy or a relocation)\niffalse: Don't allow contributors to move points\nifunset: Don't allow contributors to move points (default)",
"anyOf": [
{
"$ref": "#/definitions/default_3"
@@ -2559,7 +2551,7 @@
]
},
"allowSplit": {
- "description": "If set, a 'split this way' button is shown on objects rendered as LineStrings, e.g. highways.\n\nIf the way is part of a relation, MapComplete will attempt to update this relation as well",
+ "description": "If set, a 'split this way' button is shown on objects rendered as LineStrings, e.g. highways.\n\nIf the way is part of a relation, MapComplete will attempt to update this relation as well\nquestion: Should the contributor be able to split ways using this layer?\niftrue: enable the 'split-roads'-component\niffalse: don't enable the split-roads componenet\nifunset: don't enable the split-roads component\ngroup: editing",
"type": "boolean"
},
"units": {
@@ -2569,7 +2561,7 @@
}
},
"syncSelection": {
- "description": "If set, synchronizes whether or not this layer is enabled.\n\nno: Do not sync at all, always revert to default\nlocal: keep selection on local storage\ntheme-only: sync via OSM, but this layer will only be toggled in this theme\nglobal: all layers with this ID will be synced accross all themes",
+ "description": "If set, synchronizes whether or not this layer is enabled.\n\ngroup: advanced\nquestion: Should enabling/disabling the layer be saved (locally or in the cloud)?\nsuggestions: return [{if: \"value=no\", then: \"Don't save, always revert to the default\"}, {if: \"value=local\", then: \"Save selection in local storage\"}, {if: \"value=theme-only\", then: \"Save the state in the OSM-usersettings, but apply on this theme only (default)\"}, {if: \"value=global\", then: \"Save in OSM-usersettings and toggle on _all_ themes using this layer\"}]",
"enum": [
"global",
"local",
@@ -2579,8 +2571,12 @@
"type": "string"
},
"#": {
- "description": "Used for comments and/or to disable some checks\n\nno-question-hint-check: disables a check in MiscTagRenderingChecks which complains about 'div', 'span' or 'class=subtle'-HTML elements in the tagRendering",
+ "description": "Used for comments and/or to disable some checks\n\nno-question-hint-check: disables a check in MiscTagRenderingChecks which complains about 'div', 'span' or 'class=subtle'-HTML elements in the tagRendering\n\ngroup: hidden",
"type": "string"
+ },
+ "fullNodeDatabase": {
+ "description": "_Set automatically by MapComplete, please ignore_\n\ngroup: hidden",
+ "type": "boolean"
}
},
"additionalProperties": false
@@ -2589,16 +2585,30 @@
"type": "object",
"properties": {
"icon": {
+ "description": "question: What icon should be shown in the link button?\nifunset: do not show an icon\ntype: icon",
"type": "string"
},
- "text": {},
+ "text": {
+ "description": "question: What text should be shown in the link icon?\n\nNote that {lat},{lon},{zoom}, {language} and {theme} will be replaced\n\nifunset: do not show a text",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
"href": {
+ "description": "question: if clicked, what webpage should open?\nNote that {lat},{lon},{zoom}, {language} and {theme} will be replaced\n\ntype: url",
"type": "string"
},
"newTab": {
+ "description": "question: Should the link open in a new tab?\niftrue: Open in a new tab\niffalse: do not open in a new tab\nifunset: do not open in a new tab",
"type": "boolean"
},
"requirements": {
+ "description": "question: When should the extra button be shown?\nsuggestions: return [{if: \"value=iframe\", then: \"When shown in an iframe\"}, {if: \"value=no-iframe\", then: \"When shown as stand-alone webpage\"}, {if: \"value=welcome-message\", then: \"When the welcome messages are enabled\"}, {if: \"value=iframe\", then: \"When the welcome messages are disabled\"}]",
"type": "array",
"items": {
"enum": [
@@ -2619,4 +2629,4 @@
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
-}
+}
\ No newline at end of file
diff --git a/Docs/Schemas/LayoutConfigJsonJSC.ts b/Docs/Schemas/LayoutConfigJsonJSC.ts
index 8e2dd5229c..244a561c59 100644
--- a/Docs/Schemas/LayoutConfigJsonJSC.ts
+++ b/Docs/Schemas/LayoutConfigJsonJSC.ts
@@ -3,12 +3,22 @@ export default {
"type": "object",
"properties": {
"id": {
- "description": "The id of this layout.\n\nThis is used as hashtag in the changeset message, which will read something like \"Adding data with #mapcomplete for theme #\"\nMake sure it is something decent and descriptive, it should be a simple, lowercase string.\n\nOn official themes, it'll become the name of the page, e.g.\n'cyclestreets' which become 'cyclestreets.html'",
+ "description": "question: What is the id of this layout?\n\nThe id is a unique string to identify the theme\n\nIt should be\n- in english\n- describe the theme in a single word (or a few words)\n- all lowercase and with only [a-z] or underscores (_)\n\nThis is used as hashtag in the changeset message, which will read something like \"Adding data with #mapcomplete for theme #\"\n\nOn official themes, it'll become the name of the page, e.g.\n'cyclestreets' which become 'cyclestreets.html'\n\ntype: id\ngroup: basic",
"type": "string"
},
"credits": {
"description": "Who helped to create this theme and should be attributed?",
- "type": "string"
+ "anyOf": [
+ {
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ {
+ "type": "string"
+ }
+ ]
},
"mustHaveLanguage": {
"description": "Only used in 'generateLayerOverview': if present, every translation will be checked to make sure it is fully translated.\n\nThis must be a list of two-letter, lowercase codes which identifies the language, e.g. \"en\", \"nl\", ...",
@@ -18,7 +28,7 @@ export default {
}
},
"title": {
- "description": "The title, as shown in the welcome message and the more-screen.",
+ "description": "question: What is the title of this theme?\n\nThe human-readable title, as shown in the welcome message and the index page\ngroup: basic",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -29,7 +39,7 @@ export default {
]
},
"shortDescription": {
- "description": "A short description, showed as social description and in the 'more theme'-buttons.\nNote that if this one is not defined, the first sentence of 'description' is used",
+ "description": "A short description, showed as social description and in the 'more theme'-buttons.\nNote that if this one is not defined, the first sentence of 'description' is used\ngroup: hidden",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -40,7 +50,7 @@ export default {
]
},
"description": {
- "description": "The description, as shown in the welcome message and the more-screen",
+ "description": "question: How would you describe this theme?\nThe description, as shown in the welcome message and the more-screen\ngroup: basic",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -51,7 +61,7 @@ export default {
]
},
"descriptionTail": {
- "description": "A part of the description, shown under the login-button.",
+ "description": "A part of the description, shown under the login-button.\ngroup: hidden",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -62,21 +72,23 @@ export default {
]
},
"icon": {
- "description": "The icon representing this theme.\nUsed as logo in the more-screen and (for official themes) as favicon, webmanifest logo, ...\nEither a URL or a base64 encoded value (which should include 'data:image/svg+xml;base64)\n\nType: icon",
+ "description": "question: What icon should be used to represent this theme?\n\nUsed as logo in the more-screen and (for official themes) as favicon, webmanifest logo, ...\n\nEither a URL or a base64 encoded value (which should include 'data:image/svg+xml;base64)\n\nType: icon\ngroup: basic",
"type": "string"
},
"socialImage": {
- "description": "Link to a 'social image' which is included as og:image-tag on official themes.\nUseful to share the theme on social media.\nSee https://www.h3xed.com/web-and-internet/how-to-use-og-image-meta-tag-facebook-reddit for more information$\n\nType: image",
+ "description": "question: What image should be used as social image preview?\nThis is included as og:image-tag on official themes.\n\nSee https://www.h3xed.com/web-and-internet/how-to-use-og-image-meta-tag-facebook-reddit for more information\nifunset: use the default social image of mapcomplete (or generate one based on the icon)\nType: image\ngroup: basic",
"type": "string"
},
"startZoom": {
- "description": "Default location and zoom to start.\nNote that this is barely used. Once the user has visited mapcomplete at least once, the previous location of the user will be used",
+ "description": "question: At what zoomlevel should this theme open?\nDefault location and zoom to start.\nNote that this is barely used. Once the user has visited mapcomplete at least once, the previous location of the user will be used\nifunset: Use the default startzoom (0)\ntype: float\ngroup: start_location",
"type": "number"
},
"startLat": {
+ "description": "question: At what start latitude should this theme open?\nDefault location and zoom to start.\nNote that this is barely used. Once the user has visited mapcomplete at least once, the previous location of the user will be used\nifunset: Use 0 as start latitude\ntype: float\ngroup: start_location",
"type": "number"
},
"startLon": {
+ "description": "question: At what start longitude should this theme open?\nDefault location and zoom to start.\nNote that this is barely used. Once the user has visited mapcomplete at least once, the previous location of the user will be used\nifunset: Use 0 as start longitude\ntype: float\ngroup: start_location",
"type": "number"
},
"widenFactor": {
@@ -119,7 +131,7 @@ export default {
}
},
"layers": {
- "description": "The layers to display.\n\nEvery layer contains a description of which feature to display - the overpassTags which are queried.\nInstead of running one query for every layer, the query is fused.\n\nAfterwards, every layer is given the list of features.\nEvery layer takes away the features that match with them*, and give the leftovers to the next layers.\n\nThis implies that the _order_ of the layers is important in the case of features with the same tags;\nas the later layers might never receive their feature.\n\n*layers can also remove 'leftover'-features if the leftovers overlap with a feature in the layer itself\n\nNote that builtin layers can be reused. Either put in the name of the layer to reuse, or use {builtin: \"layername\", override: ...}\n\nThe 'override'-object will be copied over the original values of the layer, which allows to change certain aspects of the layer\n\nFor example: If you would like to use layer nature reserves, but only from a specific operator (eg. Natuurpunt) you would use the following in your theme:\n\n```\n\"layer\": {\n \"builtin\": \"nature_reserve\",\n \"override\": {\"source\":\n {\"osmTags\": {\n \"+and\":[\"operator=Natuurpunt\"]\n }\n }\n }\n}\n```\n\nIt's also possible to load multiple layers at once, for example, if you would like for both drinking water and benches to start at the zoomlevel at 12, you would use the following:\n\n```\n\"layer\": {\n \"builtin\": [\"benches\", \"drinking_water\"],\n \"override\": {\"minzoom\": 12}\n}\n```",
+ "description": "question: What layers should this map show?\ntype: layer[]\ntypes: hidden | layer | hidden\ngroup: layers\nsuggestions: return Array.from(layers.keys()).map(key => ({if: \"value=\"+key, then: key+\" - \"+layers.get(key).description}))\nEvery layer contains a description of which feature to display - the overpassTags which are queried.\nInstead of running one query for every layer, the query is fused.\n\nAfterwards, every layer is given the list of features.\nEvery layer takes away the features that match with them*, and give the leftovers to the next layers.\n\nThis implies that the _order_ of the layers is important in the case of features with the same tags;\nas the later layers might never receive their feature.\n\n*layers can also remove 'leftover'-features if the leftovers overlap with a feature in the layer itself\n\nNote that builtin layers can be reused. Either put in the name of the layer to reuse, or use {builtin: \"layername\", override: ...}\n\nThe 'override'-object will be copied over the original values of the layer, which allows to change certain aspects of the layer\n\nFor example: If you would like to use layer nature reserves, but only from a specific operator (eg. Natuurpunt) you would use the following in your theme:\n\n```\n\"layer\": {\n \"builtin\": \"nature_reserve\",\n \"override\": {\"source\":\n {\"osmTags\": {\n \"+and\":[\"operator=Natuurpunt\"]\n }\n }\n }\n}\n```\n\nIt's also possible to load multiple layers at once, for example, if you would like for both drinking water and benches to start at the zoomlevel at 12, you would use the following:\n\n```\n\"layer\": {\n \"builtin\": [\"benches\", \"drinking_water\"],\n \"override\": {\"minzoom\": 12}\n}\n```",
"type": "array",
"items": {
"anyOf": [
@@ -165,7 +177,7 @@ export default {
}
},
"customCss": {
- "description": "The URL of a custom CSS stylesheet to modify the layout",
+ "description": "The URL of a custom CSS stylesheet to modify the layout\ngroup: advanced",
"type": "string"
},
"hideFromOverview": {
@@ -220,77 +232,70 @@ export default {
]
},
"extraLink": {
- "description": "Adds an additional button on the top-left of the application.\nThis can link to an arbitrary location.\n\nNote that {lat},{lon},{zoom}, {language} and {theme} will be replaced\n\nDefault: {icon: \"./assets/svg/pop-out.svg\", href: 'https://mapcomplete.org/{theme}.html?lat={lat}&lon={lon}&z={zoom}, requirements: [\"iframe\",\"no-welcome-message]},",
+ "description": "question: should an extra help button be shown in certain circumstances?\nAdds an additional button on the top-left of the application.\nThis can link to an arbitrary location.\n\nFor example {icon: \"./assets/svg/pop-out.svg\", href: 'https://mapcomplete.org/{theme}.html?lat={lat}&lon={lon}&z={zoom}, requirements: [\"iframe\",\"no-welcome-message]},\n\ngroup: advanced\nifunset: show a link to open MapComplete full screen if used in an iframe",
"$ref": "#/definitions/default"
},
"enableUserBadge": {
- "description": "If set to false, disables logging in.\nThe userbadge will be hidden, all login-buttons will be hidden and editing will be disabled",
+ "description": "question: Should a user be able to login with OpenStreetMap?\n\nIf not logged in, will not show the login buttons and hide all the editable elements.\nAs such, MapComplete will become read-only and a purely visualisation tool.\n\nifunset: Enable the possiblity to login with OpenStreetMap (default)\niffalse: Do not enable to login with OpenStreetMap, have a read-only view of MapComplete.\niftrue: Enable the possiblity to login with OpenStreetMap\ngroup: feature_switches",
"type": "boolean"
},
"enableShareScreen": {
- "description": "If false, hides the tab 'share'-tab in the welcomeMessage",
+ "description": "question: Should the tab with options to share the current screen be enabled?\n\nOn can get the iFrame embed code here\n\nifunset: Enable the sharescreen (default)\niffalse: Do not enable the share screen\niftrue: Enable the share screen\ngroup: feature_switches",
"type": "boolean"
},
"enableMoreQuests": {
- "description": "Hides the tab with more themes in the welcomeMessage",
+ "description": "question: Should the user be able to switch to different themes?\n\nTypically enabled in iframes and/or on commisioned themes\n\niftrue: enable to go back to the index page showing all themes\niffalse: do not enable to go back to the index page showing all themes; hide the 'more themes' buttons\nifunset: mapcomplete default: enable to go back to the index page showing all themes\ngroup: feature_switches",
"type": "boolean"
},
"enableLayers": {
- "description": "If false, the layer selection/filter view will be hidden\nThe corresponding URL-parameter is 'fs-filters' instead of 'fs-layers'",
+ "description": "question: Should the user be able to enable/disable layers and to filter the layers?\n\nThe corresponding URL-parameter is 'fs-filters' instead of 'fs-layers'\niftrue: enable the filters/layers pane\niffalse: do not enable to filter or to disable layers; hide the 'filter' tab from the overview and the button at the bottom-left\nifunset: mapcomplete default: enable to filter or to enable/disable layers\ngroup: feature_switches",
"type": "boolean"
},
"enableSearch": {
- "description": "If set to false, hides the search bar",
+ "description": "question: Should the user be able to search for locations?\n\nifunset: MapComplete default: allow to search\niftrue: Allow to search\niffalse: Do not allow to search; hide the search-bar\ngroup: feature_switches",
"type": "boolean"
},
"enableAddNewPoints": {
- "description": "If set to false, the ability to add new points or nodes will be disabled.\nEditing already existing features will still be possible",
+ "description": "question: Should the user be able to add new points?\n\nAdding new points is only possible if the loaded layers have presets set.\nSome layers do not have presets. If the theme only has layers without presets, then adding new points will not be possible.\n\nifunset: MapComplete default: allow to create new points\niftrue: Allow to create new points\niffalse: Do not allow to create new points, even if the layers in this theme support creating new points\ngroup: feature_switches",
"type": "boolean"
},
"enableGeolocation": {
- "description": "If set to false, the 'geolocation'-button will be hidden.",
+ "description": "question: Should the user be able to use their GPS to geolocate themselfes on the map?\nifunset: MapComplete default: allow to use the GPS\niftrue: Allow to use the GPS\niffalse: Do not allow to use the GPS, hide the geolocation-buttons\ngroup: feature_switches",
"type": "boolean"
},
"enableBackgroundLayerSelection": {
- "description": "Enable switching the backgroundlayer.\nIf false, the quickswitch-buttons are removed (bottom left) and the dropdown in the layer selection is removed as well",
+ "description": "Enable switching the backgroundlayer.\nIf false, the quickswitch-buttons are removed (bottom left) and the dropdown in the layer selection is removed as well\n\nquestion: Should the user be able to switch the background layer?\n\niftrue: Allow to switch the background layer\niffalse: Do not allow to switch the background layer\nifunset: MapComplete default: Allow to switch the background layer\ngroup: feature_switches",
"type": "boolean"
},
"enableShowAllQuestions": {
- "description": "If set to true, will show _all_ unanswered questions in a popup instead of just the next one",
+ "description": "question: Should the questions about a feature be presented one by one or all at once?\niftrue: Show all unanswered questions at the same time\niffalse: Show unanswered questions one by one\nifunset: MapComplete default: Use the preference of the user to show questions at the same time or one by one\ngroup: feature_switches",
"type": "boolean"
},
"enableDownload": {
- "description": "If set to true, download button for the data will be shown (offers downloading as geojson and csv)",
+ "description": "question: Should the 'download as CSV'- and 'download as Geojson'-buttons be enabled?\niftrue: Enable the option to download the map as CSV and GeoJson\niffalse: Enable the option to download the map as CSV and GeoJson\nifunset: MapComplete default: Enable the option to download the map as CSV and GeoJson\ngroup: feature_switches",
"type": "boolean"
},
"enablePdfDownload": {
- "description": "If set to true, exporting a pdf is enabled",
+ "description": "question: Should the 'download as PDF'-button be enabled?\niftrue: Enable the option to download the map as PDF\niffalse: Enable the option to download the map as PDF\nifunset: MapComplete default: Enable the option to download the map as PDF\ngroup: feature_switches",
"type": "boolean"
},
"enableNoteImports": {
- "description": "If true, notes will be loaded and parsed. If a note is an import (as created by the import_helper.html-tool from mapcomplete),\nthese notes will be shown if a relevant layer is present.\n\nDefault is true for official layers and false for unofficial (sideloaded) layers",
+ "description": "question: Should the 'notes' from OpenStreetMap be loaded and parsed for import helper notes?\nIf true, notes will be loaded and parsed. If a note is an import (as created by the import_helper.html-tool from mapcomplete),\nthese notes will be shown if a relevant layer is present.\n\nifunset: MapComplete default: do not load import notes for sideloaded themes but do load them for official themes\niftrue: Load notes and show import notes\niffalse: Do not load import notes\ngroup: advanced",
"type": "boolean"
},
"overpassUrl": {
- "description": "Set one or more overpass URLs to use for this theme..",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
+ "description": "question: What overpass-api instance should be used for this layout?\n\nifunset: Use the default, builtin collection of overpass instances\ngroup: advanced",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
},
"overpassTimeout": {
- "description": "Set a different timeout for overpass queries - in seconds. Default: 30s",
+ "description": "question: After how much seconds should the overpass-query stop?\nIf a query takes too long, the overpass-server will abort.\nOnce can set the amount of time before overpass gives up here.\nifunset: use the default amount of 30 seconds as timeout\ntype: pnat\ngroup: advanced",
"type": "number"
},
"enableNodeDatabase": {
- "description": "Enables tracking of all nodes when data is loaded.\nThis is useful for the 'ImportWay' and 'ConflateWay'-buttons who need this database.\n\nNote: this flag will be automatically set.",
+ "description": "Enables tracking of all nodes when data is loaded.\nThis is useful for the 'ImportWay' and 'ConflateWay'-buttons who need this database.\n\nNote: this flag will be automatically set and can thus be ignored.\ngroup: hidden",
"type": "boolean"
}
},
@@ -306,13 +311,12 @@ export default {
],
"definitions": {
"TagConfigJson": {
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation",
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
"type": "object",
"properties": {
"or": {
@@ -331,8 +335,7 @@ export default {
}
]
},
- "AndTagConfigJson": {
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{and:TagConfigJson[];}": {
"type": "object",
"properties": {
"and": {
@@ -346,8 +349,7 @@ export default {
"and"
]
},
- "OrTagConfigJson": {
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{or:TagConfigJson[];}": {
"type": "object",
"properties": {
"or": {
@@ -430,48 +432,99 @@ export default {
"canonicalDenomination"
]
},
+ "MinimalTagRenderingConfigJson": {
+ "description": "Mostly used for lineRendering and pointRendering",
+ "type": "object",
+ "properties": {
+ "render": {
+ "description": "question: What value should be rendered?\n\nThis piece of text will be shown in the infobox.\nNote that \"&LBRACEkey&RBRACE\"-parts are substituted by the corresponding values of the element.\n\nThis value will be used if there is no mapping which matches (or there are no matches)\nNote that this is a HTML-interpreted value, so you can add links as e.g. '<a href='{website}'>{website}</a>' or include images such as `This is of type A <br><img src='typeA-icon.svg' />`",
+ "type": "string"
+ },
+ "mappings": {
+ "description": "Allows fixed-tag inputs, shown either as radiobuttons or as checkboxes",
+ "type": "array",
+ "items": {
+ "type": "object",
+ "properties": {
+ "if": {
+ "$ref": "#/definitions/TagConfigJson",
+ "description": "question: When should this single mapping match?\n\nIf this condition is met, then the text under `then` will be shown.\nIf no value matches, and the user selects this mapping as an option, then these tags will be uploaded to OSM.\n\nFor example: {'if': 'diet:vegetarion=yes', 'then':'A vegetarian option is offered here'}\n\nThis can be an substituting-tag as well, e.g. {'if': 'addr:street:={_calculated_nearby_streetname}', 'then': '{_calculated_nearby_streetname}'}"
+ },
+ "then": {
+ "description": "question: What text should be shown?\n\nIf the condition `if` is met, the text `then` will be rendered.\nIf not known yet, the user will be presented with `then` as an option",
+ "type": "string"
+ }
+ },
+ "required": [
+ "if",
+ "then"
+ ]
+ }
+ }
+ }
+ },
+ "IconConfigJson": {
+ "type": "object",
+ "properties": {
+ "icon": {
+ "description": "question: What icon should be used?\ntype: icon\nsuggestions: return [\"pin\",\"square\",\"circle\",\"checkmark\",\"clock\",\"close\",\"crosshair\",\"help\",\"home\",\"invalid\",\"location\",\"location_empty\",\"location_locked\",\"note\",\"resolved\",\"ring\",\"scissors\",\"teardrop\",\"teardrop_with_hole_green\",\"triangle\"].map(i => ({if: \"value=\"+i, then: i, icon: i}))",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
+ },
+ {
+ "type": "object",
+ "properties": {
+ "builtin": {
+ "type": "string"
+ },
+ "override": {}
+ },
+ "required": [
+ "builtin",
+ "override"
+ ]
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "color": {
+ "description": "question: What colour should the icon be?\nThis will only work for the default icons such as `pin`,`circle`,...\ntype: color",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
+ },
+ {
+ "type": "object",
+ "properties": {
+ "builtin": {
+ "type": "string"
+ },
+ "override": {}
+ },
+ "required": [
+ "builtin",
+ "override"
+ ]
+ },
+ {
+ "type": "string"
+ }
+ ]
+ }
+ },
+ "required": [
+ "icon"
+ ]
+ },
"TagRenderingConfigJson": {
"description": "A TagRenderingConfigJson is a single piece of code which converts one ore more tags into a HTML-snippet.\nFor an _editable_ tagRendering, use 'QuestionableTagRenderingConfigJson' instead, which extends this one",
"type": "object",
"properties": {
- "id": {
- "description": "The id of the tagrendering, should be an unique string.\nUsed to keep the translations in sync. Only used in the tagRenderings-array of a layerConfig, not requered otherwise.\n\nUse 'questions' to trigger the question box of this group (if a group is defined)",
- "type": "string"
- },
- "labels": {
- "description": "A list of labels. These are strings that are used for various purposes, e.g. to filter them away",
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "classes": {
- "description": "A list of css-classes to apply to the entire tagRendering if the answer is known (not applied on the question).\nThis is only for advanced users",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "description": {
- "description": "A human-readable text explaining what this tagRendering does",
- "anyOf": [
- {
- "$ref": "#/definitions/Record"
- },
- {
- "type": "string"
- }
- ]
- },
"render": {
- "description": "Renders this value. Note that \"{key}\"-parts are substituted by the corresponding values of the element.\nIf neither 'textFieldQuestion' nor 'mappings' are defined, this text is simply shown as default value.\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '{website}' or include images such as `This is of type A
`\ntype: rendered",
+ "description": "question: What text should be rendered?\n\nThis piece of text will be shown in the infobox.\nIn this text, values within braces (such as {braced(key)}) are replaced by the corresponding `value` in the object.\nFor example, if the object contains tags `amenity=school; name=Windy Hill School`, the render string `This school is named {name}` will be shown to the user as `This school is named Windy Hill School`\n\nThis text will be shown if:\n- there is no mapping which matches (or there are no matches)\n- no question, no mappings and no 'freeform' is set\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '<a href='{website}'>{website}</a>' or include images such as `This is of type A <br><img src='typeA-icon.svg' />`\ntype: rendered",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -507,16 +560,38 @@ export default {
}
]
},
- "condition": {
- "description": "Only show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "icon": {
+ "description": "question: what icon should be shown next to the 'render' value?\nAn icon shown next to the rendering; typically shown pretty small\nThis is only shown next to the \"render\" value\nType: icon",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "object",
+ "properties": {
+ "path": {
+ "description": "The path to the icon\nType: icon",
+ "type": "string"
+ },
+ "class": {
+ "description": "A hint to mapcomplete on how to render this icon within the mapping.\nThis is translated to 'mapping-icon-', so defining your own in combination with a custom CSS is possible (but discouraged)",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path"
+ ]
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "string"
+ }
+ ]
+ },
+ "condition": {
+ "description": "question: When should this item be shown?\n\nOnly show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
+ },
+ {
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -524,15 +599,13 @@ export default {
]
},
"metacondition": {
- "description": "If set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
+ "description": "question: When should this item be shown (including special conditions)?\n\nIf set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -540,11 +613,11 @@ export default {
]
},
"freeform": {
- "description": "Allow freeform text input from the user",
+ "description": "question: Should a freeform text field be shown?\nAllow freeform text input from the user\nifunset: Do not add a freeform text field",
"type": "object",
"properties": {
"key": {
- "description": "If this key is present, then 'render' is used to display the value.\nIf this is undefined, the rendering is _always_ shown",
+ "description": "What attribute should be filled out\nIf this key is present in the feature, then 'render' is used to display the value.\nIf this is undefined, the rendering is _always_ shown",
"type": "string"
}
},
@@ -560,10 +633,10 @@ export default {
"properties": {
"if": {
"$ref": "#/definitions/TagConfigJson",
- "description": "If this condition is met, then the text under `then` will be shown.\nIf no value matches, and the user selects this mapping as an option, then these tags will be uploaded to OSM.\n\nFor example: {'if': 'diet:vegetarion=yes', 'then':'A vegetarian option is offered here'}\n\nThis can be an substituting-tag as well, e.g. {'if': 'addr:street:={_calculated_nearby_streetname}', 'then': '{_calculated_nearby_streetname}'}"
+ "description": "question: When should this single mapping match?\n\nIf this condition is met, then the text under `then` will be shown.\nIf no value matches, and the user selects this mapping as an option, then these tags will be uploaded to OSM.\n\nFor example: {'if': 'diet:vegetarion=yes', 'then':'A vegetarian option is offered here'}\n\nThis can be an substituting-tag as well, e.g. {'if': 'addr:street:={_calculated_nearby_streetname}', 'then': '{_calculated_nearby_streetname}'}"
},
"then": {
- "description": "If the condition `if` is met, the text `then` will be rendered.\nIf not known yet, the user will be presented with `then` as an option\nType: rendered",
+ "description": "question: What text should be shown?\n\nIf the condition `if` is met, the text `then` will be rendered.\nIf not known yet, the user will be presented with `then` as an option\nType: rendered",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -574,7 +647,7 @@ export default {
]
},
"icon": {
- "description": "An icon supporting this mapping; typically shown pretty small\nType: icon",
+ "description": "question: What icon should be added to this mapping?\nAn icon supporting this mapping; typically shown pretty small\ninline:
{icon}\nType: icon",
"anyOf": [
{
"type": "object",
@@ -603,6 +676,21 @@ export default {
"then"
]
}
+ },
+ "description": {
+ "description": "A human-readable text explaining what this tagRendering does.\nMostly used for the shared tagrenderings",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "classes": {
+ "description": "question: What css-classes should be applied to showing this attribute?\n\nA list of css-classes to apply to the entire tagRendering.\nThese classes are applied in 'answer'-mode, not in question mode\nThis is only for advanced users.\n\nValues are split on ` ` (space)",
+ "type": "string"
}
}
},
@@ -614,13 +702,21 @@ export default {
"properties": {
"if": {
"$ref": "#/definitions/TagConfigJson",
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation"
+ "description": "question: What tags should be matched to show this option?\n\nIf in 'question'-mode and the contributor selects this option, these tags will be applied to the object"
},
"then": {
- "description": "Shown if the 'if is fulfilled\nType: rendered"
+ "description": "Question: What corresponding text should be shown?\nShown if the `if` is fulfilled\nType: rendered",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
},
"icon": {
- "description": "An extra icon supporting the choice\nType: icon",
+ "description": "question: What icon should be shown next to this mapping?\n\nThis icon will only be shown if the value is known, it is not displayed in the options (but might be in the future)\n\nifunset: Show no icon\nType: icon",
"anyOf": [
{
"type": "object",
@@ -644,15 +740,13 @@ export default {
]
},
"hideInAnswer": {
- "description": "In some cases, multiple taggings exist (e.g. a default assumption, or a commonly mapped abbreviation and a fully written variation).\n\nIn the latter case, a correct text should be shown, but only a single, canonical tagging should be selectable by the user.\nIn this case, one of the mappings can be hiden by setting this flag.\n\nTo demonstrate an example making a default assumption:\n\nmappings: [\n {\n if: \"access=\", -- no access tag present, we assume accessible\n then: \"Accessible to the general public\",\n hideInAnswer: true\n },\n {\n if: \"access=yes\",\n then: \"Accessible to the general public\", -- the user selected this, we add that to OSM\n },\n {\n if: \"access=no\",\n then: \"Not accessible to the public\"\n }\n]\n\n\nFor example, for an operator, we have `operator=Agentschap Natuur en Bos`, which is often abbreviated to `operator=ANB`.\nThen, we would add two mappings:\n{\n if: \"operator=Agentschap Natuur en Bos\" -- the non-abbreviated version which should be uploaded\n then: \"Maintained by Agentschap Natuur en Bos\"\n},\n{\n if: \"operator=ANB\", -- we don't want to upload abbreviations\n then: \"Maintained by Agentschap Natuur en Bos\"\n hideInAnswer: true\n}\n\nHide in answer can also be a tagsfilter, e.g. to make sure an option is only shown when appropriate.\nKeep in mind that this is reverse logic: it will be hidden in the answer if the condition is true, it will thus only show in the case of a mismatch\n\ne.g., for toilets: if \"wheelchair=no\", we know there is no wheelchair dedicated room.\nFor the location of the changing table, the option \"in the wheelchair accessible toilet is weird\", so we write:\n\n{\n \"question\": \"Where is the changing table located?\"\n \"mappings\": [\n {\"if\":\"changing_table:location=female\",\"then\":\"In the female restroom\"},\n {\"if\":\"changing_table:location=male\",\"then\":\"In the male restroom\"},\n {\"if\":\"changing_table:location=wheelchair\",\"then\":\"In the wheelchair accessible restroom\", \"hideInAnswer\": \"wheelchair=no\"},\n\n ]\n}\n\nAlso have a look for the meta-tags\n{\n if: \"operator=Agentschap Natuur en Bos\",\n then: \"Maintained by Agentschap Natuur en Bos\",\n hideInAnswer: \"_country!=be\"\n}",
+ "description": "question: Under what circumstances should this mapping be hidden from the possibilities a contributor can pick?\niftrue: Never show this mapping as option to pick\nifunset: Always show this mapping as option to pick\ntype: tag\n\nIn some cases, multiple taggings exist (e.g. a default assumption, or a commonly mapped abbreviation and a fully written variation).\n\nIn the latter case, a correct text should be shown, but only a single, canonical tagging should be selectable by the user.\nIn this case, one of the mappings can be hiden by setting this flag.\n\nTo demonstrate an example making a default assumption:\n\nmappings: [\n {\n if: \"access=\", -- no access tag present, we assume accessible\n then: \"Accessible to the general public\",\n hideInAnswer: true\n },\n {\n if: \"access=yes\",\n then: \"Accessible to the general public\", -- the user selected this, we add that to OSM\n },\n {\n if: \"access=no\",\n then: \"Not accessible to the public\"\n }\n]\n\n\nFor example, for an operator, we have `operator=Agentschap Natuur en Bos`, which is often abbreviated to `operator=ANB`.\nThen, we would add two mappings:\n{\n if: \"operator=Agentschap Natuur en Bos\" -- the non-abbreviated version which should be uploaded\n then: \"Maintained by Agentschap Natuur en Bos\"\n},\n{\n if: \"operator=ANB\", -- we don't want to upload abbreviations\n then: \"Maintained by Agentschap Natuur en Bos\"\n hideInAnswer: true\n}\n\nHide in answer can also be a tagsfilter, e.g. to make sure an option is only shown when appropriate.\nKeep in mind that this is reverse logic: it will be hidden in the answer if the condition is true, it will thus only show in the case of a mismatch\n\ne.g., for toilets: if \"wheelchair=no\", we know there is no wheelchair dedicated room.\nFor the location of the changing table, the option \"in the wheelchair accessible toilet is weird\", so we write:\n\n{\n \"question\": \"Where is the changing table located?\"\n \"mappings\": [\n {\"if\":\"changing_table:location=female\",\"then\":\"In the female restroom\"},\n {\"if\":\"changing_table:location=male\",\"then\":\"In the male restroom\"},\n {\"if\":\"changing_table:location=wheelchair\",\"then\":\"In the wheelchair accessible restroom\", \"hideInAnswer\": \"wheelchair=no\"},\n\n ]\n}\n\nAlso have a look for the meta-tags\n{\n if: \"operator=Agentschap Natuur en Bos\",\n then: \"Maintained by Agentschap Natuur en Bos\",\n hideInAnswer: \"_country!=be\"\n}",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": [
@@ -663,15 +757,13 @@ export default {
]
},
"ifnot": {
- "description": "Only applicable if 'multiAnswer' is set.\nThis is for situations such as:\n`accepts:coins=no` where one can select all the possible payment methods. However, we want to make explicit that some options _were not_ selected.\nThis can be done with `ifnot`\nNote that we can not explicitly render this negative case to the user, we cannot show `does _not_ accept coins`.\nIf this is important to your usecase, consider using multiple radiobutton-fields without `multiAnswer`",
+ "description": "question: What tags should be applied if this mapping is _not_ chosen?\n\nOnly applicable if 'multiAnswer' is set.\nThis is for situations such as:\n`accepts:coins=no` where one can select all the possible payment methods. However, we want to make explicit that some options _were not_ selected.\nThis can be done with `ifnot`\nNote that we can not explicitly render this negative case to the user, we cannot show `does _not_ accept coins`.\nIf this is important to your usecase, consider using multiple radiobutton-fields without `multiAnswer`",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -679,26 +771,24 @@ export default {
]
},
"addExtraTags": {
- "description": "If chosen as answer, these tags will be applied as well onto the object.\nNot compatible with multiAnswer.\n\nThis can be used e.g. to erase other keys which indicate the 'not' value:\n```json\n{\n \"if\": \"crossing:marking=rainbow\",\n \"then\": \"This is a rainbow crossing\",\n \"addExtraTags\": \"not:crossing:marking=\"\n}\n```",
+ "description": "question: What extra tags should be added to the object if this object is chosen?\ntype: simple_tag[]\n\nIf chosen as answer, these tags will be applied onto the object, together with the tags from the `if`\nNot compatible with multiAnswer.\n\nThis can be used e.g. to erase other keys which indicate the 'not' value:\n```json\n{\n \"if\": \"crossing:marking=rainbow\",\n \"then\": \"This is a rainbow crossing\",\n \"addExtraTags\": [\"not:crossing:marking=\"]\n}\n```",
"type": "array",
"items": {
"type": "string"
}
},
"searchTerms": {
- "description": "If there are many options, the mappings-radiobuttons will be replaced by an element with a searchfunction\n\nSearchterms (per language) allow to easily find an option if there are many options",
+ "description": "question: If there are many options, what search terms match too?\nIf there are many options, the mappings-radiobuttons will be replaced by an element with a searchfunction\n\nSearchterms (per language) allow to easily find an option if there are many options\ngroup: hidden",
"$ref": "#/definitions/Record"
},
"priorityIf": {
- "description": "If the searchable selector is picked, mappings with this item will have priority and show up even if the others are hidden\nUse this sparingly",
+ "description": "If the searchable selector is picked, mappings with this item will have priority and show up even if the others are hidden\nUse this sparingly\ngroup: hidden",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -706,7 +796,7 @@ export default {
]
},
"#": {
- "description": "Used for comments or to disable a validation\n\nignore-image-in-then: normally, a `then`-clause is not allowed to have an `img`-html-element as icons are preferred. In some cases (most notably title-icons), this is allowed",
+ "description": "Used for comments or to disable a validation\n\ngroup: hidden\nignore-image-in-then: normally, a `then`-clause is not allowed to have an `img`-html-element as icons are preferred. In some cases (most notably title-icons), this is allowed",
"type": "string"
}
},
@@ -723,22 +813,18 @@ export default {
"type": "object",
"properties": {
"location": {
- "description": "All the locations that this point should be rendered at.\nPossible values are:\n- `point`: only renders points at their location\n- `centroid`: show a symbol at the centerpoint of a (multi)Linestring and (multi)polygon. Points will _not_ be rendered with this\n- `projected_centerpoint`: Only on (multi)linestrings: calculate the centerpoint and snap it to the way\n- `start` and `end`: only on linestrings: add a point to the first/last coordinate of the LineString",
+ "description": "question: At what location should this icon be shown?\nmultianswer: true\nsuggestions: return [{if: \"value=point\",then: \"Show an icon for point (node) objects\"},{if: \"value=centroid\",then: \"Show an icon for line or polygon (way) objects at their centroid location\"}, {if: \"value=start\",then: \"Show an icon for line (way) objects at the start\"},{if: \"value=end\",then: \"Show an icon for line (way) object at the end\"},{if: \"value=projected_centerpoint\",then: \"Show an icon for line (way) object near the centroid location, but moved onto the line\"}]",
"type": "array",
"items": {
"type": "string"
}
},
- "icon": {
- "description": "The icon for an element.\nNote that this also doubles as the icon for this layer (rendered with the overpass-tags) ánd the icon in the presets.\n\nThe result of the icon is rendered as follows:\nthe resulting string is interpreted as a _list_ of items, separated by \";\". The bottommost layer is the first layer.\nAs a result, on could use a generic pin, then overlay it with a specific icon.\nTo make things even more practical, one can use all SVG's from the folder \"assets/svg\" and _substitute the color_ in it.\nE.g. to draw a red pin, use \"pin:#f00\", to have a green circle with your icon on top, use `circle:#0f0;`\n\nType: icon",
- "anyOf": [
- {
- "$ref": "#/definitions/TagRenderingConfigJson"
- },
- {
- "type": "string"
- }
- ]
+ "marker": {
+ "description": "The marker for an element.\nNote that this also defines the icon for this layer (rendered with the overpass-tags) and the icon in the presets.\n\nThe result of the icon is rendered as follows:\n- The first icon is rendered on the map\n- The second entry is overlayed on top of it\n- ...\n\nAs a result, on could use a generic icon (`pin`, `circle`, `square`) with a color, then overlay it with a specific icon.",
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/IconConfigJson"
+ }
},
"iconBadges": {
"description": "A list of extra badges to show next to the icon as small badge\nThey will be added as a 25% height icon at the bottom right of the icon, with all the badges in a flex layout.\n\nNote: strings are interpreted as icons, so layering and substituting is supported. You can use `circle:white;./my_icon.svg` to add a background circle",
@@ -748,13 +834,13 @@ export default {
"properties": {
"if": {
"$ref": "#/definitions/TagConfigJson",
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation"
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag"
},
"then": {
"description": "Badge to show\nType: icon",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "string"
@@ -769,7 +855,18 @@ export default {
}
},
"iconSize": {
- "description": "A string containing \"width,height\" or \"width,height,anchorpoint\" where anchorpoint is any of 'center', 'top', 'bottom', 'left', 'right', 'bottomleft','topright', ...\nDefault is '40,40,center'",
+ "description": "question: What size should the marker be on the map?\nA string containing \",\" in pixels\nifunset: Use the default size (40,40 px)",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/TagRenderingConfigJson"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "anchor": {
+ "description": "question: What is the anchorpoint of the icon?\n\nThis matches the geographical point with a location on the icon.\n\nifunset: Use MapComplete-default (center)\nsuggestions: return [{if: \"value=center\", then: \"Place the center of the icon on the geographical location\"},{if: \"value=top\", then: \"Place the top of the icon on the geographical location\"},{if: \"value=bottom\", then: \"Place the bottom of the icon on the geographical location\"},{if: \"value=left\", then: \"Place the left of the icon on the geographical location\"},{if: \"value=right\", then: \"Place the right of the icon on the geographical location\"}]",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -780,7 +877,7 @@ export default {
]
},
"rotation": {
- "description": "The rotation of an icon, useful for e.g. directions.\nUsage: as if it were a css property for 'rotate', thus has to end with 'deg', e.g. `90deg`, `{direction}deg`, `calc(90deg - {camera:direction}deg)``",
+ "description": "question: What rotation should be applied on the icon?\nThis is mostly useful for items that face a specific direction, such as surveillance cameras\nThis is interpreted as css property for 'rotate', thus has to end with 'deg', e.g. `90deg`, `{direction}deg`, `calc(90deg - {camera:direction}deg)``\nifunset: Do not rotate",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -791,7 +888,7 @@ export default {
]
},
"label": {
- "description": "A HTML-fragment that is shown below the icon, for example:\n{name}
\n\nIf the icon is undefined, then the label is shown in the center of the feature.\nNote that, if the wayhandling hides the icon then no label is shown as well.",
+ "description": "question: What label should be shown beneath the marker?\nFor example: `<div style=\"background: white\">{name}</div>`\n\nIf the icon is undefined, then the label is shown in the center of the feature.\ntypes: Dynamic value | string\ninline: Always show label {value} beneath the marker\nifunset: Do not show a label beneath the marker",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -802,7 +899,7 @@ export default {
]
},
"css": {
- "description": "A snippet of css code which is applied onto the container of the entire marker",
+ "description": "question: What CSS should be applied to the entire marker?\nYou can set the css-properties here, e.g. `background: red; font-size: 12px; `\nThis will be applied to the _container_ containing both the marker and the label\ninline: Apply CSS-style {value} to the _entire marker_\ntypes: Dynamic value ; string\nifunset: Do not apply extra CSS element to the entire marker",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -813,7 +910,7 @@ export default {
]
},
"cssClasses": {
- "description": "A snippet of css-classes which are applied onto the container of the entire marker. They can be space-separated",
+ "description": "question: Which CSS-classes should be applied to the entire marker?\nThis will be applied to the _container_ containing both the marker and the label\n\nThe classes should be separated by a space (` `)\nYou can use most Tailwind-css classes, see https://tailwindcss.com/ for more information\nFor example: `center bg-gray-500 mx-2 my-1 rounded-full`\ninline: Apply CSS-classes {value} to the entire container\nifunset: Do not apply extra CSS-classes to the label\ntypes: Dynamic value ; string\nifunset: Do not apply extra CSS-classes to the entire marker",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -824,7 +921,7 @@ export default {
]
},
"labelCss": {
- "description": "Css that is applied onto the label",
+ "description": "question: What CSS should be applied to the label?\nYou can set the css-properties here, e.g. `background: red; font-size: 12px; `\ninline: Apply CSS-style {value} to the label\ntypes: Dynamic value ; string\nifunset: Do not apply extra CSS-labels to the label",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -835,7 +932,7 @@ export default {
]
},
"labelCssClasses": {
- "description": "Css classes that are applied onto the label; can be space-separated",
+ "description": "question: Which CSS-classes should be applied to the label?\n\nThe classes should be separated by a space (` `)\nYou can use most Tailwind-css classes, see https://tailwindcss.com/ for more information\nFor example: `center bg-gray-500 mx-2 my-1 rounded-full`\ninline: Apply CSS-classes {value} to the label\ntypes: Dynamic value ; string\nifunset: Do not apply extra CSS-classes to the label",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -846,7 +943,7 @@ export default {
]
},
"pitchAlignment": {
- "description": "If the map is pitched, the marker will stay parallel to the screen.\nSet to 'map' if you want to put it flattened on the map",
+ "description": "question: If the map is pitched, should the icon stay parallel to the screen or to the groundplane?\nsuggestions: return [{if: \"value=canvas\", then: \"The icon will stay upward and not be transformed as if it sticks to the screen\"}, {if: \"value=map\", then: \"The icon will be transformed as if it were painted onto the ground. (Automatically sets rotationAlignment)\"}]",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -861,7 +958,7 @@ export default {
]
},
"rotationAlignment": {
- "description": "If the map is rotated, the icon will still point to the north if no rotation was applied",
+ "description": "question: Should the icon be rotated if the map is rotated?\nifunset: Do not rotate or tilt icons. Always keep the icons straight\nsuggestions: return [{if: \"value=canvas\", then: \"Never rotate the icon\"}, {if: \"value=map\", then: \"If the map is rotated, rotate the icon as well. This gives the impression of an icon that floats perpendicular above the ground.\"}]",
"anyOf": [
{
"$ref": "#/definitions/TagRenderingConfigJson"
@@ -885,10 +982,10 @@ export default {
"type": "object",
"properties": {
"color": {
- "description": "The color for way-elements and SVG-elements.\nIf the value starts with \"--\", the style of the body element will be queried for the corresponding variable instead",
+ "description": "question: What color should lines be drawn in?\n\nFor an area, this will be the colour of the outside line.\nIf the value starts with \"--\", the style of the body element will be queried for the corresponding variable instead\n\ntypes: dynamic value ; string\ntitle: Line Colour\ninline: The line colour always is {value}\ntype: color",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "string"
@@ -896,10 +993,10 @@ export default {
]
},
"width": {
- "description": "The stroke-width for way-elements",
+ "description": "question: How wide should the line be?\nThe stroke-width for way-elements\n\ntypes: dynamic value ; string\ntitle: Line width\ninline: The line width is {value} pixels\ntype: pnat\nifunset: Use the default-linewidth of 7 pixels",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": [
@@ -910,47 +1007,25 @@ export default {
]
},
"dashArray": {
- "description": "A dasharray, e.g. \"5 6\"\nThe dasharray defines 'pixels of line, pixels of gap, pixels of line, pixels of gap',\nDefault value: \"\" (empty string == full line)",
- "anyOf": [
- {
- "$ref": "#/definitions/TagRenderingConfigJson"
- },
- {
- "type": "string"
- }
- ]
+ "description": "question: Should a dasharray be used to render the lines?\nThe dasharray defines 'pixels of line, pixels of gap, pixels of line, pixels of gap, ...'. For example, `5 6` will be 5 pixels of line followed by a 6 pixel gap.\nCannot be a dynamic property due to a mapbox limitation\nifunset: Ways are rendered with a full line",
+ "type": "string"
},
"lineCap": {
- "description": "The form at the end of a line",
+ "description": "question: What form should the line-ending have?\nsuggestions: return [{if:\"value=round\",then:\"Round endings\"}, {if: \"value=square\", then: \"square endings\"}, {if: \"value=butt\", then: \"no ending (square ending at the end, without padding)\"}]\ntypes: dynamic value ; string\ntitle: Line Cap\nifunset: Use the default value (round ending)",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "string"
}
]
},
- "fill": {
- "description": "Whether or not to fill polygons",
- "anyOf": [
- {
- "$ref": "#/definitions/TagRenderingConfigJson"
- },
- {
- "enum": [
- "no",
- "yes"
- ],
- "type": "string"
- }
- ]
- },
"fillColor": {
- "description": "The color to fill a polygon with.\nIf undefined, this will be slightly more opaque version of the stroke line",
+ "description": "question: What colour should be used as fill colour for polygons?\nifunset: The polygon fill colour will be a more transparent version of the stroke colour\nsuggestions: return [{if: \"value=#00000000\", then: \"Use a transparent fill (only render the outline)\"}]\ninline: The fill colour is {value}\ntypes: dynamic value ; string\ntype: color",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "string"
@@ -958,10 +1033,10 @@ export default {
]
},
"offset": {
- "description": "The number of pixels this line should be moved.\nUse a positive numbe to move to the right, a negative to move to the left (left/right as defined by the drawing direction of the line).\n\nIMPORTANT: MapComplete will already normalize 'key:both:property' and 'key:both' into the corresponding 'key:left' and 'key:right' tagging (same for 'sidewalk=left/right/both' which is rewritten to 'sidewalk:left' and 'sidewalk:right')\nThis simplifies programming. Refer to the CalculatedTags.md-documentation for more details",
+ "description": "question: Should the lines be moved (offsetted) with a number of pixels against the geographical lines?\nThe number of pixels this line should be moved.\nUse a positive number to move to the right in the drawing direction or a negative to move to the left (left/right as defined by the drawing direction of the line).\n\nIMPORTANT: MapComplete will already normalize 'key:both:property' and 'key:both' into the corresponding 'key:left' and 'key:right' tagging (same for 'sidewalk=left/right/both' which is rewritten to 'sidewalk:left' and 'sidewalk:right')\nThis simplifies programming. Refer to the CalculatedTags.md-documentation for more details\nifunset: don't offset lines on the map\ninline: Pixel offset by {value} pixels\ntypes: dynamic value ; number\ntype: int",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "number"
@@ -970,99 +1045,38 @@ export default {
}
}
},
- "default": {
- "description": "Rewrites and multiplies the given renderings of type T.\n\nThis can be used for introducing many similar questions automatically,\nwhich also makes translations easier.\n\n(Note that the key does _not_ need to be wrapped in {}.\nHowever, we recommend to use them if the key is used in a translation, as missing keys will be picked up and warned for by the translation scripts)\n\nFor example:\n\n```\n{\n rewrite: {\n sourceString: [\"key\", \"a|b|c\"],\n into: [\n [\"X\", 0]\n [\"Y\", 1],\n [\"Z\", 2]\n ],\n renderings: [{\n \"key\":\"a|b|c\"\n }]\n }\n}\n```\nwill result in _three_ copies (as the values to rewrite into have three values, namely:\n\n[\n {\n # The first pair: key --> X, a|b|c --> 0\n \"X\": 0\n },\n {\n \"Y\": 1\n },\n {\n \"Z\": 2\n }\n\n]",
- "type": "object",
- "properties": {
- "rewrite": {
- "type": "object",
- "properties": {
- "sourceString": {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "into": {
- "type": "array",
- "items": {
- "type": "array",
- "items": {}
- }
- }
- },
- "required": [
- "into",
- "sourceString"
- ]
- },
- "renderings": {
- "anyOf": [
- {
- "$ref": "#/definitions/default_4"
- },
- {
- "$ref": "#/definitions/default_5"
- },
- {
- "type": "array",
- "items": {
- "$ref": "#/definitions/default_5"
- }
- },
- {
- "type": "array",
- "items": {
- "$ref": "#/definitions/default_4"
- }
- }
- ]
- }
- },
- "required": [
- "renderings",
- "rewrite"
- ]
- },
"QuestionableTagRenderingConfigJson": {
"description": "A QuestionableTagRenderingConfigJson is a single piece of code which converts one ore more tags into a HTML-snippet.\nIf the desired tags are missing and a question is defined, a question will be shown instead.",
"type": "object",
"properties": {
- "question": {
- "description": "If it turns out that this tagRendering doesn't match _any_ value, then we show this question.\nIf undefined, the question is never asked and this tagrendering is read-only",
- "anyOf": [
- {
- "$ref": "#/definitions/Record"
- },
- {
- "type": "string"
- }
- ]
+ "id": {
+ "type": "string"
},
- "questionHint": {
- "description": "A hint which is shown in subtle text under the question.\nThis can give some extra information on what the answer should ook like",
- "anyOf": [
- {
- "$ref": "#/definitions/Record"
- },
- {
- "type": "string"
- }
- ]
+ "mappings": {
+ "description": "Allows fixed-tag inputs, shown either as radiobuttons or as checkboxes\n\nquestion: What are common options?",
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/MappingConfigJson"
+ }
+ },
+ "multiAnswer": {
+ "description": "If true, use checkboxes instead of radio buttons when asking the question\n\nquestion: Should a contributor be allowed to select multiple mappings?\n\niftrue: allow to select multiple mappings\niffalse: only allow to select a single mapping\nifunset: only allow to select a single mapping",
+ "type": "boolean"
},
"freeform": {
"description": "Allow freeform text input from the user",
"type": "object",
"properties": {
"key": {
+ "description": "question: What is the name of the attribute that should be written to?\nifunset: do not offer a freeform textfield as answer option",
"type": "string"
},
"type": {
- "description": "The type of the text-field, e.g. 'string', 'nat', 'float', 'date',...\nSee Docs/SpecialInputElements.md and UI/Input/ValidatedTextField.ts for supported values",
+ "description": "question: What is the input type?\nThe type of the text-field, e.g. 'string', 'nat', 'float', 'date',...\nSee Docs/SpecialInputElements.md and UI/Input/ValidatedTextField.ts for supported values\nifunset: use an unconstrained string as input (default)\nsuggestions: return validators.AllValidators.filter(type => !type.isMeta).map((type) => ({if: \"value=\"+type.name, then: \"\"+type.name+\" \"+type.explanation.split(\"\\n\")[0]}))",
"type": "string"
},
"placeholder": {
- "description": "A (translated) text that is shown (as gray text) within the textfield"
+ "description": "question: What placeholder text should be shown in the input-element if there is no input?\nA (translated) text that is shown (as gray text) within the textfield\ntype: translation"
},
"helperArgs": {
"description": "Extra parameters to initialize the input helper arguments.\nFor semantics, see the 'SpecialInputElements.md'",
@@ -1077,56 +1091,34 @@ export default {
}
},
"inline": {
- "description": "When set, influences the way a question is asked.\nInstead of showing a full-width text field, the text field will be shown within the rendering of the question.\n\nThis combines badly with special input elements, as it'll distort the layout.\nNote that this will be set automatically if no special elements are present.",
+ "description": "question: Show the freeform as box within the question?\nInstead of showing a full-width text field, the text field will be shown within the rendering of the question.\n\nThis combines badly with special input elements, as it'll distort the layout.\nifunset: show the freeform input field full-width\niftrue: show the freeform input field as a small field within the question",
"type": "boolean"
},
"default": {
- "description": "default value to enter if no previous tagging is present.\nNormally undefined (aka do not enter anything)",
+ "description": "question: What value should be entered in the text field if no value is set?\nThis can help people to quickly enter the most common option\nifunset: do not prefill the textfield",
"type": "string"
+ },
+ "invalidValues": {
+ "description": "question: What values of the freeform key should be interpreted as 'unknown'?\nFor example, if a feature has `shop=yes`, the question 'what type of shop is this?' should still asked\nifunset: The question will be considered answered if any value is set for the key",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
+ },
+ {
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
+ },
+ {
+ "type": "string"
+ }
+ ]
}
},
"required": [
"key"
]
},
- "multiAnswer": {
- "description": "If true, use checkboxes instead of radio buttons when asking the question",
- "type": "boolean"
- },
- "mappings": {
- "description": "Allows fixed-tag inputs, shown either as radiobuttons or as checkboxes",
- "type": "array",
- "items": {
- "$ref": "#/definitions/MappingConfigJson"
- }
- },
- "id": {
- "description": "The id of the tagrendering, should be an unique string.\nUsed to keep the translations in sync. Only used in the tagRenderings-array of a layerConfig, not requered otherwise.\n\nUse 'questions' to trigger the question box of this group (if a group is defined)",
- "type": "string"
- },
- "labels": {
- "description": "A list of labels. These are strings that are used for various purposes, e.g. to filter them away",
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "classes": {
- "description": "A list of css-classes to apply to the entire tagRendering if the answer is known (not applied on the question).\nThis is only for advanced users",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "description": {
- "description": "A human-readable text explaining what this tagRendering does",
+ "question": {
+ "description": "question: What question should be shown to the contributor?\n\nA question is presented ot the user if no mapping matches and the 'freeform' key is not set as well.\n\nifunset: This tagrendering will be shown if it is known, but cannot be edited by the contributor, effectively resutling in a read-only rendering",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -1136,8 +1128,26 @@ export default {
}
]
},
+ "questionHint": {
+ "description": "question: Should some extra information be shown to the contributor, alongside the question?\nThis hint is shown in subtle text under the question.\nThis can give some extra information on what the answer should ook like\nifunset: No extra hint is given",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "labels": {
+ "description": "A list of labels. These are strings that are used for various purposes, e.g. to only include a subset of the tagRenderings when reusing a layer",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
"render": {
- "description": "Renders this value. Note that \"{key}\"-parts are substituted by the corresponding values of the element.\nIf neither 'textFieldQuestion' nor 'mappings' are defined, this text is simply shown as default value.\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '{website}' or include images such as `This is of type A
`\ntype: rendered",
+ "description": "question: What text should be rendered?\n\nThis piece of text will be shown in the infobox.\nIn this text, values within braces (such as {braced(key)}) are replaced by the corresponding `value` in the object.\nFor example, if the object contains tags `amenity=school; name=Windy Hill School`, the render string `This school is named {name}` will be shown to the user as `This school is named Windy Hill School`\n\nThis text will be shown if:\n- there is no mapping which matches (or there are no matches)\n- no question, no mappings and no 'freeform' is set\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '<a href='{website}'>{website}</a>' or include images such as `This is of type A <br><img src='typeA-icon.svg' />`\ntype: rendered",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -1173,16 +1183,38 @@ export default {
}
]
},
- "condition": {
- "description": "Only show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "icon": {
+ "description": "question: what icon should be shown next to the 'render' value?\nAn icon shown next to the rendering; typically shown pretty small\nThis is only shown next to the \"render\" value\nType: icon",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "object",
+ "properties": {
+ "path": {
+ "description": "The path to the icon\nType: icon",
+ "type": "string"
+ },
+ "class": {
+ "description": "A hint to mapcomplete on how to render this icon within the mapping.\nThis is translated to 'mapping-icon-', so defining your own in combination with a custom CSS is possible (but discouraged)",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path"
+ ]
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "string"
+ }
+ ]
+ },
+ "condition": {
+ "description": "question: When should this item be shown?\n\nOnly show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
+ },
+ {
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -1190,61 +1222,70 @@ export default {
]
},
"metacondition": {
- "description": "If set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
+ "description": "question: When should this item be shown (including special conditions)?\n\nIf set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
}
]
+ },
+ "description": {
+ "description": "A human-readable text explaining what this tagRendering does.\nMostly used for the shared tagrenderings",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "classes": {
+ "description": "question: What css-classes should be applied to showing this attribute?\n\nA list of css-classes to apply to the entire tagRendering.\nThese classes are applied in 'answer'-mode, not in question mode\nThis is only for advanced users.\n\nValues are split on ` ` (space)",
+ "type": "string"
}
- }
+ },
+ "required": [
+ "id"
+ ]
},
"Partial": {
"type": "object",
"properties": {
- "question": {
- "description": "If it turns out that this tagRendering doesn't match _any_ value, then we show this question.\nIf undefined, the question is never asked and this tagrendering is read-only",
- "anyOf": [
- {
- "$ref": "#/definitions/Record"
- },
- {
- "type": "string"
- }
- ]
+ "id": {
+ "type": "string"
},
- "questionHint": {
- "description": "A hint which is shown in subtle text under the question.\nThis can give some extra information on what the answer should ook like",
- "anyOf": [
- {
- "$ref": "#/definitions/Record"
- },
- {
- "type": "string"
- }
- ]
+ "mappings": {
+ "description": "Allows fixed-tag inputs, shown either as radiobuttons or as checkboxes\n\nquestion: What are common options?",
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/MappingConfigJson"
+ }
+ },
+ "multiAnswer": {
+ "description": "If true, use checkboxes instead of radio buttons when asking the question\n\nquestion: Should a contributor be allowed to select multiple mappings?\n\niftrue: allow to select multiple mappings\niffalse: only allow to select a single mapping\nifunset: only allow to select a single mapping",
+ "type": "boolean"
},
"freeform": {
"description": "Allow freeform text input from the user",
"type": "object",
"properties": {
"key": {
+ "description": "question: What is the name of the attribute that should be written to?\nifunset: do not offer a freeform textfield as answer option",
"type": "string"
},
"type": {
- "description": "The type of the text-field, e.g. 'string', 'nat', 'float', 'date',...\nSee Docs/SpecialInputElements.md and UI/Input/ValidatedTextField.ts for supported values",
+ "description": "question: What is the input type?\nThe type of the text-field, e.g. 'string', 'nat', 'float', 'date',...\nSee Docs/SpecialInputElements.md and UI/Input/ValidatedTextField.ts for supported values\nifunset: use an unconstrained string as input (default)\nsuggestions: return validators.AllValidators.filter(type => !type.isMeta).map((type) => ({if: \"value=\"+type.name, then: \"\"+type.name+\" \"+type.explanation.split(\"\\n\")[0]}))",
"type": "string"
},
"placeholder": {
- "description": "A (translated) text that is shown (as gray text) within the textfield"
+ "description": "question: What placeholder text should be shown in the input-element if there is no input?\nA (translated) text that is shown (as gray text) within the textfield\ntype: translation"
},
"helperArgs": {
"description": "Extra parameters to initialize the input helper arguments.\nFor semantics, see the 'SpecialInputElements.md'",
@@ -1259,56 +1300,34 @@ export default {
}
},
"inline": {
- "description": "When set, influences the way a question is asked.\nInstead of showing a full-width text field, the text field will be shown within the rendering of the question.\n\nThis combines badly with special input elements, as it'll distort the layout.\nNote that this will be set automatically if no special elements are present.",
+ "description": "question: Show the freeform as box within the question?\nInstead of showing a full-width text field, the text field will be shown within the rendering of the question.\n\nThis combines badly with special input elements, as it'll distort the layout.\nifunset: show the freeform input field full-width\niftrue: show the freeform input field as a small field within the question",
"type": "boolean"
},
"default": {
- "description": "default value to enter if no previous tagging is present.\nNormally undefined (aka do not enter anything)",
+ "description": "question: What value should be entered in the text field if no value is set?\nThis can help people to quickly enter the most common option\nifunset: do not prefill the textfield",
"type": "string"
+ },
+ "invalidValues": {
+ "description": "question: What values of the freeform key should be interpreted as 'unknown'?\nFor example, if a feature has `shop=yes`, the question 'what type of shop is this?' should still asked\nifunset: The question will be considered answered if any value is set for the key",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
+ },
+ {
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
+ },
+ {
+ "type": "string"
+ }
+ ]
}
},
"required": [
"key"
]
},
- "multiAnswer": {
- "description": "If true, use checkboxes instead of radio buttons when asking the question",
- "type": "boolean"
- },
- "mappings": {
- "description": "Allows fixed-tag inputs, shown either as radiobuttons or as checkboxes",
- "type": "array",
- "items": {
- "$ref": "#/definitions/MappingConfigJson"
- }
- },
- "id": {
- "description": "The id of the tagrendering, should be an unique string.\nUsed to keep the translations in sync. Only used in the tagRenderings-array of a layerConfig, not requered otherwise.\n\nUse 'questions' to trigger the question box of this group (if a group is defined)",
- "type": "string"
- },
- "labels": {
- "description": "A list of labels. These are strings that are used for various purposes, e.g. to filter them away",
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "classes": {
- "description": "A list of css-classes to apply to the entire tagRendering if the answer is known (not applied on the question).\nThis is only for advanced users",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "description": {
- "description": "A human-readable text explaining what this tagRendering does",
+ "question": {
+ "description": "question: What question should be shown to the contributor?\n\nA question is presented ot the user if no mapping matches and the 'freeform' key is not set as well.\n\nifunset: This tagrendering will be shown if it is known, but cannot be edited by the contributor, effectively resutling in a read-only rendering",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -1318,8 +1337,26 @@ export default {
}
]
},
+ "questionHint": {
+ "description": "question: Should some extra information be shown to the contributor, alongside the question?\nThis hint is shown in subtle text under the question.\nThis can give some extra information on what the answer should ook like\nifunset: No extra hint is given",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "labels": {
+ "description": "A list of labels. These are strings that are used for various purposes, e.g. to only include a subset of the tagRenderings when reusing a layer",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
"render": {
- "description": "Renders this value. Note that \"{key}\"-parts are substituted by the corresponding values of the element.\nIf neither 'textFieldQuestion' nor 'mappings' are defined, this text is simply shown as default value.\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '{website}' or include images such as `This is of type A
`\ntype: rendered",
+ "description": "question: What text should be rendered?\n\nThis piece of text will be shown in the infobox.\nIn this text, values within braces (such as {braced(key)}) are replaced by the corresponding `value` in the object.\nFor example, if the object contains tags `amenity=school; name=Windy Hill School`, the render string `This school is named {name}` will be shown to the user as `This school is named Windy Hill School`\n\nThis text will be shown if:\n- there is no mapping which matches (or there are no matches)\n- no question, no mappings and no 'freeform' is set\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '<a href='{website}'>{website}</a>' or include images such as `This is of type A <br><img src='typeA-icon.svg' />`\ntype: rendered",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -1355,16 +1392,38 @@ export default {
}
]
},
- "condition": {
- "description": "Only show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "icon": {
+ "description": "question: what icon should be shown next to the 'render' value?\nAn icon shown next to the rendering; typically shown pretty small\nThis is only shown next to the \"render\" value\nType: icon",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "object",
+ "properties": {
+ "path": {
+ "description": "The path to the icon\nType: icon",
+ "type": "string"
+ },
+ "class": {
+ "description": "A hint to mapcomplete on how to render this icon within the mapping.\nThis is translated to 'mapping-icon-', so defining your own in combination with a custom CSS is possible (but discouraged)",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path"
+ ]
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "string"
+ }
+ ]
+ },
+ "condition": {
+ "description": "question: When should this item be shown?\n\nOnly show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
+ },
+ {
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -1372,20 +1431,33 @@ export default {
]
},
"metacondition": {
- "description": "If set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
+ "description": "question: When should this item be shown (including special conditions)?\n\nIf set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
}
]
+ },
+ "description": {
+ "description": "A human-readable text explaining what this tagRendering does.\nMostly used for the shared tagrenderings",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "classes": {
+ "description": "question: What css-classes should be applied to showing this attribute?\n\nA list of css-classes to apply to the entire tagRendering.\nThese classes are applied in 'answer'-mode, not in question mode\nThis is only for advanced users.\n\nValues are split on ` ` (space)",
+ "type": "string"
}
}
},
@@ -1464,15 +1536,13 @@ export default {
"properties": {
"question": {},
"osmTags": {
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation",
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -1519,6 +1589,10 @@ export default {
"DeleteConfigJson": {
"type": "object",
"properties": {
+ "neededChangesets": {
+ "description": "*\nBy default, the contributor needs 20 previous changesets to delete points edited by others.\nFor some small features (e.g. bicycle racks) this is too much and this requirement can be lowered or dropped, which can be done here.\n\ntype: nat\nquestion: How many changesets must a contributor have before being allowed to delete a point?",
+ "type": "number"
+ },
"extraDeleteReasons": {
"description": "*\nBy default, three reasons to delete a point are shown:\n\n- The point does not exist anymore\n- The point was a testing point\n- THe point could not be found\n\nHowever, for some layers, there might be different or more specific reasons for deletion which can be user friendly to set, e.g.:\n\n- the shop has closed\n- the climbing route has been closed of for nature conservation reasons\n- ...\n\nThese reasons can be stated here and will be shown in the list of options the user can choose from",
"type": "array",
@@ -1526,10 +1600,10 @@ export default {
"type": "object",
"properties": {
"explanation": {
- "description": "The text that will be shown to the user - translatable"
+ "description": "The text that will be shown to the user as option for why this point does not exist anymore.\nNote that the most common reasons (test point, does not exist anymore, cannot be found) are already offered by default\n\nquestion: For what extra reason might this feature be removed in real-life?"
},
"changesetMessage": {
- "description": "The text that will be uploaded into the changeset or will be used in the fixme in case of a soft deletion\nShould be a few words, in english",
+ "description": "The text that will be uploaded into the changeset or will be used in the fixme in case of a soft deletion\nShould be a few words, in english\n\nquestion: What should be added to the changeset as delete reason?",
"type": "string"
}
},
@@ -1547,10 +1621,10 @@ export default {
"properties": {
"if": {
"$ref": "#/definitions/TagConfigJson",
- "description": "The tags that will be given to the object.\nThis must remove tags so that the 'source/osmTags' won't match anymore"
+ "description": "The tags that will be given to the object.\nThis must remove tags so that the 'source/osmTags' won't match anymore\n\nquestion: What tags should be applied to the object?"
},
"then": {
- "description": "The human explanation for the options"
+ "description": "The human explanation for the options\n\nquestion: What text should be shown to the contributor for this reason?"
}
},
"required": [
@@ -1560,27 +1634,21 @@ export default {
}
},
"softDeletionTags": {
- "description": "In some cases, the contributor is not allowed to delete the current feature (e.g. because it isn't a point, the point is referenced by a relation or the user isn't experienced enough).\nTo still offer the user a 'delete'-option, the feature is retagged with these tags. This is a soft deletion, as the point isn't actually removed from OSM but rather marked as 'disused'\nIt is important that the feature will be retagged in such a way that it won't be picked up by the layer anymore!\n\nExample (note that \"amenity=\" erases the 'amenity'-key alltogether):\n```\n{\n \"and\": [\"disussed:amenity=public_bookcase\", \"amenity=\"]\n}\n```\n\nor (notice the use of the ':='-tag to copy the old value of 'shop=*' into 'disused:shop='):\n```\n{\n \"and\": [\"disused:shop:={shop}\", \"shop=\"]\n}\n```",
+ "description": "In some cases, the contributor is not allowed to delete the current feature (e.g. because it isn't a point, the point is referenced by a relation or the user isn't experienced enough).\nTo still offer the user a 'delete'-option, the feature is retagged with these tags. This is a soft deletion, as the point isn't actually removed from OSM but rather marked as 'disused'\nIt is important that the feature will be retagged in such a way that it won't be picked up by the layer anymore!\n\nExample (note that \"amenity=\" erases the 'amenity'-key alltogether):\n\n```\n{\n \"and\": [\"disussed:amenity=public_bookcase\", \"amenity=\"]\n}\n```\n\nor (notice the use of the ':='-tag to copy the old value of 'shop=*' into 'disused:shop='):\n\n```\n{\n \"and\": [\"disused:shop:={shop}\", \"shop=\"]\n}\n```\n\nquestion: If a hard delete is not possible, what tags should be applied to mark this feature as deleted?\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
}
]
},
- "neededChangesets": {
- "description": "*\nBy default, the contributor needs 20 previous changesets to delete points edited by others.\nFor some small features (e.g. bicycle racks) this is too much and this requirement can be lowered or dropped, which can be done here.",
- "type": "number"
- },
"omitDefaultDeleteReasons": {
- "description": "Set this flag if the default delete reasons should be omitted from the dialog.\nThis requires at least one extraDeleteReason or nonDeleteMapping",
+ "description": "Set this flag if the default delete reasons should be omitted from the dialog.\nThis requires at least one extraDeleteReason or nonDeleteMapping\n\nquestion: Should the default delete reasons be hidden?\niftrue: Hide the default delete reasons\niffalse: Show the default delete reasons\nifunset: Show the default delete reasons (default behaviour)",
"type": "boolean"
}
}
@@ -1589,11 +1657,11 @@ export default {
"type": "object",
"properties": {
"enableImproveAccuracy": {
- "description": "One default reason to move a point is to improve accuracy.\nSet to false to disable this reason",
+ "description": "question: Should moving this type of point to improve the accuracy be allowed?\niftrue: This point can be moved to improve the accuracy\nifunset: (default) This point can be moved to improve the accuracy\niffalse: This point cannot be moved to improve the accuracy",
"type": "boolean"
},
"enableRelocation": {
- "description": "One default reason to move a point is because it has relocated\nSet to false to disable this reason",
+ "description": "question: Should moving this type of point due to a relocation be allowed?\n\nThis will erase the attributes `addr:street`, `addr:housenumber`, `addr:city` and `addr:postcode`\n\niftrue: This type of point can be moved due to a relocation (and will remove address information when this is done)\nifunset: (default) This type of point can be moved due to a relocation (and will remove address information when this is done)\niffalse: This type of point cannot be moved due to a relocation",
"type": "boolean"
}
}
@@ -1603,7 +1671,7 @@ export default {
"type": "object",
"properties": {
"appliesToKey": {
- "description": "Every key from this list will be normalized.\n\nTo render a united value properly, use",
+ "description": "Every key from this list will be normalized.\n\nTo render the value properly (with a human readable denomination), use `{canonical()}`",
"type": "array",
"items": {
"type": "string"
@@ -1659,6 +1727,9 @@ export default {
"category": {
"type": "string"
},
+ "type": {
+ "type": "string"
+ },
"attribution": {
"type": "object",
"properties": {
@@ -1697,11 +1768,11 @@ export default {
"type": "object",
"properties": {
"id": {
- "description": "The id of this layer.\nThis should be a simple, lowercase, human readable string that is used to identify the layer.",
+ "description": "question: What is the identifier of this layer?\n\nThis should be a simple, lowercase, human readable string that is used to identify the layer.\n A good ID is:\n - a noun\n - written in singular\n - describes the object\n - in english\n - only has lowercase letters, numbers or underscores. Do not use a space or a dash\n\ntype: id\ngroup: Basic",
"type": "string"
},
"name": {
- "description": "The name of this layer\nUsed in the layer control panel and the 'Personal theme'.\n\nIf not given, will be hidden (and thus not toggable) in the layer control",
+ "description": "Used in the layer control panel to toggle a layer on and of.\n\nifunset: This will hide the layer in the layer control, making it not filterable and not toggleable\n\ngroup: Basic\nquestion: What is the name of this layer?",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -1712,7 +1783,7 @@ export default {
]
},
"description": {
- "description": "A description for this layer.\nShown in the layer selections and in the personel theme",
+ "description": "A description for the features shown in this layer.\nThis often resembles the introduction of the wiki.osm.org-page for this feature.\n\ngroup: Basic\nquestion: How would you describe the features that are shown on this layer?",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -1723,17 +1794,17 @@ export default {
]
},
"source": {
- "description": "This determines where the data for the layer is fetched: from OSM or from an external geojson dataset.\n\nIf no 'geojson' is defined, data will be fetched from overpass and the OSM-API.\n\nEvery source _must_ define which tags _must_ be present in order to be picked up.\n\nNote: a source must always be defined. 'special' is only allowed if this is a builtin-layer",
+ "description": "Question: Where should the data be fetched from?\ntitle: Data Source\n\nThis determines where the data for the layer is fetched: from OSM or from an external geojson dataset.\n\nIf no 'geojson' is defined, data will be fetched from overpass and the OSM-API.\n\nEvery source _must_ define which tags _must_ be present in order to be picked up.\n\nNote: a source must always be defined. 'special' is only allowed if this is a builtin-layer\n\ntypes: Load data with specific tags from OpenStreetMap ; Load data from an external geojson source ;\ntypesdefault: 0\ngroup: Basic",
"anyOf": [
{
"type": "object",
"properties": {
"osmTags": {
"$ref": "#/definitions/TagConfigJson",
- "description": "Every source must set which tags have to be present in order to load the given layer."
+ "description": "question: Which tags must be present on the feature to show it in this layer?\nEvery source must set which tags have to be present in order to load the given layer."
},
"maxCacheAge": {
- "description": "The maximum amount of seconds that a tile is allowed to linger in the cache",
+ "description": "question: How long (in seconds) is the data allowed to remain cached until it must be refreshed?\nThe maximum amount of seconds that a tile is allowed to linger in the cache\n\ntype: nat\ndefault: 30 days",
"type": "number"
}
},
@@ -1745,23 +1816,23 @@ export default {
"type": "object",
"properties": {
"geoJson": {
- "description": "The actual source of the data to load, if loaded via geojson.\n\n# A single geojson-file\nsource: {geoJson: \"https://my.source.net/some-geo-data.geojson\"}\n fetches a geojson from a third party source\n\n# A tiled geojson source\nsource: {geoJson: \"https://my.source.net/some-tile-geojson-{layer}-{z}-{x}-{y}.geojson\", geoJsonZoomLevel: 14}\n to use a tiled geojson source. The web server must offer multiple geojsons. {z}, {x} and {y} are substituted by the location; {layer} is substituted with the id of the loaded layer\n\nSome API's use a BBOX instead of a tile, this can be used by specifying {y_min}, {y_max}, {x_min} and {x_max}",
+ "description": "The actual source of the data to load, if loaded via geojson.\n\n# A single geojson-file\nsource: {geoJson: \"https://my.source.net/some-geo-data.geojson\"}\n fetches a geojson from a third party source\n\n# A tiled geojson source\nsource: {geoJson: \"https://my.source.net/some-tile-geojson-{layer}-{z}-{x}-{y}.geojson\", geoJsonZoomLevel: 14}\n to use a tiled geojson source. The web server must offer multiple geojsons. {z}, {x} and {y} are substituted by the location; {layer} is substituted with the id of the loaded layer\n\nSome API's use a BBOX instead of a tile, this can be used by specifying {y_min}, {y_max}, {x_min} and {x_max}\n\nquestion: What is the URL of the geojson?\ntype: url",
"type": "string"
},
"geoJsonZoomLevel": {
- "description": "To load a tiled geojson layer, set the zoomlevel of the tiles",
+ "description": "To load a tiled geojson layer, set the zoomlevel of the tiles\n\nquestion: If using a tiled geojson, what is the zoomlevel of the tiles?\nifunset: This is not a tiled geojson",
"type": "number"
},
"isOsmCache": {
- "description": "Indicates that the upstream geojson data is OSM-derived.\nUseful for e.g. merging or for scripts generating this cache",
+ "description": "Indicates that the upstream geojson data is OSM-derived.\nUseful for e.g. merging or for scripts generating this cache.\nThis also indicates that making changes on this data is possible\n\nquestion: Is this geojson a cache of OpenStreetMap data?\nifunset: This is not an OpenStreetMap cache\niftrue: this is based on OpenStreetMap and can thus be edited",
"type": "boolean"
},
"mercatorCrs": {
- "description": "Some API's use a mercator-projection (EPSG:900913) instead of WGS84. Set the flag `mercatorCrs: true` in the source for this",
+ "description": "Some API's use a mercator-projection (EPSG:900913) instead of WGS84. Set the flag `mercatorCrs: true` in the source for this\n\nquestion: Does this geojson use EPSG:900913 instead of WGS84 as projection?\niftrue: This geojson uses EPSG:900913 instead of WGS84\nifunset: This geojson uses WGS84 just like most geojson (default)",
"type": "boolean"
},
"idKey": {
- "description": "Some API's have an id-field, but give it a different name.\nSetting this key will rename this field into 'id'",
+ "description": "Some API's have an id-field, but give it a different name.\nSetting this key will rename this field into 'id'\n\nifunset: An id with key `id` will be assigned automatically if no attribute `id` is set\ninline: This geojson uses {value} as attribute to set the id\nquestion: What is the name of the attribute containing the ID of the object?",
"type": "string"
}
},
@@ -1779,51 +1850,44 @@ export default {
]
},
"calculatedTags": {
- "description": "A list of extra tags to calculate, specified as \"keyToAssignTo=javascript-expression\".\nThere are a few extra functions available. Refer to Docs/CalculatedTags.md for more information\nThe functions will be run in order, e.g.\n[\n \"_max_overlap_m2=Math.max(...feat.overlapsWith(\"someOtherLayer\").map(o => o.overlap))\n \"_max_overlap_ratio=Number(feat._max_overlap_m2)/feat.area\n]\n\nThe specified tags are evaluated lazily. E.g. if a calculated tag is only used in the popup (e.g. the number of nearby features),\nthe expensive calculation will only be performed then for that feature. This avoids clogging up the contributors PC when all features are loaded.\n\nIf a tag has to be evaluated strictly, use ':=' instead:\n\n[\n\"_some_key:=some_javascript_expression\"\n]",
+ "description": "A list of extra tags to calculate, specified as \"keyToAssignTo=javascript-expression\".\nThere are a few extra functions available. Refer to Docs/CalculatedTags.md for more information\nThe functions will be run in order, e.g.\n[\nNot found... * \"_max_overlap_m2=Math.max(...feat.overlapsWith(\"someOtherLayer\").map(o => o.overlap))\n \"_max_overlap_ratio=Number(feat._max_overlap_m2)/feat.area\n]\n\nThe specified tags are evaluated lazily. E.g. if a calculated tag is only used in the popup (e.g. the number of nearby features),\nthe expensive calculation will only be performed then for that feature. This avoids clogging up the contributors PC when all features are loaded.\n\nIf a tag has to be evaluated strictly, use ':=' instead:\n\n[\n\"_some_key:=some_javascript_expression\"\n]\n\nSee the full documentation on [https://github.com/pietervdvn/MapComplete/blob/master/Docs/CalculatedTags.md]\n\ngroup: expert\nquestion: What extra attributes should be calculated with javascript?",
"type": "array",
"items": {
"type": "string"
}
},
- "doNotDownload": {
- "description": "If set, this layer will not query overpass; but it'll still match the tags above which are by chance returned by other layers.\nWorks well together with 'passAllFeatures', to add decoration",
- "type": "boolean"
- },
"isShown": {
- "description": "If set, only features matching this extra tag will be shown.\nThis is useful to hide certain features from view.\n\nImportant: hiding features does not work dynamically, but is only calculated when the data is first renders.\nThis implies that it is not possible to hide a feature after a tagging change\n\nThe default value is 'yes'",
+ "description": "If set, only features matching this extra tag will be shown.\nThis is useful to hide certain features from view based on a calculated tag or if the features are provided by a different layer.\n\nquestion: What other tags should features match for being shown?\ngroup: advanced\nifunset: all features which match the 'source'-specification are shown.",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
}
]
},
- "forceLoad": {
- "description": "Advanced option - might be set by the theme compiler\n\nIf true, this data will _always_ be loaded, even if the theme is disabled",
- "type": "boolean"
- },
"minzoom": {
- "description": "The minimum needed zoomlevel required before loading of the data start\nDefault: 0",
+ "description": "The minimum needed zoomlevel required to start loading and displaying the data.\nThis can be used to only show common features (e.g. a bicycle parking) only when the map is zoomed in very much (17).\nThis prevents cluttering the map with thousands of parkings if one is looking to an entire city.\n\nDefault: 0\ngroup: Basic\ntype: nat\nquestion: At what zoom level should features of the layer be shown?\nifunset: Always load this layer, even if the entire world is in view.",
"type": "number"
},
"shownByDefault": {
- "description": "Indicates if this layer is shown by default;\ncan be used to hide a layer from start, or to load the layer but only to show it where appropriate (e.g. for snapping to it)",
+ "description": "Indicates if this layer is shown by default;\ncan be used to hide a layer from start, or to load the layer but only to show it when appropriate (e.g. for advanced users)\n\nquestion: Should this layer be enabled when opening the map for the first time?\niftrue: the layer is enabled when opening the map\niffalse: the layer is hidden until the contributor enables it. (If the filter-popup is disabled, this might never get enabled nor loaded)\ndefault: true\ngroup: advanced",
"type": "boolean"
},
"minzoomVisible": {
- "description": "The zoom level at which point the data is hidden again\nDefault: 100 (thus: always visible",
+ "description": "The zoom level at which point the data is hidden again\nDefault: 100 (thus: always visible\n\ngroup: expert",
"type": "number"
},
"title": {
- "description": "The title shown in a popup for elements of this layer.",
+ "description": "question: What title should be shown on the infobox?\nThe title shown in a popup for elements of this layer.\n\ngroup: title\ntypes: use a fixed translation ; Use a dynamic tagRendering ; hidden\ntypesdefault: 1\ntype: translation\ninline: {translated{value}}",
"anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
{
"$ref": "#/definitions/TagRenderingConfigJson"
},
@@ -1832,8 +1896,12 @@ export default {
}
]
},
+ "popupInFloatover": {
+ "description": "Question: Should the information for this layer be shown in the sidebar or in a splash screen?\n\nIf set, open the selectedElementView in a floatOver instead of on the right.\n\niftrue: show the infobox in the splashscreen floating over the entire UI\niffalse: show the infobox in a sidebar on the right\ngroup: advanced\ndefault: sidebar",
+ "type": "boolean"
+ },
"titleIcons": {
- "description": "Small icons shown next to the title.\nIf not specified, the OsmLink and wikipedia links will be used by default.\nUse an empty array to hide them.\nNote that \"defaults\" will insert all the default titleIcons (which are added automatically)\n\nType: icon[]",
+ "description": "Small icons shown next to the title.\nIf not specified, the OsmLink and wikipedia links will be used by default.\nUse an empty array to hide them.\nNote that \"defaults\" will insert all the default titleIcons (which are added automatically)\n\nType: icon[]\ngroup: infobox",
"anyOf": [
{
"type": "array",
@@ -1863,42 +1931,40 @@ export default {
}
]
},
- "mapRendering": {
- "description": "Visualisation of the items on the map",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "anyOf": [
- {
- "$ref": "#/definitions/default_4"
- },
- {
- "$ref": "#/definitions/default_5"
- },
- {
- "$ref": "#/definitions/default"
- }
- ]
- }
- },
- {
- "type": "null"
- }
- ]
+ "pointRendering": {
+ "description": "Creates points to render on the map.\nThis can render points for point-objects, lineobjects or areaobjects; use 'location' to indicate where it should be rendered\ngroup: pointrendering",
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/default_4"
+ }
+ },
+ "lineRendering": {
+ "description": "Creates lines and areas to render on the map\ngroup: linerendering",
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/default_5"
+ }
},
"passAllFeatures": {
- "description": "If set, this layer will pass all the features it receives onto the next layer.\nThis is ideal for decoration, e.g. directionss on cameras",
+ "description": "If set, this layer will pass all the features it receives onto the next layer.\nThis is ideal for decoration, e.g. directions on cameras\niftrue: Make the features from this layer also available to the other layer; might result in this object being rendered by multiple layers\niffalse: normal behaviour: don't pass features allong\nquestion: should this layer pass features to the next layers?\ngroup: expert",
+ "type": "boolean"
+ },
+ "doNotDownload": {
+ "description": "If set, this layer will not query overpass; but it'll still match the tags above which are by chance returned by other layers.\nWorks well together with 'passAllFeatures', to add decoration\nThe opposite of `forceLoad`\n\niftrue: Do not attempt to query the data for this layer from overpass/the OSM API\niffalse: download the data as usual\ngroup: expert\nquestion: Should this layer be downloaded or is the data provided by a different layer (which has 'passAllFeatures'-set)?\ndefault: false",
+ "type": "boolean"
+ },
+ "forceLoad": {
+ "description": "Advanced option - might be set by the theme compiler\n\nIf true, this data will _always_ be loaded, even if the theme is disabled by a filter or hidden.\nThe opposite of `doNotDownload`\n\nquestion: Should this layer be forcibly loaded?\nifftrue: always download this layer, even if it is disabled\niffalse: only download data for this layer when needed (default)\ndefault: false\ngroup: expert",
"type": "boolean"
},
"presets": {
- "description": "Presets for this layer.\nA preset shows up when clicking the map on a without data (or when right-clicking/long-pressing);\nit will prompt the user to add a new point.\n\nThe most important aspect are the tags, which define which tags the new point will have;\nThe title is shown in the dialog, along with the first sentence of the description.\n\nUpon confirmation, the full description is shown beneath the buttons - perfect to add pictures and examples.\n\nNote: the icon of the preset is determined automatically based on the tags and the icon above. Don't worry about that!\nNB: if no presets are defined, the popup to add new points doesn't show up at all",
+ "description": "Presets for this layer.\nA preset shows up when clicking the map on a without data (or when right-clicking/long-pressing);\nit will prompt the user to add a new point.\n\nThe most important aspect are the tags, which define which tags the new point will have;\nThe title is shown in the dialog, along with the first sentence of the description.\n\nUpon confirmation, the full description is shown beneath the buttons - perfect to add pictures and examples.\n\nNote: the icon of the preset is determined automatically based on the tags and the icon above. Don't worry about that!\nNB: if no presets are defined, the popup to add new points doesn't show up at all\n\ngroup: presets",
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
- "description": "The title - shown on the 'add-new'-button.\n\nThis should include the article of the noun, e.g. 'a hydrant', 'a bicycle pump'.\nThis text will be inserted into `Add {category} here`, becoming `Add a hydrant here`.\n\nDo _not_ indicate 'new': 'add a new shop here' is incorrect, as the shop might have existed forever, it could just be unmapped!",
+ "description": "The title - shown on the 'add-new'-button.\n\nThis should include the article of the noun, e.g. 'a hydrant', 'a bicycle pump'.\nThis text will be inserted into `Add {category} here`, becoming `Add a hydrant here`.\n\nDo _not_ indicate 'new': 'add a new shop here' is incorrect, as the shop might have existed forever, it could just be unmapped!\n\nquestion: What is the word to describe this object?\ninline: Add {translated(value)::font-bold} here",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -1909,14 +1975,14 @@ export default {
]
},
"tags": {
- "description": "The tags to add. It determines the icon too",
+ "description": "A single tag (encoded as key=value
) out of all the tags to add onto the newly created point.\nNote that the icon in the UI will be chosen automatically based on the tags provided here.\n\nquestion: What tag should be added to the new object?\ntype: simple_tag\ntypeHelper: uploadableOnly",
"type": "array",
"items": {
"type": "string"
}
},
"description": {
- "description": "The _first sentence_ of the description is shown on the button of the `add` menu.\nThe full description is shown in the confirmation dialog.\n\n(The first sentence is until the first '.'-character in the description)",
+ "description": "An extra explanation of what the feature is, if it is not immediately clear from the title alone.\n\nThe _first sentence_ of the description is shown on the button of the `add` menu.\nThe full description is shown in the confirmation dialog.\n\n(The first sentence is until the first '.'-character in the description)\n\nquestion: How would you describe this feature?",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -1927,59 +1993,22 @@ export default {
]
},
"exampleImages": {
- "description": "Example images, which show real-life pictures of what such a feature might look like\n\nType: image",
+ "description": "The URL of an example image which shows a real-life example of what such a feature might look like.\n\nType: image\nquestion: What is the URL of an image showing such a feature?",
"type": "array",
"items": {
"type": "string"
}
},
- "preciseInput": {
- "description": "If set, the user will prompted to confirm the location before actually adding the data.\nThis will be with a 'drag crosshair'-method.\n\nIf 'preferredBackgroundCategory' is set, the element will attempt to pick a background layer of that category.",
- "anyOf": [
- {
- "type": "object",
- "properties": {
- "preferredBackground": {
- "description": "The type of background picture",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "snapToLayer": {
- "description": "If specified, these layers will be shown to and the new point will be snapped towards it",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "maxSnapDistance": {
- "description": "If specified, a new point will only be snapped if it is within this range.\nDistance in meter\n\nDefault: 10",
- "type": "number"
- }
- }
- },
- {
- "enum": [
- true
- ],
- "type": "boolean"
- }
- ]
+ "snapToLayer": {
+ "description": "question: Should the created point be snapped to a line layer?\n\nIf specified, these layers will be shown in the precise location picker and the new point will be snapped towards it.\nFor example, this can be used to snap against `walls_and_buildings` (e.g. to attach a defibrillator, an entrance, an artwork, ... to the wall)\nor to snap an obstacle (such as a bollard) to the `cycleways_and_roads`.\n\nsuggestions: return Array.from(layers.keys()).map(key => ({if: \"value=\"+key, then: key+\" - \"+layers.get(key).description}))",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "maxSnapDistance": {
+ "description": "question: What is the maximum distance in the location-input that a point can be moved to be snapped to a way?\n\ninline: a point is snapped if the location input is at most {value}m away from an object\n\nIf specified, a new point will only be snapped if it is within this range.\nIf further away, it'll be placed in the center of the location input\nDistance in meter\n\nifunset: Do not snap to a layer",
+ "type": "number"
}
},
"required": [
@@ -1989,7 +2018,7 @@ export default {
}
},
"tagRenderings": {
- "description": "All the tag renderings.\nA tag rendering is a block that either shows the known value or asks a question.\n\nRefer to the class `TagRenderingConfigJson` to see the possibilities.\n\nNote that we can also use a string here - where the string refers to a tag rendering defined in `assets/questions/questions.json`,\nwhere a few very general questions are defined e.g. website, phone number, ...\nFurthermore, _all_ the questions of another layer can be reused with `otherlayer.*`\nIf you need only a single of the tagRenderings, use `otherlayer.tagrenderingId`\nIf one or more questions have a 'group' or 'label' set, select all the entries with the corresponding group or label with `otherlayer.*group`\nRemark: if a tagRendering is 'lent' from another layer, the 'source'-tags are copied and added as condition.\nIf they are not wanted, remove them with an override\n\nA special value is 'questions', which indicates the location of the questions box. If not specified, it'll be appended to the bottom of the featureInfobox.\n\nAt last, one can define a group of renderings where parts of all strings will be replaced by multiple other strings.\nThis is mainly create questions for a 'left' and a 'right' side of the road.\nThese will be grouped and questions will be asked together",
+ "description": "question: Which tagRenderings should be shown in the infobox?\n\nA tag rendering is a block that either shows the known value or asks a question.\n\nRefer to the class `TagRenderingConfigJson` to see the possibilities.\n\nNote that we can also use a string here - where the string refers to a tag rendering defined in `assets/questions/questions.json`,\nwhere a few very general questions are defined e.g. website, phone number, ...\nFurthermore, _all_ the questions of another layer can be reused with `otherlayer.*`\nIf you need only a single of the tagRenderings, use `otherlayer.tagrenderingId`\nIf one or more questions have a 'group' or 'label' set, select all the entries with the corresponding group or label with `otherlayer.*group`\nRemark: if a tagRendering is 'lent' from another layer, the 'source'-tags are copied and added as condition.\nIf they are not wanted, remove them with an override\n\nA special value is 'questions', which indicates the location of the questions box. If not specified, it'll be appended to the bottom of the featureInfobox.\n\nAt last, one can define a group of renderings where parts of all strings will be replaced by multiple other strings.\nThis is mainly create questions for a 'left' and a 'right' side of the road.\nThese will be grouped and questions will be asked together\n\ntype: tagrendering[]\ngroup: tagrenderings",
"type": "array",
"items": {
"anyOf": [
@@ -2049,7 +2078,7 @@ export default {
}
},
"filter": {
- "description": "All the extra questions for filtering.\nIf a string is given, mapComplete will search in 'filters.json' for the appropriate filter or will try to parse it as `layername.filterid` and us that one",
+ "description": "All the extra questions for filtering.\nIf a string is given, mapComplete will search in 'filters.json' for the appropriate filter or will try to parse it as `layername.filterid` and us that one\n\ngroup: filters",
"anyOf": [
{
"type": "array",
@@ -2078,7 +2107,7 @@ export default {
]
},
"deletion": {
- "description": "This block defines under what circumstances the delete dialog is shown for objects of this layer.\nIf set, a dialog is shown to the user to (soft) delete the point.\nThe dialog is built to be user friendly and to prevent mistakes.\nIf deletion is not possible, the dialog will hide itself and show the reason of non-deletability instead.\n\nTo configure, the following values are possible:\n\n- false: never ever show the delete button\n- true: show the default delete button\n- undefined: use the mapcomplete default to show deletion or not. Currently, this is the same as 'false' but this will change in the future\n- or: a hash with options (see below)\n\n The delete dialog\n =================\n\n\n\n#### Hard deletion if enough experience\n\nA feature can only be deleted from OpenStreetMap by mapcomplete if:\n\n- It is a node\n- No ways or relations use the node\n- The logged-in user has enough experience OR the user is the only one to have edited the point previously\n- The logged-in user has no unread messages (or has a ton of experience)\n- The user did not select one of the 'non-delete-options' (see below)\n\nIn all other cases, a 'soft deletion' is used.\n\n#### Soft deletion\n\nA 'soft deletion' is when the point isn't deleted from OSM but retagged so that it'll won't how up in the mapcomplete theme anymore.\nThis makes it look like it was deleted, without doing damage. A fixme will be added to the point.\n\nNote that a soft deletion is _only_ possible if these tags are provided by the theme creator, as they'll be different for every theme\n\n#### No-delete options\n\nIn some cases, the contributor might want to delete something for the wrong reason (e.g. someone who wants to have a path removed \"because the path is on their private property\").\nHowever, the path exists in reality and should thus be on OSM - otherwise the next contributor will pass by and notice \"hey, there is a path missing here! Let me redraw it in OSM!)\n\nThe correct approach is to retag the feature in such a way that it is semantically correct *and* that it doesn't show up on the theme anymore.\nA no-delete option is offered as 'reason to delete it', but secretly retags.",
+ "description": "This block defines under what circumstances the delete dialog is shown for objects of this layer.\nIf set, a dialog is shown to the user to (soft) delete the point.\nThe dialog is built to be user friendly and to prevent mistakes.\nIf deletion is not possible, the dialog will hide itself and show the reason of non-deletability instead.\n\nTo configure, the following values are possible:\n\n- false: never ever show the delete button\n- true: show the default delete button\n- undefined: use the mapcomplete default to show deletion or not. Currently, this is the same as 'false' but this will change in the future\n- or: a hash with options (see below)\n\n### The delete dialog\n\n\n\n#### Hard deletion if enough experience\n\nA feature can only be deleted from OpenStreetMap by mapcomplete if:\n\n- It is a node\n- No ways or relations use the node\n- The logged-in user has enough experience OR the user is the only one to have edited the point previously\n- The logged-in user has no unread messages (or has a ton of experience)\n- The user did not select one of the 'non-delete-options' (see below)\n\nIn all other cases, a 'soft deletion' is used.\n\n#### Soft deletion\n\nA 'soft deletion' is when the point isn't deleted fromOSM but retagged so that it'll won't how up in the mapcomplete theme anymore.\nThis makes it look like it was deleted, without doing damage. A fixme will be added to the point.\n\nNote that a soft deletion is _only_ possible if these tags are provided by the theme creator, as they'll be different for every theme\n\n##### No-delete options\n\nIn some cases, the contributor might want to delete something for the wrong reason (e.g. someone who wants to have a path removed \"because the path is on their private property\").\nHowever, the path exists in reality and should thus be on OSM - otherwise the next contributor will pass by and notice \"hey, there is a path missing here! Let me redraw it in OSM!)\n\nThe correct approach is to retag the feature in such a way that it is semantically correct *and* that it doesn't show up on the theme anymore.\nA no-delete option is offered as 'reason to delete it', but secretly retags.\n\ngroup: editing\ntypes: Use an advanced delete configuration ; boolean\niftrue: Allow deletion\niffalse: Do not allow deletion\nifunset: Do not allow deletion",
"anyOf": [
{
"$ref": "#/definitions/DeleteConfigJson"
@@ -2089,7 +2118,7 @@ export default {
]
},
"allowMove": {
- "description": "Indicates if a point can be moved and configures the modalities.\n\nA feature can be moved by MapComplete if:\n\n- It is a point\n- The point is _not_ part of a way or a a relation.\n\nOff by default. Can be enabled by setting this flag or by configuring.",
+ "description": "Indicates if a point can be moved and why.\n\nA feature can be moved by MapComplete if:\n\n- It is a point\n- The point is _not_ part of a way or a a relation.\n\ntypes: use an advanced move configuration ; boolean\ngroup: editing\nquestion: Is deleting a point allowed?\niftrue: Allow contributors to move a point (for accuracy or a relocation)\niffalse: Don't allow contributors to move points\nifunset: Don't allow contributors to move points (default)",
"anyOf": [
{
"$ref": "#/definitions/default_3"
@@ -2100,7 +2129,7 @@ export default {
]
},
"allowSplit": {
- "description": "If set, a 'split this way' button is shown on objects rendered as LineStrings, e.g. highways.\n\nIf the way is part of a relation, MapComplete will attempt to update this relation as well",
+ "description": "If set, a 'split this way' button is shown on objects rendered as LineStrings, e.g. highways.\n\nIf the way is part of a relation, MapComplete will attempt to update this relation as well\nquestion: Should the contributor be able to split ways using this layer?\niftrue: enable the 'split-roads'-component\niffalse: don't enable the split-roads componenet\nifunset: don't enable the split-roads component\ngroup: editing",
"type": "boolean"
},
"units": {
@@ -2110,7 +2139,7 @@ export default {
}
},
"syncSelection": {
- "description": "If set, synchronizes whether or not this layer is enabled.\n\nno: Do not sync at all, always revert to default\nlocal: keep selection on local storage\ntheme-only: sync via OSM, but this layer will only be toggled in this theme\nglobal: all layers with this ID will be synced accross all themes",
+ "description": "If set, synchronizes whether or not this layer is enabled.\n\ngroup: advanced\nquestion: Should enabling/disabling the layer be saved (locally or in the cloud)?\nsuggestions: return [{if: \"value=no\", then: \"Don't save, always revert to the default\"}, {if: \"value=local\", then: \"Save selection in local storage\"}, {if: \"value=theme-only\", then: \"Save the state in the OSM-usersettings, but apply on this theme only (default)\"}, {if: \"value=global\", then: \"Save in OSM-usersettings and toggle on _all_ themes using this layer\"}]",
"enum": [
"global",
"local",
@@ -2120,13 +2149,17 @@ export default {
"type": "string"
},
"#": {
- "description": "Used for comments and/or to disable some checks\n\nno-question-hint-check: disables a check in MiscTagRenderingChecks which complains about 'div', 'span' or 'class=subtle'-HTML elements in the tagRendering",
+ "description": "Used for comments and/or to disable some checks\n\nno-question-hint-check: disables a check in MiscTagRenderingChecks which complains about 'div', 'span' or 'class=subtle'-HTML elements in the tagRendering\n\ngroup: hidden",
"type": "string"
+ },
+ "fullNodeDatabase": {
+ "description": "_Set automatically by MapComplete, please ignore_\n\ngroup: hidden",
+ "type": "boolean"
}
},
"required": [
"id",
- "mapRendering",
+ "pointRendering",
"source"
]
},
@@ -2134,11 +2167,11 @@ export default {
"type": "object",
"properties": {
"id": {
- "description": "The id of this layer.\nThis should be a simple, lowercase, human readable string that is used to identify the layer.",
+ "description": "question: What is the identifier of this layer?\n\nThis should be a simple, lowercase, human readable string that is used to identify the layer.\n A good ID is:\n - a noun\n - written in singular\n - describes the object\n - in english\n - only has lowercase letters, numbers or underscores. Do not use a space or a dash\n\ntype: id\ngroup: Basic",
"type": "string"
},
"name": {
- "description": "The name of this layer\nUsed in the layer control panel and the 'Personal theme'.\n\nIf not given, will be hidden (and thus not toggable) in the layer control",
+ "description": "Used in the layer control panel to toggle a layer on and of.\n\nifunset: This will hide the layer in the layer control, making it not filterable and not toggleable\n\ngroup: Basic\nquestion: What is the name of this layer?",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -2149,7 +2182,7 @@ export default {
]
},
"description": {
- "description": "A description for this layer.\nShown in the layer selections and in the personel theme",
+ "description": "A description for the features shown in this layer.\nThis often resembles the introduction of the wiki.osm.org-page for this feature.\n\ngroup: Basic\nquestion: How would you describe the features that are shown on this layer?",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -2160,17 +2193,17 @@ export default {
]
},
"source": {
- "description": "This determines where the data for the layer is fetched: from OSM or from an external geojson dataset.\n\nIf no 'geojson' is defined, data will be fetched from overpass and the OSM-API.\n\nEvery source _must_ define which tags _must_ be present in order to be picked up.\n\nNote: a source must always be defined. 'special' is only allowed if this is a builtin-layer",
+ "description": "Question: Where should the data be fetched from?\ntitle: Data Source\n\nThis determines where the data for the layer is fetched: from OSM or from an external geojson dataset.\n\nIf no 'geojson' is defined, data will be fetched from overpass and the OSM-API.\n\nEvery source _must_ define which tags _must_ be present in order to be picked up.\n\nNote: a source must always be defined. 'special' is only allowed if this is a builtin-layer\n\ntypes: Load data with specific tags from OpenStreetMap ; Load data from an external geojson source ;\ntypesdefault: 0\ngroup: Basic",
"anyOf": [
{
"type": "object",
"properties": {
"osmTags": {
"$ref": "#/definitions/TagConfigJson",
- "description": "Every source must set which tags have to be present in order to load the given layer."
+ "description": "question: Which tags must be present on the feature to show it in this layer?\nEvery source must set which tags have to be present in order to load the given layer."
},
"maxCacheAge": {
- "description": "The maximum amount of seconds that a tile is allowed to linger in the cache",
+ "description": "question: How long (in seconds) is the data allowed to remain cached until it must be refreshed?\nThe maximum amount of seconds that a tile is allowed to linger in the cache\n\ntype: nat\ndefault: 30 days",
"type": "number"
}
},
@@ -2182,23 +2215,23 @@ export default {
"type": "object",
"properties": {
"geoJson": {
- "description": "The actual source of the data to load, if loaded via geojson.\n\n# A single geojson-file\nsource: {geoJson: \"https://my.source.net/some-geo-data.geojson\"}\n fetches a geojson from a third party source\n\n# A tiled geojson source\nsource: {geoJson: \"https://my.source.net/some-tile-geojson-{layer}-{z}-{x}-{y}.geojson\", geoJsonZoomLevel: 14}\n to use a tiled geojson source. The web server must offer multiple geojsons. {z}, {x} and {y} are substituted by the location; {layer} is substituted with the id of the loaded layer\n\nSome API's use a BBOX instead of a tile, this can be used by specifying {y_min}, {y_max}, {x_min} and {x_max}",
+ "description": "The actual source of the data to load, if loaded via geojson.\n\n# A single geojson-file\nsource: {geoJson: \"https://my.source.net/some-geo-data.geojson\"}\n fetches a geojson from a third party source\n\n# A tiled geojson source\nsource: {geoJson: \"https://my.source.net/some-tile-geojson-{layer}-{z}-{x}-{y}.geojson\", geoJsonZoomLevel: 14}\n to use a tiled geojson source. The web server must offer multiple geojsons. {z}, {x} and {y} are substituted by the location; {layer} is substituted with the id of the loaded layer\n\nSome API's use a BBOX instead of a tile, this can be used by specifying {y_min}, {y_max}, {x_min} and {x_max}\n\nquestion: What is the URL of the geojson?\ntype: url",
"type": "string"
},
"geoJsonZoomLevel": {
- "description": "To load a tiled geojson layer, set the zoomlevel of the tiles",
+ "description": "To load a tiled geojson layer, set the zoomlevel of the tiles\n\nquestion: If using a tiled geojson, what is the zoomlevel of the tiles?\nifunset: This is not a tiled geojson",
"type": "number"
},
"isOsmCache": {
- "description": "Indicates that the upstream geojson data is OSM-derived.\nUseful for e.g. merging or for scripts generating this cache",
+ "description": "Indicates that the upstream geojson data is OSM-derived.\nUseful for e.g. merging or for scripts generating this cache.\nThis also indicates that making changes on this data is possible\n\nquestion: Is this geojson a cache of OpenStreetMap data?\nifunset: This is not an OpenStreetMap cache\niftrue: this is based on OpenStreetMap and can thus be edited",
"type": "boolean"
},
"mercatorCrs": {
- "description": "Some API's use a mercator-projection (EPSG:900913) instead of WGS84. Set the flag `mercatorCrs: true` in the source for this",
+ "description": "Some API's use a mercator-projection (EPSG:900913) instead of WGS84. Set the flag `mercatorCrs: true` in the source for this\n\nquestion: Does this geojson use EPSG:900913 instead of WGS84 as projection?\niftrue: This geojson uses EPSG:900913 instead of WGS84\nifunset: This geojson uses WGS84 just like most geojson (default)",
"type": "boolean"
},
"idKey": {
- "description": "Some API's have an id-field, but give it a different name.\nSetting this key will rename this field into 'id'",
+ "description": "Some API's have an id-field, but give it a different name.\nSetting this key will rename this field into 'id'\n\nifunset: An id with key `id` will be assigned automatically if no attribute `id` is set\ninline: This geojson uses {value} as attribute to set the id\nquestion: What is the name of the attribute containing the ID of the object?",
"type": "string"
}
},
@@ -2216,51 +2249,44 @@ export default {
]
},
"calculatedTags": {
- "description": "A list of extra tags to calculate, specified as \"keyToAssignTo=javascript-expression\".\nThere are a few extra functions available. Refer to Docs/CalculatedTags.md for more information\nThe functions will be run in order, e.g.\n[\n \"_max_overlap_m2=Math.max(...feat.overlapsWith(\"someOtherLayer\").map(o => o.overlap))\n \"_max_overlap_ratio=Number(feat._max_overlap_m2)/feat.area\n]\n\nThe specified tags are evaluated lazily. E.g. if a calculated tag is only used in the popup (e.g. the number of nearby features),\nthe expensive calculation will only be performed then for that feature. This avoids clogging up the contributors PC when all features are loaded.\n\nIf a tag has to be evaluated strictly, use ':=' instead:\n\n[\n\"_some_key:=some_javascript_expression\"\n]",
+ "description": "A list of extra tags to calculate, specified as \"keyToAssignTo=javascript-expression\".\nThere are a few extra functions available. Refer to Docs/CalculatedTags.md for more information\nThe functions will be run in order, e.g.\n[\nNot found... * \"_max_overlap_m2=Math.max(...feat.overlapsWith(\"someOtherLayer\").map(o => o.overlap))\n \"_max_overlap_ratio=Number(feat._max_overlap_m2)/feat.area\n]\n\nThe specified tags are evaluated lazily. E.g. if a calculated tag is only used in the popup (e.g. the number of nearby features),\nthe expensive calculation will only be performed then for that feature. This avoids clogging up the contributors PC when all features are loaded.\n\nIf a tag has to be evaluated strictly, use ':=' instead:\n\n[\n\"_some_key:=some_javascript_expression\"\n]\n\nSee the full documentation on [https://github.com/pietervdvn/MapComplete/blob/master/Docs/CalculatedTags.md]\n\ngroup: expert\nquestion: What extra attributes should be calculated with javascript?",
"type": "array",
"items": {
"type": "string"
}
},
- "doNotDownload": {
- "description": "If set, this layer will not query overpass; but it'll still match the tags above which are by chance returned by other layers.\nWorks well together with 'passAllFeatures', to add decoration",
- "type": "boolean"
- },
"isShown": {
- "description": "If set, only features matching this extra tag will be shown.\nThis is useful to hide certain features from view.\n\nImportant: hiding features does not work dynamically, but is only calculated when the data is first renders.\nThis implies that it is not possible to hide a feature after a tagging change\n\nThe default value is 'yes'",
+ "description": "If set, only features matching this extra tag will be shown.\nThis is useful to hide certain features from view based on a calculated tag or if the features are provided by a different layer.\n\nquestion: What other tags should features match for being shown?\ngroup: advanced\nifunset: all features which match the 'source'-specification are shown.",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
}
]
},
- "forceLoad": {
- "description": "Advanced option - might be set by the theme compiler\n\nIf true, this data will _always_ be loaded, even if the theme is disabled",
- "type": "boolean"
- },
"minzoom": {
- "description": "The minimum needed zoomlevel required before loading of the data start\nDefault: 0",
+ "description": "The minimum needed zoomlevel required to start loading and displaying the data.\nThis can be used to only show common features (e.g. a bicycle parking) only when the map is zoomed in very much (17).\nThis prevents cluttering the map with thousands of parkings if one is looking to an entire city.\n\nDefault: 0\ngroup: Basic\ntype: nat\nquestion: At what zoom level should features of the layer be shown?\nifunset: Always load this layer, even if the entire world is in view.",
"type": "number"
},
"shownByDefault": {
- "description": "Indicates if this layer is shown by default;\ncan be used to hide a layer from start, or to load the layer but only to show it where appropriate (e.g. for snapping to it)",
+ "description": "Indicates if this layer is shown by default;\ncan be used to hide a layer from start, or to load the layer but only to show it when appropriate (e.g. for advanced users)\n\nquestion: Should this layer be enabled when opening the map for the first time?\niftrue: the layer is enabled when opening the map\niffalse: the layer is hidden until the contributor enables it. (If the filter-popup is disabled, this might never get enabled nor loaded)\ndefault: true\ngroup: advanced",
"type": "boolean"
},
"minzoomVisible": {
- "description": "The zoom level at which point the data is hidden again\nDefault: 100 (thus: always visible",
+ "description": "The zoom level at which point the data is hidden again\nDefault: 100 (thus: always visible\n\ngroup: expert",
"type": "number"
},
"title": {
- "description": "The title shown in a popup for elements of this layer.",
+ "description": "question: What title should be shown on the infobox?\nThe title shown in a popup for elements of this layer.\n\ngroup: title\ntypes: use a fixed translation ; Use a dynamic tagRendering ; hidden\ntypesdefault: 1\ntype: translation\ninline: {translated{value}}",
"anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
{
"$ref": "#/definitions/TagRenderingConfigJson"
},
@@ -2269,8 +2295,12 @@ export default {
}
]
},
+ "popupInFloatover": {
+ "description": "Question: Should the information for this layer be shown in the sidebar or in a splash screen?\n\nIf set, open the selectedElementView in a floatOver instead of on the right.\n\niftrue: show the infobox in the splashscreen floating over the entire UI\niffalse: show the infobox in a sidebar on the right\ngroup: advanced\ndefault: sidebar",
+ "type": "boolean"
+ },
"titleIcons": {
- "description": "Small icons shown next to the title.\nIf not specified, the OsmLink and wikipedia links will be used by default.\nUse an empty array to hide them.\nNote that \"defaults\" will insert all the default titleIcons (which are added automatically)\n\nType: icon[]",
+ "description": "Small icons shown next to the title.\nIf not specified, the OsmLink and wikipedia links will be used by default.\nUse an empty array to hide them.\nNote that \"defaults\" will insert all the default titleIcons (which are added automatically)\n\nType: icon[]\ngroup: infobox",
"anyOf": [
{
"type": "array",
@@ -2300,42 +2330,40 @@ export default {
}
]
},
- "mapRendering": {
- "description": "Visualisation of the items on the map",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "anyOf": [
- {
- "$ref": "#/definitions/default_4"
- },
- {
- "$ref": "#/definitions/default_5"
- },
- {
- "$ref": "#/definitions/default"
- }
- ]
- }
- },
- {
- "type": "null"
- }
- ]
+ "pointRendering": {
+ "description": "Creates points to render on the map.\nThis can render points for point-objects, lineobjects or areaobjects; use 'location' to indicate where it should be rendered\ngroup: pointrendering",
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/default_4"
+ }
+ },
+ "lineRendering": {
+ "description": "Creates lines and areas to render on the map\ngroup: linerendering",
+ "type": "array",
+ "items": {
+ "$ref": "#/definitions/default_5"
+ }
},
"passAllFeatures": {
- "description": "If set, this layer will pass all the features it receives onto the next layer.\nThis is ideal for decoration, e.g. directionss on cameras",
+ "description": "If set, this layer will pass all the features it receives onto the next layer.\nThis is ideal for decoration, e.g. directions on cameras\niftrue: Make the features from this layer also available to the other layer; might result in this object being rendered by multiple layers\niffalse: normal behaviour: don't pass features allong\nquestion: should this layer pass features to the next layers?\ngroup: expert",
+ "type": "boolean"
+ },
+ "doNotDownload": {
+ "description": "If set, this layer will not query overpass; but it'll still match the tags above which are by chance returned by other layers.\nWorks well together with 'passAllFeatures', to add decoration\nThe opposite of `forceLoad`\n\niftrue: Do not attempt to query the data for this layer from overpass/the OSM API\niffalse: download the data as usual\ngroup: expert\nquestion: Should this layer be downloaded or is the data provided by a different layer (which has 'passAllFeatures'-set)?\ndefault: false",
+ "type": "boolean"
+ },
+ "forceLoad": {
+ "description": "Advanced option - might be set by the theme compiler\n\nIf true, this data will _always_ be loaded, even if the theme is disabled by a filter or hidden.\nThe opposite of `doNotDownload`\n\nquestion: Should this layer be forcibly loaded?\nifftrue: always download this layer, even if it is disabled\niffalse: only download data for this layer when needed (default)\ndefault: false\ngroup: expert",
"type": "boolean"
},
"presets": {
- "description": "Presets for this layer.\nA preset shows up when clicking the map on a without data (or when right-clicking/long-pressing);\nit will prompt the user to add a new point.\n\nThe most important aspect are the tags, which define which tags the new point will have;\nThe title is shown in the dialog, along with the first sentence of the description.\n\nUpon confirmation, the full description is shown beneath the buttons - perfect to add pictures and examples.\n\nNote: the icon of the preset is determined automatically based on the tags and the icon above. Don't worry about that!\nNB: if no presets are defined, the popup to add new points doesn't show up at all",
+ "description": "Presets for this layer.\nA preset shows up when clicking the map on a without data (or when right-clicking/long-pressing);\nit will prompt the user to add a new point.\n\nThe most important aspect are the tags, which define which tags the new point will have;\nThe title is shown in the dialog, along with the first sentence of the description.\n\nUpon confirmation, the full description is shown beneath the buttons - perfect to add pictures and examples.\n\nNote: the icon of the preset is determined automatically based on the tags and the icon above. Don't worry about that!\nNB: if no presets are defined, the popup to add new points doesn't show up at all\n\ngroup: presets",
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
- "description": "The title - shown on the 'add-new'-button.\n\nThis should include the article of the noun, e.g. 'a hydrant', 'a bicycle pump'.\nThis text will be inserted into `Add {category} here`, becoming `Add a hydrant here`.\n\nDo _not_ indicate 'new': 'add a new shop here' is incorrect, as the shop might have existed forever, it could just be unmapped!",
+ "description": "The title - shown on the 'add-new'-button.\n\nThis should include the article of the noun, e.g. 'a hydrant', 'a bicycle pump'.\nThis text will be inserted into `Add {category} here`, becoming `Add a hydrant here`.\n\nDo _not_ indicate 'new': 'add a new shop here' is incorrect, as the shop might have existed forever, it could just be unmapped!\n\nquestion: What is the word to describe this object?\ninline: Add {translated(value)::font-bold} here",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -2346,14 +2374,14 @@ export default {
]
},
"tags": {
- "description": "The tags to add. It determines the icon too",
+ "description": "A single tag (encoded as key=value
) out of all the tags to add onto the newly created point.\nNote that the icon in the UI will be chosen automatically based on the tags provided here.\n\nquestion: What tag should be added to the new object?\ntype: simple_tag\ntypeHelper: uploadableOnly",
"type": "array",
"items": {
"type": "string"
}
},
"description": {
- "description": "The _first sentence_ of the description is shown on the button of the `add` menu.\nThe full description is shown in the confirmation dialog.\n\n(The first sentence is until the first '.'-character in the description)",
+ "description": "An extra explanation of what the feature is, if it is not immediately clear from the title alone.\n\nThe _first sentence_ of the description is shown on the button of the `add` menu.\nThe full description is shown in the confirmation dialog.\n\n(The first sentence is until the first '.'-character in the description)\n\nquestion: How would you describe this feature?",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -2364,59 +2392,22 @@ export default {
]
},
"exampleImages": {
- "description": "Example images, which show real-life pictures of what such a feature might look like\n\nType: image",
+ "description": "The URL of an example image which shows a real-life example of what such a feature might look like.\n\nType: image\nquestion: What is the URL of an image showing such a feature?",
"type": "array",
"items": {
"type": "string"
}
},
- "preciseInput": {
- "description": "If set, the user will prompted to confirm the location before actually adding the data.\nThis will be with a 'drag crosshair'-method.\n\nIf 'preferredBackgroundCategory' is set, the element will attempt to pick a background layer of that category.",
- "anyOf": [
- {
- "type": "object",
- "properties": {
- "preferredBackground": {
- "description": "The type of background picture",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "snapToLayer": {
- "description": "If specified, these layers will be shown to and the new point will be snapped towards it",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "maxSnapDistance": {
- "description": "If specified, a new point will only be snapped if it is within this range.\nDistance in meter\n\nDefault: 10",
- "type": "number"
- }
- }
- },
- {
- "enum": [
- true
- ],
- "type": "boolean"
- }
- ]
+ "snapToLayer": {
+ "description": "question: Should the created point be snapped to a line layer?\n\nIf specified, these layers will be shown in the precise location picker and the new point will be snapped towards it.\nFor example, this can be used to snap against `walls_and_buildings` (e.g. to attach a defibrillator, an entrance, an artwork, ... to the wall)\nor to snap an obstacle (such as a bollard) to the `cycleways_and_roads`.\n\nsuggestions: return Array.from(layers.keys()).map(key => ({if: \"value=\"+key, then: key+\" - \"+layers.get(key).description}))",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "maxSnapDistance": {
+ "description": "question: What is the maximum distance in the location-input that a point can be moved to be snapped to a way?\n\ninline: a point is snapped if the location input is at most {value}m away from an object\n\nIf specified, a new point will only be snapped if it is within this range.\nIf further away, it'll be placed in the center of the location input\nDistance in meter\n\nifunset: Do not snap to a layer",
+ "type": "number"
}
},
"required": [
@@ -2426,7 +2417,7 @@ export default {
}
},
"tagRenderings": {
- "description": "All the tag renderings.\nA tag rendering is a block that either shows the known value or asks a question.\n\nRefer to the class `TagRenderingConfigJson` to see the possibilities.\n\nNote that we can also use a string here - where the string refers to a tag rendering defined in `assets/questions/questions.json`,\nwhere a few very general questions are defined e.g. website, phone number, ...\nFurthermore, _all_ the questions of another layer can be reused with `otherlayer.*`\nIf you need only a single of the tagRenderings, use `otherlayer.tagrenderingId`\nIf one or more questions have a 'group' or 'label' set, select all the entries with the corresponding group or label with `otherlayer.*group`\nRemark: if a tagRendering is 'lent' from another layer, the 'source'-tags are copied and added as condition.\nIf they are not wanted, remove them with an override\n\nA special value is 'questions', which indicates the location of the questions box. If not specified, it'll be appended to the bottom of the featureInfobox.\n\nAt last, one can define a group of renderings where parts of all strings will be replaced by multiple other strings.\nThis is mainly create questions for a 'left' and a 'right' side of the road.\nThese will be grouped and questions will be asked together",
+ "description": "question: Which tagRenderings should be shown in the infobox?\n\nA tag rendering is a block that either shows the known value or asks a question.\n\nRefer to the class `TagRenderingConfigJson` to see the possibilities.\n\nNote that we can also use a string here - where the string refers to a tag rendering defined in `assets/questions/questions.json`,\nwhere a few very general questions are defined e.g. website, phone number, ...\nFurthermore, _all_ the questions of another layer can be reused with `otherlayer.*`\nIf you need only a single of the tagRenderings, use `otherlayer.tagrenderingId`\nIf one or more questions have a 'group' or 'label' set, select all the entries with the corresponding group or label with `otherlayer.*group`\nRemark: if a tagRendering is 'lent' from another layer, the 'source'-tags are copied and added as condition.\nIf they are not wanted, remove them with an override\n\nA special value is 'questions', which indicates the location of the questions box. If not specified, it'll be appended to the bottom of the featureInfobox.\n\nAt last, one can define a group of renderings where parts of all strings will be replaced by multiple other strings.\nThis is mainly create questions for a 'left' and a 'right' side of the road.\nThese will be grouped and questions will be asked together\n\ntype: tagrendering[]\ngroup: tagrenderings",
"type": "array",
"items": {
"anyOf": [
@@ -2486,7 +2477,7 @@ export default {
}
},
"filter": {
- "description": "All the extra questions for filtering.\nIf a string is given, mapComplete will search in 'filters.json' for the appropriate filter or will try to parse it as `layername.filterid` and us that one",
+ "description": "All the extra questions for filtering.\nIf a string is given, mapComplete will search in 'filters.json' for the appropriate filter or will try to parse it as `layername.filterid` and us that one\n\ngroup: filters",
"anyOf": [
{
"type": "array",
@@ -2515,7 +2506,7 @@ export default {
]
},
"deletion": {
- "description": "This block defines under what circumstances the delete dialog is shown for objects of this layer.\nIf set, a dialog is shown to the user to (soft) delete the point.\nThe dialog is built to be user friendly and to prevent mistakes.\nIf deletion is not possible, the dialog will hide itself and show the reason of non-deletability instead.\n\nTo configure, the following values are possible:\n\n- false: never ever show the delete button\n- true: show the default delete button\n- undefined: use the mapcomplete default to show deletion or not. Currently, this is the same as 'false' but this will change in the future\n- or: a hash with options (see below)\n\n The delete dialog\n =================\n\n\n\n#### Hard deletion if enough experience\n\nA feature can only be deleted from OpenStreetMap by mapcomplete if:\n\n- It is a node\n- No ways or relations use the node\n- The logged-in user has enough experience OR the user is the only one to have edited the point previously\n- The logged-in user has no unread messages (or has a ton of experience)\n- The user did not select one of the 'non-delete-options' (see below)\n\nIn all other cases, a 'soft deletion' is used.\n\n#### Soft deletion\n\nA 'soft deletion' is when the point isn't deleted from OSM but retagged so that it'll won't how up in the mapcomplete theme anymore.\nThis makes it look like it was deleted, without doing damage. A fixme will be added to the point.\n\nNote that a soft deletion is _only_ possible if these tags are provided by the theme creator, as they'll be different for every theme\n\n#### No-delete options\n\nIn some cases, the contributor might want to delete something for the wrong reason (e.g. someone who wants to have a path removed \"because the path is on their private property\").\nHowever, the path exists in reality and should thus be on OSM - otherwise the next contributor will pass by and notice \"hey, there is a path missing here! Let me redraw it in OSM!)\n\nThe correct approach is to retag the feature in such a way that it is semantically correct *and* that it doesn't show up on the theme anymore.\nA no-delete option is offered as 'reason to delete it', but secretly retags.",
+ "description": "This block defines under what circumstances the delete dialog is shown for objects of this layer.\nIf set, a dialog is shown to the user to (soft) delete the point.\nThe dialog is built to be user friendly and to prevent mistakes.\nIf deletion is not possible, the dialog will hide itself and show the reason of non-deletability instead.\n\nTo configure, the following values are possible:\n\n- false: never ever show the delete button\n- true: show the default delete button\n- undefined: use the mapcomplete default to show deletion or not. Currently, this is the same as 'false' but this will change in the future\n- or: a hash with options (see below)\n\n### The delete dialog\n\n\n\n#### Hard deletion if enough experience\n\nA feature can only be deleted from OpenStreetMap by mapcomplete if:\n\n- It is a node\n- No ways or relations use the node\n- The logged-in user has enough experience OR the user is the only one to have edited the point previously\n- The logged-in user has no unread messages (or has a ton of experience)\n- The user did not select one of the 'non-delete-options' (see below)\n\nIn all other cases, a 'soft deletion' is used.\n\n#### Soft deletion\n\nA 'soft deletion' is when the point isn't deleted fromOSM but retagged so that it'll won't how up in the mapcomplete theme anymore.\nThis makes it look like it was deleted, without doing damage. A fixme will be added to the point.\n\nNote that a soft deletion is _only_ possible if these tags are provided by the theme creator, as they'll be different for every theme\n\n##### No-delete options\n\nIn some cases, the contributor might want to delete something for the wrong reason (e.g. someone who wants to have a path removed \"because the path is on their private property\").\nHowever, the path exists in reality and should thus be on OSM - otherwise the next contributor will pass by and notice \"hey, there is a path missing here! Let me redraw it in OSM!)\n\nThe correct approach is to retag the feature in such a way that it is semantically correct *and* that it doesn't show up on the theme anymore.\nA no-delete option is offered as 'reason to delete it', but secretly retags.\n\ngroup: editing\ntypes: Use an advanced delete configuration ; boolean\niftrue: Allow deletion\niffalse: Do not allow deletion\nifunset: Do not allow deletion",
"anyOf": [
{
"$ref": "#/definitions/DeleteConfigJson"
@@ -2526,7 +2517,7 @@ export default {
]
},
"allowMove": {
- "description": "Indicates if a point can be moved and configures the modalities.\n\nA feature can be moved by MapComplete if:\n\n- It is a point\n- The point is _not_ part of a way or a a relation.\n\nOff by default. Can be enabled by setting this flag or by configuring.",
+ "description": "Indicates if a point can be moved and why.\n\nA feature can be moved by MapComplete if:\n\n- It is a point\n- The point is _not_ part of a way or a a relation.\n\ntypes: use an advanced move configuration ; boolean\ngroup: editing\nquestion: Is deleting a point allowed?\niftrue: Allow contributors to move a point (for accuracy or a relocation)\niffalse: Don't allow contributors to move points\nifunset: Don't allow contributors to move points (default)",
"anyOf": [
{
"$ref": "#/definitions/default_3"
@@ -2537,7 +2528,7 @@ export default {
]
},
"allowSplit": {
- "description": "If set, a 'split this way' button is shown on objects rendered as LineStrings, e.g. highways.\n\nIf the way is part of a relation, MapComplete will attempt to update this relation as well",
+ "description": "If set, a 'split this way' button is shown on objects rendered as LineStrings, e.g. highways.\n\nIf the way is part of a relation, MapComplete will attempt to update this relation as well\nquestion: Should the contributor be able to split ways using this layer?\niftrue: enable the 'split-roads'-component\niffalse: don't enable the split-roads componenet\nifunset: don't enable the split-roads component\ngroup: editing",
"type": "boolean"
},
"units": {
@@ -2547,7 +2538,7 @@ export default {
}
},
"syncSelection": {
- "description": "If set, synchronizes whether or not this layer is enabled.\n\nno: Do not sync at all, always revert to default\nlocal: keep selection on local storage\ntheme-only: sync via OSM, but this layer will only be toggled in this theme\nglobal: all layers with this ID will be synced accross all themes",
+ "description": "If set, synchronizes whether or not this layer is enabled.\n\ngroup: advanced\nquestion: Should enabling/disabling the layer be saved (locally or in the cloud)?\nsuggestions: return [{if: \"value=no\", then: \"Don't save, always revert to the default\"}, {if: \"value=local\", then: \"Save selection in local storage\"}, {if: \"value=theme-only\", then: \"Save the state in the OSM-usersettings, but apply on this theme only (default)\"}, {if: \"value=global\", then: \"Save in OSM-usersettings and toggle on _all_ themes using this layer\"}]",
"enum": [
"global",
"local",
@@ -2557,8 +2548,12 @@ export default {
"type": "string"
},
"#": {
- "description": "Used for comments and/or to disable some checks\n\nno-question-hint-check: disables a check in MiscTagRenderingChecks which complains about 'div', 'span' or 'class=subtle'-HTML elements in the tagRendering",
+ "description": "Used for comments and/or to disable some checks\n\nno-question-hint-check: disables a check in MiscTagRenderingChecks which complains about 'div', 'span' or 'class=subtle'-HTML elements in the tagRendering\n\ngroup: hidden",
"type": "string"
+ },
+ "fullNodeDatabase": {
+ "description": "_Set automatically by MapComplete, please ignore_\n\ngroup: hidden",
+ "type": "boolean"
}
}
},
@@ -2566,16 +2561,30 @@ export default {
"type": "object",
"properties": {
"icon": {
+ "description": "question: What icon should be shown in the link button?\nifunset: do not show an icon\ntype: icon",
"type": "string"
},
- "text": {},
+ "text": {
+ "description": "question: What text should be shown in the link icon?\n\nNote that {lat},{lon},{zoom}, {language} and {theme} will be replaced\n\nifunset: do not show a text",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
"href": {
+ "description": "question: if clicked, what webpage should open?\nNote that {lat},{lon},{zoom}, {language} and {theme} will be replaced\n\ntype: url",
"type": "string"
},
"newTab": {
+ "description": "question: Should the link open in a new tab?\niftrue: Open in a new tab\niffalse: do not open in a new tab\nifunset: do not open in a new tab",
"type": "boolean"
},
"requirements": {
+ "description": "question: When should the extra button be shown?\nsuggestions: return [{if: \"value=iframe\", then: \"When shown in an iframe\"}, {if: \"value=no-iframe\", then: \"When shown as stand-alone webpage\"}, {if: \"value=welcome-message\", then: \"When the welcome messages are enabled\"}, {if: \"value=iframe\", then: \"When the welcome messages are disabled\"}]",
"type": "array",
"items": {
"enum": [
@@ -2594,4 +2603,4 @@ export default {
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
-}
+}
\ No newline at end of file
diff --git a/Docs/Schemas/LineRenderingConfigJson.schema.json b/Docs/Schemas/LineRenderingConfigJson.schema.json
index 744b13d2b7..c6defd62bf 100644
--- a/Docs/Schemas/LineRenderingConfigJson.schema.json
+++ b/Docs/Schemas/LineRenderingConfigJson.schema.json
@@ -3,10 +3,10 @@
"type": "object",
"properties": {
"color": {
- "description": "The color for way-elements and SVG-elements.\nIf the value starts with \"--\", the style of the body element will be queried for the corresponding variable instead",
+ "description": "question: What color should lines be drawn in?\n\nFor an area, this will be the colour of the outside line.\nIf the value starts with \"--\", the style of the body element will be queried for the corresponding variable instead\n\ntypes: dynamic value ; string\ntitle: Line Colour\ninline: The line colour always is {value}\ntype: color",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "string"
@@ -14,10 +14,10 @@
]
},
"width": {
- "description": "The stroke-width for way-elements",
+ "description": "question: How wide should the line be?\nThe stroke-width for way-elements\n\ntypes: dynamic value ; string\ntitle: Line width\ninline: The line width is {value} pixels\ntype: pnat\nifunset: Use the default-linewidth of 7 pixels",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": [
@@ -28,47 +28,25 @@
]
},
"dashArray": {
- "description": "A dasharray, e.g. \"5 6\"\nThe dasharray defines 'pixels of line, pixels of gap, pixels of line, pixels of gap',\nDefault value: \"\" (empty string == full line)",
- "anyOf": [
- {
- "$ref": "#/definitions/TagRenderingConfigJson"
- },
- {
- "type": "string"
- }
- ]
+ "description": "question: Should a dasharray be used to render the lines?\nThe dasharray defines 'pixels of line, pixels of gap, pixels of line, pixels of gap, ...'. For example, `5 6` will be 5 pixels of line followed by a 6 pixel gap.\nCannot be a dynamic property due to a mapbox limitation\nifunset: Ways are rendered with a full line",
+ "type": "string"
},
"lineCap": {
- "description": "The form at the end of a line",
+ "description": "question: What form should the line-ending have?\nsuggestions: return [{if:\"value=round\",then:\"Round endings\"}, {if: \"value=square\", then: \"square endings\"}, {if: \"value=butt\", then: \"no ending (square ending at the end, without padding)\"}]\ntypes: dynamic value ; string\ntitle: Line Cap\nifunset: Use the default value (round ending)",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "string"
}
]
},
- "fill": {
- "description": "Whether or not to fill polygons",
- "anyOf": [
- {
- "$ref": "#/definitions/TagRenderingConfigJson"
- },
- {
- "enum": [
- "no",
- "yes"
- ],
- "type": "string"
- }
- ]
- },
"fillColor": {
- "description": "The color to fill a polygon with.\nIf undefined, this will be slightly more opaque version of the stroke line",
+ "description": "question: What colour should be used as fill colour for polygons?\nifunset: The polygon fill colour will be a more transparent version of the stroke colour\nsuggestions: return [{if: \"value=#00000000\", then: \"Use a transparent fill (only render the outline)\"}]\ninline: The fill colour is {value}\ntypes: dynamic value ; string\ntype: color",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "string"
@@ -76,10 +54,10 @@
]
},
"offset": {
- "description": "The number of pixels this line should be moved.\nUse a positive numbe to move to the right, a negative to move to the left (left/right as defined by the drawing direction of the line).\n\nIMPORTANT: MapComplete will already normalize 'key:both:property' and 'key:both' into the corresponding 'key:left' and 'key:right' tagging (same for 'sidewalk=left/right/both' which is rewritten to 'sidewalk:left' and 'sidewalk:right')\nThis simplifies programming. Refer to the CalculatedTags.md-documentation for more details",
+ "description": "question: Should the lines be moved (offsetted) with a number of pixels against the geographical lines?\nThe number of pixels this line should be moved.\nUse a positive number to move to the right in the drawing direction or a negative to move to the left (left/right as defined by the drawing direction of the line).\n\nIMPORTANT: MapComplete will already normalize 'key:both:property' and 'key:both' into the corresponding 'key:left' and 'key:right' tagging (same for 'sidewalk=left/right/both' which is rewritten to 'sidewalk:left' and 'sidewalk:right')\nThis simplifies programming. Refer to the CalculatedTags.md-documentation for more details\nifunset: don't offset lines on the map\ninline: Pixel offset by {value} pixels\ntypes: dynamic value ; number\ntype: int",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "number"
@@ -89,13 +67,12 @@
},
"definitions": {
"TagConfigJson": {
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation",
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
"type": "object",
"properties": {
"or": {
@@ -114,8 +91,7 @@
}
]
},
- "AndTagConfigJson": {
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{and:TagConfigJson[];}": {
"type": "object",
"properties": {
"and": {
@@ -130,8 +106,7 @@
],
"additionalProperties": false
},
- "OrTagConfigJson": {
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{or:TagConfigJson[];}": {
"type": "object",
"properties": {
"or": {
@@ -218,48 +193,101 @@
],
"additionalProperties": false
},
+ "MinimalTagRenderingConfigJson": {
+ "description": "Mostly used for lineRendering and pointRendering",
+ "type": "object",
+ "properties": {
+ "render": {
+ "description": "question: What value should be rendered?\n\nThis piece of text will be shown in the infobox.\nNote that \"&LBRACEkey&RBRACE\"-parts are substituted by the corresponding values of the element.\n\nThis value will be used if there is no mapping which matches (or there are no matches)\nNote that this is a HTML-interpreted value, so you can add links as e.g. '<a href='{website}'>{website}</a>' or include images such as `This is of type A <br><img src='typeA-icon.svg' />`",
+ "type": "string"
+ },
+ "mappings": {
+ "description": "Allows fixed-tag inputs, shown either as radiobuttons or as checkboxes",
+ "type": "array",
+ "items": {
+ "type": "object",
+ "properties": {
+ "if": {
+ "$ref": "#/definitions/TagConfigJson",
+ "description": "question: When should this single mapping match?\n\nIf this condition is met, then the text under `then` will be shown.\nIf no value matches, and the user selects this mapping as an option, then these tags will be uploaded to OSM.\n\nFor example: {'if': 'diet:vegetarion=yes', 'then':'A vegetarian option is offered here'}\n\nThis can be an substituting-tag as well, e.g. {'if': 'addr:street:={_calculated_nearby_streetname}', 'then': '{_calculated_nearby_streetname}'}"
+ },
+ "then": {
+ "description": "question: What text should be shown?\n\nIf the condition `if` is met, the text `then` will be rendered.\nIf not known yet, the user will be presented with `then` as an option",
+ "type": "string"
+ }
+ },
+ "required": [
+ "if",
+ "then"
+ ]
+ }
+ }
+ },
+ "additionalProperties": false
+ },
+ "IconConfigJson": {
+ "type": "object",
+ "properties": {
+ "icon": {
+ "description": "question: What icon should be used?\ntype: icon\nsuggestions: return [\"pin\",\"square\",\"circle\",\"checkmark\",\"clock\",\"close\",\"crosshair\",\"help\",\"home\",\"invalid\",\"location\",\"location_empty\",\"location_locked\",\"note\",\"resolved\",\"ring\",\"scissors\",\"teardrop\",\"teardrop_with_hole_green\",\"triangle\"].map(i => ({if: \"value=\"+i, then: i, icon: i}))",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
+ },
+ {
+ "type": "object",
+ "properties": {
+ "builtin": {
+ "type": "string"
+ },
+ "override": {}
+ },
+ "required": [
+ "builtin",
+ "override"
+ ]
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "color": {
+ "description": "question: What colour should the icon be?\nThis will only work for the default icons such as `pin`,`circle`,...\ntype: color",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
+ },
+ {
+ "type": "object",
+ "properties": {
+ "builtin": {
+ "type": "string"
+ },
+ "override": {}
+ },
+ "required": [
+ "builtin",
+ "override"
+ ]
+ },
+ {
+ "type": "string"
+ }
+ ]
+ }
+ },
+ "required": [
+ "icon"
+ ],
+ "additionalProperties": false
+ },
"TagRenderingConfigJson": {
"description": "A TagRenderingConfigJson is a single piece of code which converts one ore more tags into a HTML-snippet.\nFor an _editable_ tagRendering, use 'QuestionableTagRenderingConfigJson' instead, which extends this one",
"type": "object",
"properties": {
- "id": {
- "description": "The id of the tagrendering, should be an unique string.\nUsed to keep the translations in sync. Only used in the tagRenderings-array of a layerConfig, not requered otherwise.\n\nUse 'questions' to trigger the question box of this group (if a group is defined)",
- "type": "string"
- },
- "labels": {
- "description": "A list of labels. These are strings that are used for various purposes, e.g. to filter them away",
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "classes": {
- "description": "A list of css-classes to apply to the entire tagRendering if the answer is known (not applied on the question).\nThis is only for advanced users",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "description": {
- "description": "A human-readable text explaining what this tagRendering does",
- "anyOf": [
- {
- "$ref": "#/definitions/Record"
- },
- {
- "type": "string"
- }
- ]
- },
"render": {
- "description": "Renders this value. Note that \"{key}\"-parts are substituted by the corresponding values of the element.\nIf neither 'textFieldQuestion' nor 'mappings' are defined, this text is simply shown as default value.\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '{website}' or include images such as `This is of type A
`\ntype: rendered",
+ "description": "question: What text should be rendered?\n\nThis piece of text will be shown in the infobox.\nIn this text, values within braces (such as {braced(key)}) are replaced by the corresponding `value` in the object.\nFor example, if the object contains tags `amenity=school; name=Windy Hill School`, the render string `This school is named {name}` will be shown to the user as `This school is named Windy Hill School`\n\nThis text will be shown if:\n- there is no mapping which matches (or there are no matches)\n- no question, no mappings and no 'freeform' is set\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '<a href='{website}'>{website}</a>' or include images such as `This is of type A <br><img src='typeA-icon.svg' />`\ntype: rendered",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -295,16 +323,38 @@
}
]
},
- "condition": {
- "description": "Only show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "icon": {
+ "description": "question: what icon should be shown next to the 'render' value?\nAn icon shown next to the rendering; typically shown pretty small\nThis is only shown next to the \"render\" value\nType: icon",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "object",
+ "properties": {
+ "path": {
+ "description": "The path to the icon\nType: icon",
+ "type": "string"
+ },
+ "class": {
+ "description": "A hint to mapcomplete on how to render this icon within the mapping.\nThis is translated to 'mapping-icon-', so defining your own in combination with a custom CSS is possible (but discouraged)",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path"
+ ]
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "string"
+ }
+ ]
+ },
+ "condition": {
+ "description": "question: When should this item be shown?\n\nOnly show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
+ },
+ {
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -312,15 +362,13 @@
]
},
"metacondition": {
- "description": "If set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
+ "description": "question: When should this item be shown (including special conditions)?\n\nIf set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -328,11 +376,11 @@
]
},
"freeform": {
- "description": "Allow freeform text input from the user",
+ "description": "question: Should a freeform text field be shown?\nAllow freeform text input from the user\nifunset: Do not add a freeform text field",
"type": "object",
"properties": {
"key": {
- "description": "If this key is present, then 'render' is used to display the value.\nIf this is undefined, the rendering is _always_ shown",
+ "description": "What attribute should be filled out\nIf this key is present in the feature, then 'render' is used to display the value.\nIf this is undefined, the rendering is _always_ shown",
"type": "string"
}
},
@@ -348,10 +396,10 @@
"properties": {
"if": {
"$ref": "#/definitions/TagConfigJson",
- "description": "If this condition is met, then the text under `then` will be shown.\nIf no value matches, and the user selects this mapping as an option, then these tags will be uploaded to OSM.\n\nFor example: {'if': 'diet:vegetarion=yes', 'then':'A vegetarian option is offered here'}\n\nThis can be an substituting-tag as well, e.g. {'if': 'addr:street:={_calculated_nearby_streetname}', 'then': '{_calculated_nearby_streetname}'}"
+ "description": "question: When should this single mapping match?\n\nIf this condition is met, then the text under `then` will be shown.\nIf no value matches, and the user selects this mapping as an option, then these tags will be uploaded to OSM.\n\nFor example: {'if': 'diet:vegetarion=yes', 'then':'A vegetarian option is offered here'}\n\nThis can be an substituting-tag as well, e.g. {'if': 'addr:street:={_calculated_nearby_streetname}', 'then': '{_calculated_nearby_streetname}'}"
},
"then": {
- "description": "If the condition `if` is met, the text `then` will be rendered.\nIf not known yet, the user will be presented with `then` as an option\nType: rendered",
+ "description": "question: What text should be shown?\n\nIf the condition `if` is met, the text `then` will be rendered.\nIf not known yet, the user will be presented with `then` as an option\nType: rendered",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -362,7 +410,7 @@
]
},
"icon": {
- "description": "An icon supporting this mapping; typically shown pretty small\nType: icon",
+ "description": "question: What icon should be added to this mapping?\nAn icon supporting this mapping; typically shown pretty small\ninline:
{icon}\nType: icon",
"anyOf": [
{
"type": "object",
@@ -391,6 +439,21 @@
"then"
]
}
+ },
+ "description": {
+ "description": "A human-readable text explaining what this tagRendering does.\nMostly used for the shared tagrenderings",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "classes": {
+ "description": "question: What css-classes should be applied to showing this attribute?\n\nA list of css-classes to apply to the entire tagRendering.\nThese classes are applied in 'answer'-mode, not in question mode\nThis is only for advanced users.\n\nValues are split on ` ` (space)",
+ "type": "string"
}
},
"additionalProperties": false
diff --git a/Docs/Schemas/LineRenderingConfigJsonJSC.ts b/Docs/Schemas/LineRenderingConfigJsonJSC.ts
index db7177b6f9..9f628057cf 100644
--- a/Docs/Schemas/LineRenderingConfigJsonJSC.ts
+++ b/Docs/Schemas/LineRenderingConfigJsonJSC.ts
@@ -3,10 +3,10 @@ export default {
"type": "object",
"properties": {
"color": {
- "description": "The color for way-elements and SVG-elements.\nIf the value starts with \"--\", the style of the body element will be queried for the corresponding variable instead",
+ "description": "question: What color should lines be drawn in?\n\nFor an area, this will be the colour of the outside line.\nIf the value starts with \"--\", the style of the body element will be queried for the corresponding variable instead\n\ntypes: dynamic value ; string\ntitle: Line Colour\ninline: The line colour always is {value}\ntype: color",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "string"
@@ -14,10 +14,10 @@ export default {
]
},
"width": {
- "description": "The stroke-width for way-elements",
+ "description": "question: How wide should the line be?\nThe stroke-width for way-elements\n\ntypes: dynamic value ; string\ntitle: Line width\ninline: The line width is {value} pixels\ntype: pnat\nifunset: Use the default-linewidth of 7 pixels",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": [
@@ -28,47 +28,25 @@ export default {
]
},
"dashArray": {
- "description": "A dasharray, e.g. \"5 6\"\nThe dasharray defines 'pixels of line, pixels of gap, pixels of line, pixels of gap',\nDefault value: \"\" (empty string == full line)",
- "anyOf": [
- {
- "$ref": "#/definitions/TagRenderingConfigJson"
- },
- {
- "type": "string"
- }
- ]
+ "description": "question: Should a dasharray be used to render the lines?\nThe dasharray defines 'pixels of line, pixels of gap, pixels of line, pixels of gap, ...'. For example, `5 6` will be 5 pixels of line followed by a 6 pixel gap.\nCannot be a dynamic property due to a mapbox limitation\nifunset: Ways are rendered with a full line",
+ "type": "string"
},
"lineCap": {
- "description": "The form at the end of a line",
+ "description": "question: What form should the line-ending have?\nsuggestions: return [{if:\"value=round\",then:\"Round endings\"}, {if: \"value=square\", then: \"square endings\"}, {if: \"value=butt\", then: \"no ending (square ending at the end, without padding)\"}]\ntypes: dynamic value ; string\ntitle: Line Cap\nifunset: Use the default value (round ending)",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "string"
}
]
},
- "fill": {
- "description": "Whether or not to fill polygons",
- "anyOf": [
- {
- "$ref": "#/definitions/TagRenderingConfigJson"
- },
- {
- "enum": [
- "no",
- "yes"
- ],
- "type": "string"
- }
- ]
- },
"fillColor": {
- "description": "The color to fill a polygon with.\nIf undefined, this will be slightly more opaque version of the stroke line",
+ "description": "question: What colour should be used as fill colour for polygons?\nifunset: The polygon fill colour will be a more transparent version of the stroke colour\nsuggestions: return [{if: \"value=#00000000\", then: \"Use a transparent fill (only render the outline)\"}]\ninline: The fill colour is {value}\ntypes: dynamic value ; string\ntype: color",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "string"
@@ -76,10 +54,10 @@ export default {
]
},
"offset": {
- "description": "The number of pixels this line should be moved.\nUse a positive numbe to move to the right, a negative to move to the left (left/right as defined by the drawing direction of the line).\n\nIMPORTANT: MapComplete will already normalize 'key:both:property' and 'key:both' into the corresponding 'key:left' and 'key:right' tagging (same for 'sidewalk=left/right/both' which is rewritten to 'sidewalk:left' and 'sidewalk:right')\nThis simplifies programming. Refer to the CalculatedTags.md-documentation for more details",
+ "description": "question: Should the lines be moved (offsetted) with a number of pixels against the geographical lines?\nThe number of pixels this line should be moved.\nUse a positive number to move to the right in the drawing direction or a negative to move to the left (left/right as defined by the drawing direction of the line).\n\nIMPORTANT: MapComplete will already normalize 'key:both:property' and 'key:both' into the corresponding 'key:left' and 'key:right' tagging (same for 'sidewalk=left/right/both' which is rewritten to 'sidewalk:left' and 'sidewalk:right')\nThis simplifies programming. Refer to the CalculatedTags.md-documentation for more details\nifunset: don't offset lines on the map\ninline: Pixel offset by {value} pixels\ntypes: dynamic value ; number\ntype: int",
"anyOf": [
{
- "$ref": "#/definitions/TagRenderingConfigJson"
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
},
{
"type": "number"
@@ -89,13 +67,12 @@ export default {
},
"definitions": {
"TagConfigJson": {
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation",
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
"type": "object",
"properties": {
"or": {
@@ -114,8 +91,7 @@ export default {
}
]
},
- "AndTagConfigJson": {
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{and:TagConfigJson[];}": {
"type": "object",
"properties": {
"and": {
@@ -129,8 +105,7 @@ export default {
"and"
]
},
- "OrTagConfigJson": {
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{or:TagConfigJson[];}": {
"type": "object",
"properties": {
"or": {
@@ -213,48 +188,99 @@ export default {
"canonicalDenomination"
]
},
+ "MinimalTagRenderingConfigJson": {
+ "description": "Mostly used for lineRendering and pointRendering",
+ "type": "object",
+ "properties": {
+ "render": {
+ "description": "question: What value should be rendered?\n\nThis piece of text will be shown in the infobox.\nNote that \"&LBRACEkey&RBRACE\"-parts are substituted by the corresponding values of the element.\n\nThis value will be used if there is no mapping which matches (or there are no matches)\nNote that this is a HTML-interpreted value, so you can add links as e.g. '<a href='{website}'>{website}</a>' or include images such as `This is of type A <br><img src='typeA-icon.svg' />`",
+ "type": "string"
+ },
+ "mappings": {
+ "description": "Allows fixed-tag inputs, shown either as radiobuttons or as checkboxes",
+ "type": "array",
+ "items": {
+ "type": "object",
+ "properties": {
+ "if": {
+ "$ref": "#/definitions/TagConfigJson",
+ "description": "question: When should this single mapping match?\n\nIf this condition is met, then the text under `then` will be shown.\nIf no value matches, and the user selects this mapping as an option, then these tags will be uploaded to OSM.\n\nFor example: {'if': 'diet:vegetarion=yes', 'then':'A vegetarian option is offered here'}\n\nThis can be an substituting-tag as well, e.g. {'if': 'addr:street:={_calculated_nearby_streetname}', 'then': '{_calculated_nearby_streetname}'}"
+ },
+ "then": {
+ "description": "question: What text should be shown?\n\nIf the condition `if` is met, the text `then` will be rendered.\nIf not known yet, the user will be presented with `then` as an option",
+ "type": "string"
+ }
+ },
+ "required": [
+ "if",
+ "then"
+ ]
+ }
+ }
+ }
+ },
+ "IconConfigJson": {
+ "type": "object",
+ "properties": {
+ "icon": {
+ "description": "question: What icon should be used?\ntype: icon\nsuggestions: return [\"pin\",\"square\",\"circle\",\"checkmark\",\"clock\",\"close\",\"crosshair\",\"help\",\"home\",\"invalid\",\"location\",\"location_empty\",\"location_locked\",\"note\",\"resolved\",\"ring\",\"scissors\",\"teardrop\",\"teardrop_with_hole_green\",\"triangle\"].map(i => ({if: \"value=\"+i, then: i, icon: i}))",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
+ },
+ {
+ "type": "object",
+ "properties": {
+ "builtin": {
+ "type": "string"
+ },
+ "override": {}
+ },
+ "required": [
+ "builtin",
+ "override"
+ ]
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "color": {
+ "description": "question: What colour should the icon be?\nThis will only work for the default icons such as `pin`,`circle`,...\ntype: color",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
+ },
+ {
+ "type": "object",
+ "properties": {
+ "builtin": {
+ "type": "string"
+ },
+ "override": {}
+ },
+ "required": [
+ "builtin",
+ "override"
+ ]
+ },
+ {
+ "type": "string"
+ }
+ ]
+ }
+ },
+ "required": [
+ "icon"
+ ]
+ },
"TagRenderingConfigJson": {
"description": "A TagRenderingConfigJson is a single piece of code which converts one ore more tags into a HTML-snippet.\nFor an _editable_ tagRendering, use 'QuestionableTagRenderingConfigJson' instead, which extends this one",
"type": "object",
"properties": {
- "id": {
- "description": "The id of the tagrendering, should be an unique string.\nUsed to keep the translations in sync. Only used in the tagRenderings-array of a layerConfig, not requered otherwise.\n\nUse 'questions' to trigger the question box of this group (if a group is defined)",
- "type": "string"
- },
- "labels": {
- "description": "A list of labels. These are strings that are used for various purposes, e.g. to filter them away",
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "classes": {
- "description": "A list of css-classes to apply to the entire tagRendering if the answer is known (not applied on the question).\nThis is only for advanced users",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "description": {
- "description": "A human-readable text explaining what this tagRendering does",
- "anyOf": [
- {
- "$ref": "#/definitions/Record"
- },
- {
- "type": "string"
- }
- ]
- },
"render": {
- "description": "Renders this value. Note that \"{key}\"-parts are substituted by the corresponding values of the element.\nIf neither 'textFieldQuestion' nor 'mappings' are defined, this text is simply shown as default value.\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '{website}' or include images such as `This is of type A
`\ntype: rendered",
+ "description": "question: What text should be rendered?\n\nThis piece of text will be shown in the infobox.\nIn this text, values within braces (such as {braced(key)}) are replaced by the corresponding `value` in the object.\nFor example, if the object contains tags `amenity=school; name=Windy Hill School`, the render string `This school is named {name}` will be shown to the user as `This school is named Windy Hill School`\n\nThis text will be shown if:\n- there is no mapping which matches (or there are no matches)\n- no question, no mappings and no 'freeform' is set\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '<a href='{website}'>{website}</a>' or include images such as `This is of type A <br><img src='typeA-icon.svg' />`\ntype: rendered",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -290,16 +316,38 @@ export default {
}
]
},
- "condition": {
- "description": "Only show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "icon": {
+ "description": "question: what icon should be shown next to the 'render' value?\nAn icon shown next to the rendering; typically shown pretty small\nThis is only shown next to the \"render\" value\nType: icon",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "object",
+ "properties": {
+ "path": {
+ "description": "The path to the icon\nType: icon",
+ "type": "string"
+ },
+ "class": {
+ "description": "A hint to mapcomplete on how to render this icon within the mapping.\nThis is translated to 'mapping-icon-', so defining your own in combination with a custom CSS is possible (but discouraged)",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path"
+ ]
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "string"
+ }
+ ]
+ },
+ "condition": {
+ "description": "question: When should this item be shown?\n\nOnly show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
+ },
+ {
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -307,15 +355,13 @@ export default {
]
},
"metacondition": {
- "description": "If set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
+ "description": "question: When should this item be shown (including special conditions)?\n\nIf set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -323,11 +369,11 @@ export default {
]
},
"freeform": {
- "description": "Allow freeform text input from the user",
+ "description": "question: Should a freeform text field be shown?\nAllow freeform text input from the user\nifunset: Do not add a freeform text field",
"type": "object",
"properties": {
"key": {
- "description": "If this key is present, then 'render' is used to display the value.\nIf this is undefined, the rendering is _always_ shown",
+ "description": "What attribute should be filled out\nIf this key is present in the feature, then 'render' is used to display the value.\nIf this is undefined, the rendering is _always_ shown",
"type": "string"
}
},
@@ -343,10 +389,10 @@ export default {
"properties": {
"if": {
"$ref": "#/definitions/TagConfigJson",
- "description": "If this condition is met, then the text under `then` will be shown.\nIf no value matches, and the user selects this mapping as an option, then these tags will be uploaded to OSM.\n\nFor example: {'if': 'diet:vegetarion=yes', 'then':'A vegetarian option is offered here'}\n\nThis can be an substituting-tag as well, e.g. {'if': 'addr:street:={_calculated_nearby_streetname}', 'then': '{_calculated_nearby_streetname}'}"
+ "description": "question: When should this single mapping match?\n\nIf this condition is met, then the text under `then` will be shown.\nIf no value matches, and the user selects this mapping as an option, then these tags will be uploaded to OSM.\n\nFor example: {'if': 'diet:vegetarion=yes', 'then':'A vegetarian option is offered here'}\n\nThis can be an substituting-tag as well, e.g. {'if': 'addr:street:={_calculated_nearby_streetname}', 'then': '{_calculated_nearby_streetname}'}"
},
"then": {
- "description": "If the condition `if` is met, the text `then` will be rendered.\nIf not known yet, the user will be presented with `then` as an option\nType: rendered",
+ "description": "question: What text should be shown?\n\nIf the condition `if` is met, the text `then` will be rendered.\nIf not known yet, the user will be presented with `then` as an option\nType: rendered",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -357,7 +403,7 @@ export default {
]
},
"icon": {
- "description": "An icon supporting this mapping; typically shown pretty small\nType: icon",
+ "description": "question: What icon should be added to this mapping?\nAn icon supporting this mapping; typically shown pretty small\ninline:
{icon}\nType: icon",
"anyOf": [
{
"type": "object",
@@ -386,6 +432,21 @@ export default {
"then"
]
}
+ },
+ "description": {
+ "description": "A human-readable text explaining what this tagRendering does.\nMostly used for the shared tagrenderings",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "classes": {
+ "description": "question: What css-classes should be applied to showing this attribute?\n\nA list of css-classes to apply to the entire tagRendering.\nThese classes are applied in 'answer'-mode, not in question mode\nThis is only for advanced users.\n\nValues are split on ` ` (space)",
+ "type": "string"
}
}
}
diff --git a/Docs/Schemas/MappingConfigJson.schema.json b/Docs/Schemas/MappingConfigJson.schema.json
index 2b5926dd83..1dc636c32f 100644
--- a/Docs/Schemas/MappingConfigJson.schema.json
+++ b/Docs/Schemas/MappingConfigJson.schema.json
@@ -3,13 +3,21 @@
"properties": {
"if": {
"$ref": "#/definitions/TagConfigJson",
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation"
+ "description": "question: What tags should be matched to show this option?\n\nIf in 'question'-mode and the contributor selects this option, these tags will be applied to the object"
},
"then": {
- "description": "Shown if the 'if is fulfilled\nType: rendered"
+ "description": "Question: What corresponding text should be shown?\nShown if the `if` is fulfilled\nType: rendered",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
},
"icon": {
- "description": "An extra icon supporting the choice\nType: icon",
+ "description": "question: What icon should be shown next to this mapping?\n\nThis icon will only be shown if the value is known, it is not displayed in the options (but might be in the future)\n\nifunset: Show no icon\nType: icon",
"anyOf": [
{
"type": "object",
@@ -33,15 +41,13 @@
]
},
"hideInAnswer": {
- "description": "In some cases, multiple taggings exist (e.g. a default assumption, or a commonly mapped abbreviation and a fully written variation).\n\nIn the latter case, a correct text should be shown, but only a single, canonical tagging should be selectable by the user.\nIn this case, one of the mappings can be hiden by setting this flag.\n\nTo demonstrate an example making a default assumption:\n\nmappings: [\n {\n if: \"access=\", -- no access tag present, we assume accessible\n then: \"Accessible to the general public\",\n hideInAnswer: true\n },\n {\n if: \"access=yes\",\n then: \"Accessible to the general public\", -- the user selected this, we add that to OSM\n },\n {\n if: \"access=no\",\n then: \"Not accessible to the public\"\n }\n]\n\n\nFor example, for an operator, we have `operator=Agentschap Natuur en Bos`, which is often abbreviated to `operator=ANB`.\nThen, we would add two mappings:\n{\n if: \"operator=Agentschap Natuur en Bos\" -- the non-abbreviated version which should be uploaded\n then: \"Maintained by Agentschap Natuur en Bos\"\n},\n{\n if: \"operator=ANB\", -- we don't want to upload abbreviations\n then: \"Maintained by Agentschap Natuur en Bos\"\n hideInAnswer: true\n}\n\nHide in answer can also be a tagsfilter, e.g. to make sure an option is only shown when appropriate.\nKeep in mind that this is reverse logic: it will be hidden in the answer if the condition is true, it will thus only show in the case of a mismatch\n\ne.g., for toilets: if \"wheelchair=no\", we know there is no wheelchair dedicated room.\nFor the location of the changing table, the option \"in the wheelchair accessible toilet is weird\", so we write:\n\n{\n \"question\": \"Where is the changing table located?\"\n \"mappings\": [\n {\"if\":\"changing_table:location=female\",\"then\":\"In the female restroom\"},\n {\"if\":\"changing_table:location=male\",\"then\":\"In the male restroom\"},\n {\"if\":\"changing_table:location=wheelchair\",\"then\":\"In the wheelchair accessible restroom\", \"hideInAnswer\": \"wheelchair=no\"},\n\n ]\n}\n\nAlso have a look for the meta-tags\n{\n if: \"operator=Agentschap Natuur en Bos\",\n then: \"Maintained by Agentschap Natuur en Bos\",\n hideInAnswer: \"_country!=be\"\n}",
+ "description": "question: Under what circumstances should this mapping be hidden from the possibilities a contributor can pick?\niftrue: Never show this mapping as option to pick\nifunset: Always show this mapping as option to pick\ntype: tag\n\nIn some cases, multiple taggings exist (e.g. a default assumption, or a commonly mapped abbreviation and a fully written variation).\n\nIn the latter case, a correct text should be shown, but only a single, canonical tagging should be selectable by the user.\nIn this case, one of the mappings can be hiden by setting this flag.\n\nTo demonstrate an example making a default assumption:\n\nmappings: [\n {\n if: \"access=\", -- no access tag present, we assume accessible\n then: \"Accessible to the general public\",\n hideInAnswer: true\n },\n {\n if: \"access=yes\",\n then: \"Accessible to the general public\", -- the user selected this, we add that to OSM\n },\n {\n if: \"access=no\",\n then: \"Not accessible to the public\"\n }\n]\n\n\nFor example, for an operator, we have `operator=Agentschap Natuur en Bos`, which is often abbreviated to `operator=ANB`.\nThen, we would add two mappings:\n{\n if: \"operator=Agentschap Natuur en Bos\" -- the non-abbreviated version which should be uploaded\n then: \"Maintained by Agentschap Natuur en Bos\"\n},\n{\n if: \"operator=ANB\", -- we don't want to upload abbreviations\n then: \"Maintained by Agentschap Natuur en Bos\"\n hideInAnswer: true\n}\n\nHide in answer can also be a tagsfilter, e.g. to make sure an option is only shown when appropriate.\nKeep in mind that this is reverse logic: it will be hidden in the answer if the condition is true, it will thus only show in the case of a mismatch\n\ne.g., for toilets: if \"wheelchair=no\", we know there is no wheelchair dedicated room.\nFor the location of the changing table, the option \"in the wheelchair accessible toilet is weird\", so we write:\n\n{\n \"question\": \"Where is the changing table located?\"\n \"mappings\": [\n {\"if\":\"changing_table:location=female\",\"then\":\"In the female restroom\"},\n {\"if\":\"changing_table:location=male\",\"then\":\"In the male restroom\"},\n {\"if\":\"changing_table:location=wheelchair\",\"then\":\"In the wheelchair accessible restroom\", \"hideInAnswer\": \"wheelchair=no\"},\n\n ]\n}\n\nAlso have a look for the meta-tags\n{\n if: \"operator=Agentschap Natuur en Bos\",\n then: \"Maintained by Agentschap Natuur en Bos\",\n hideInAnswer: \"_country!=be\"\n}",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": [
@@ -52,15 +58,13 @@
]
},
"ifnot": {
- "description": "Only applicable if 'multiAnswer' is set.\nThis is for situations such as:\n`accepts:coins=no` where one can select all the possible payment methods. However, we want to make explicit that some options _were not_ selected.\nThis can be done with `ifnot`\nNote that we can not explicitly render this negative case to the user, we cannot show `does _not_ accept coins`.\nIf this is important to your usecase, consider using multiple radiobutton-fields without `multiAnswer`",
+ "description": "question: What tags should be applied if this mapping is _not_ chosen?\n\nOnly applicable if 'multiAnswer' is set.\nThis is for situations such as:\n`accepts:coins=no` where one can select all the possible payment methods. However, we want to make explicit that some options _were not_ selected.\nThis can be done with `ifnot`\nNote that we can not explicitly render this negative case to the user, we cannot show `does _not_ accept coins`.\nIf this is important to your usecase, consider using multiple radiobutton-fields without `multiAnswer`",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -68,26 +72,24 @@
]
},
"addExtraTags": {
- "description": "If chosen as answer, these tags will be applied as well onto the object.\nNot compatible with multiAnswer.\n\nThis can be used e.g. to erase other keys which indicate the 'not' value:\n```json\n{\n \"if\": \"crossing:marking=rainbow\",\n \"then\": \"This is a rainbow crossing\",\n \"addExtraTags\": \"not:crossing:marking=\"\n}\n```",
+ "description": "question: What extra tags should be added to the object if this object is chosen?\ntype: simple_tag[]\n\nIf chosen as answer, these tags will be applied onto the object, together with the tags from the `if`\nNot compatible with multiAnswer.\n\nThis can be used e.g. to erase other keys which indicate the 'not' value:\n```json\n{\n \"if\": \"crossing:marking=rainbow\",\n \"then\": \"This is a rainbow crossing\",\n \"addExtraTags\": [\"not:crossing:marking=\"]\n}\n```",
"type": "array",
"items": {
"type": "string"
}
},
"searchTerms": {
- "description": "If there are many options, the mappings-radiobuttons will be replaced by an element with a searchfunction\n\nSearchterms (per language) allow to easily find an option if there are many options",
+ "description": "question: If there are many options, what search terms match too?\nIf there are many options, the mappings-radiobuttons will be replaced by an element with a searchfunction\n\nSearchterms (per language) allow to easily find an option if there are many options\ngroup: hidden",
"$ref": "#/definitions/Record"
},
"priorityIf": {
- "description": "If the searchable selector is picked, mappings with this item will have priority and show up even if the others are hidden\nUse this sparingly",
+ "description": "If the searchable selector is picked, mappings with this item will have priority and show up even if the others are hidden\nUse this sparingly\ngroup: hidden",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -95,7 +97,7 @@
]
},
"#": {
- "description": "Used for comments or to disable a validation\n\nignore-image-in-then: normally, a `then`-clause is not allowed to have an `img`-html-element as icons are preferred. In some cases (most notably title-icons), this is allowed",
+ "description": "Used for comments or to disable a validation\n\ngroup: hidden\nignore-image-in-then: normally, a `then`-clause is not allowed to have an `img`-html-element as icons are preferred. In some cases (most notably title-icons), this is allowed",
"type": "string"
}
},
@@ -105,13 +107,12 @@
],
"definitions": {
"TagConfigJson": {
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation",
+ "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation\n\ntype: tag",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
"type": "object",
"properties": {
"or": {
@@ -130,8 +131,7 @@
}
]
},
- "AndTagConfigJson": {
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{and:TagConfigJson[];}": {
"type": "object",
"properties": {
"and": {
@@ -146,8 +146,7 @@
],
"additionalProperties": false
},
- "OrTagConfigJson": {
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation",
+ "{or:TagConfigJson[];}": {
"type": "object",
"properties": {
"or": {
@@ -234,48 +233,101 @@
],
"additionalProperties": false
},
+ "MinimalTagRenderingConfigJson": {
+ "description": "Mostly used for lineRendering and pointRendering",
+ "type": "object",
+ "properties": {
+ "render": {
+ "description": "question: What value should be rendered?\n\nThis piece of text will be shown in the infobox.\nNote that \"&LBRACEkey&RBRACE\"-parts are substituted by the corresponding values of the element.\n\nThis value will be used if there is no mapping which matches (or there are no matches)\nNote that this is a HTML-interpreted value, so you can add links as e.g. '<a href='{website}'>{website}</a>' or include images such as `This is of type A <br><img src='typeA-icon.svg' />`",
+ "type": "string"
+ },
+ "mappings": {
+ "description": "Allows fixed-tag inputs, shown either as radiobuttons or as checkboxes",
+ "type": "array",
+ "items": {
+ "type": "object",
+ "properties": {
+ "if": {
+ "$ref": "#/definitions/TagConfigJson",
+ "description": "question: When should this single mapping match?\n\nIf this condition is met, then the text under `then` will be shown.\nIf no value matches, and the user selects this mapping as an option, then these tags will be uploaded to OSM.\n\nFor example: {'if': 'diet:vegetarion=yes', 'then':'A vegetarian option is offered here'}\n\nThis can be an substituting-tag as well, e.g. {'if': 'addr:street:={_calculated_nearby_streetname}', 'then': '{_calculated_nearby_streetname}'}"
+ },
+ "then": {
+ "description": "question: What text should be shown?\n\nIf the condition `if` is met, the text `then` will be rendered.\nIf not known yet, the user will be presented with `then` as an option",
+ "type": "string"
+ }
+ },
+ "required": [
+ "if",
+ "then"
+ ]
+ }
+ }
+ },
+ "additionalProperties": false
+ },
+ "IconConfigJson": {
+ "type": "object",
+ "properties": {
+ "icon": {
+ "description": "question: What icon should be used?\ntype: icon\nsuggestions: return [\"pin\",\"square\",\"circle\",\"checkmark\",\"clock\",\"close\",\"crosshair\",\"help\",\"home\",\"invalid\",\"location\",\"location_empty\",\"location_locked\",\"note\",\"resolved\",\"ring\",\"scissors\",\"teardrop\",\"teardrop_with_hole_green\",\"triangle\"].map(i => ({if: \"value=\"+i, then: i, icon: i}))",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
+ },
+ {
+ "type": "object",
+ "properties": {
+ "builtin": {
+ "type": "string"
+ },
+ "override": {}
+ },
+ "required": [
+ "builtin",
+ "override"
+ ]
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "color": {
+ "description": "question: What colour should the icon be?\nThis will only work for the default icons such as `pin`,`circle`,...\ntype: color",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/MinimalTagRenderingConfigJson"
+ },
+ {
+ "type": "object",
+ "properties": {
+ "builtin": {
+ "type": "string"
+ },
+ "override": {}
+ },
+ "required": [
+ "builtin",
+ "override"
+ ]
+ },
+ {
+ "type": "string"
+ }
+ ]
+ }
+ },
+ "required": [
+ "icon"
+ ],
+ "additionalProperties": false
+ },
"TagRenderingConfigJson": {
"description": "A TagRenderingConfigJson is a single piece of code which converts one ore more tags into a HTML-snippet.\nFor an _editable_ tagRendering, use 'QuestionableTagRenderingConfigJson' instead, which extends this one",
"type": "object",
"properties": {
- "id": {
- "description": "The id of the tagrendering, should be an unique string.\nUsed to keep the translations in sync. Only used in the tagRenderings-array of a layerConfig, not requered otherwise.\n\nUse 'questions' to trigger the question box of this group (if a group is defined)",
- "type": "string"
- },
- "labels": {
- "description": "A list of labels. These are strings that are used for various purposes, e.g. to filter them away",
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- "classes": {
- "description": "A list of css-classes to apply to the entire tagRendering if the answer is known (not applied on the question).\nThis is only for advanced users",
- "anyOf": [
- {
- "type": "array",
- "items": {
- "type": "string"
- }
- },
- {
- "type": "string"
- }
- ]
- },
- "description": {
- "description": "A human-readable text explaining what this tagRendering does",
- "anyOf": [
- {
- "$ref": "#/definitions/Record"
- },
- {
- "type": "string"
- }
- ]
- },
"render": {
- "description": "Renders this value. Note that \"{key}\"-parts are substituted by the corresponding values of the element.\nIf neither 'textFieldQuestion' nor 'mappings' are defined, this text is simply shown as default value.\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '{website}' or include images such as `This is of type A
`\ntype: rendered",
+ "description": "question: What text should be rendered?\n\nThis piece of text will be shown in the infobox.\nIn this text, values within braces (such as {braced(key)}) are replaced by the corresponding `value` in the object.\nFor example, if the object contains tags `amenity=school; name=Windy Hill School`, the render string `This school is named {name}` will be shown to the user as `This school is named Windy Hill School`\n\nThis text will be shown if:\n- there is no mapping which matches (or there are no matches)\n- no question, no mappings and no 'freeform' is set\n\nNote that this is a HTML-interpreted value, so you can add links as e.g. '<a href='{website}'>{website}</a>' or include images such as `This is of type A <br><img src='typeA-icon.svg' />`\ntype: rendered",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -311,16 +363,38 @@
}
]
},
- "condition": {
- "description": "Only show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "icon": {
+ "description": "question: what icon should be shown next to the 'render' value?\nAn icon shown next to the rendering; typically shown pretty small\nThis is only shown next to the \"render\" value\nType: icon",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "object",
+ "properties": {
+ "path": {
+ "description": "The path to the icon\nType: icon",
+ "type": "string"
+ },
+ "class": {
+ "description": "A hint to mapcomplete on how to render this icon within the mapping.\nThis is translated to 'mapping-icon-', so defining your own in combination with a custom CSS is possible (but discouraged)",
+ "type": "string"
+ }
+ },
+ "required": [
+ "path"
+ ]
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "type": "string"
+ }
+ ]
+ },
+ "condition": {
+ "description": "question: When should this item be shown?\n\nOnly show this tagrendering (or ask the question) if the selected object also matches the tags specified as `condition`.\n\nThis is useful to ask a follow-up question.\nFor example, within toilets, asking _where_ the diaper changing table is is only useful _if_ there is one.\nThis can be done by adding `\"condition\": \"changing_table=yes\"`\n\nA full example would be:\n```json\n {\n \"question\": \"Where is the changing table located?\",\n \"render\": \"The changing table is located at {changing_table:location}\",\n \"condition\": \"changing_table=yes\",\n \"freeform\": {\n \"key\": \"changing_table:location\",\n \"inline\": true\n },\n \"mappings\": [\n {\n \"then\": \"The changing table is in the toilet for women.\",\n \"if\": \"changing_table:location=female_toilet\"\n },\n {\n \"then\": \"The changing table is in the toilet for men.\",\n \"if\": \"changing_table:location=male_toilet\"\n },\n {\n \"if\": \"changing_table:location=wheelchair_toilet\",\n \"then\": \"The changing table is in the toilet for wheelchair users.\",\n },\n {\n \"if\": \"changing_table:location=dedicated_room\",\n \"then\": \"The changing table is in a dedicated room. \",\n }\n ],\n \"id\": \"toilet-changing_table:location\"\n },\n```",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
+ },
+ {
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -328,15 +402,13 @@
]
},
"metacondition": {
- "description": "If set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
+ "description": "question: When should this item be shown (including special conditions)?\n\nIf set, this tag will be evaluated agains the _usersettings/application state_ table.\nEnable 'show debug info' in user settings to see available options.\nNote that values with an underscore depicts _application state_ (including metainfo about the user) whereas values without an underscore depict _user settings_",
"anyOf": [
{
- "$ref": "#/definitions/AndTagConfigJson",
- "description": "Chain many tags, to match, a single of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{and:TagConfigJson[];}"
},
{
- "$ref": "#/definitions/OrTagConfigJson",
- "description": "Chain many tags, to match, all of these should be true\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for documentation"
+ "$ref": "#/definitions/{or:TagConfigJson[];}"
},
{
"type": "string"
@@ -344,11 +416,11 @@
]
},
"freeform": {
- "description": "Allow freeform text input from the user",
+ "description": "question: Should a freeform text field be shown?\nAllow freeform text input from the user\nifunset: Do not add a freeform text field",
"type": "object",
"properties": {
"key": {
- "description": "If this key is present, then 'render' is used to display the value.\nIf this is undefined, the rendering is _always_ shown",
+ "description": "What attribute should be filled out\nIf this key is present in the feature, then 'render' is used to display the value.\nIf this is undefined, the rendering is _always_ shown",
"type": "string"
}
},
@@ -364,10 +436,10 @@
"properties": {
"if": {
"$ref": "#/definitions/TagConfigJson",
- "description": "If this condition is met, then the text under `then` will be shown.\nIf no value matches, and the user selects this mapping as an option, then these tags will be uploaded to OSM.\n\nFor example: {'if': 'diet:vegetarion=yes', 'then':'A vegetarian option is offered here'}\n\nThis can be an substituting-tag as well, e.g. {'if': 'addr:street:={_calculated_nearby_streetname}', 'then': '{_calculated_nearby_streetname}'}"
+ "description": "question: When should this single mapping match?\n\nIf this condition is met, then the text under `then` will be shown.\nIf no value matches, and the user selects this mapping as an option, then these tags will be uploaded to OSM.\n\nFor example: {'if': 'diet:vegetarion=yes', 'then':'A vegetarian option is offered here'}\n\nThis can be an substituting-tag as well, e.g. {'if': 'addr:street:={_calculated_nearby_streetname}', 'then': '{_calculated_nearby_streetname}'}"
},
"then": {
- "description": "If the condition `if` is met, the text `then` will be rendered.\nIf not known yet, the user will be presented with `then` as an option\nType: rendered",
+ "description": "question: What text should be shown?\n\nIf the condition `if` is met, the text `then` will be rendered.\nIf not known yet, the user will be presented with `then` as an option\nType: rendered",
"anyOf": [
{
"$ref": "#/definitions/Record"
@@ -378,7 +450,7 @@
]
},
"icon": {
- "description": "An icon supporting this mapping; typically shown pretty small\nType: icon",
+ "description": "question: What icon should be added to this mapping?\nAn icon supporting this mapping; typically shown pretty small\ninline:
{icon}\nType: icon",
"anyOf": [
{
"type": "object",
@@ -407,6 +479,21 @@
"then"
]
}
+ },
+ "description": {
+ "description": "A human-readable text explaining what this tagRendering does.\nMostly used for the shared tagrenderings",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record"
+ },
+ {
+ "type": "string"
+ }
+ ]
+ },
+ "classes": {
+ "description": "question: What css-classes should be applied to showing this attribute?\n\nA list of css-classes to apply to the entire tagRendering.\nThese classes are applied in 'answer'-mode, not in question mode\nThis is only for advanced users.\n\nValues are split on ` ` (space)",
+ "type": "string"
}
},
"additionalProperties": false
diff --git a/Docs/Schemas/MappingConfigJsonJSC.ts b/Docs/Schemas/MappingConfigJsonJSC.ts
index b53c9837b4..7868f6b8a5 100644
--- a/Docs/Schemas/MappingConfigJsonJSC.ts
+++ b/Docs/Schemas/MappingConfigJsonJSC.ts
@@ -3,13 +3,21 @@ export default {
"properties": {
"if": {
"$ref": "#/definitions/TagConfigJson",
- "description": "The main representation of Tags.\nSee https://github.com/pietervdvn/MapComplete/blob/develop/Docs/Tags_format.md for more documentation"
+ "description": "question: What tags should be matched to show this option?\n\nIf in 'question'-mode and the contributor selects this option, these tags will be applied to the object"
},
"then": {
- "description": "Shown if the 'if is fulfilled\nType: rendered"
+ "description": "Question: What corresponding text should be shown?\nShown if the `if` is fulfilled\nType: rendered",
+ "anyOf": [
+ {
+ "$ref": "#/definitions/Record