MapComplete/Docs/BuiltinLayers.md

Special and other useful layers

Table of contents

1. Special and other useful layers
2. Priviliged layers
3. selected_element

• Basic tags for this layer
• Supported attributes

1. gps_location

• Basic tags for this layer
• Supported attributes

1. gps_location_history

• Basic tags for this layer
• Supported attributes

1. home_location

• Basic tags for this layer
• Supported attributes

1. gps_track

• Basic tags for this layer
• Supported attributes
  • just_created
  • Privacy notice
  • export_as_gpx
  • export_as_geojson
  • upload_to_osm
  • minimap
  • delete
  • leftover-questions
  • all-tags

1. range

• Basic tags for this layer
• Supported attributes

1. last_click

• Basic tags for this layer
• Supported attributes
  • just_created
  • add_new
  • add_note
  • leftover-questions
  • all-tags
    • Filters

1. conflation

• Basic tags for this layer
• Supported attributes

1. split_point

• Basic tags for this layer
• Supported attributes

1. split_road

• Basic tags for this layer
• Supported attributes

1. current_view
   • Themes using this layer

• Basic tags for this layer
• Supported attributes
  • just_created
  • leftover-questions
  • all-tags

1. import_candidate

• Basic tags for this layer
• Supported attributes
  • just_created
  • all_tags
  • leftover-questions

1. usersettings

• Basic tags for this layer
• Supported attributes
  • just_created
  • profile
  • language_picker
  • inbox
  • settings-link
  • logout
  • background-layer-readonly
  • background-layer
  • picture-license
  • show_tags
  • all-questions-at-once
  • fixate-north
  • mangrove-keys
  • translations-title
  • translation-mode
  • translation-help
  • translation-completeness
  • translation-links
  • verified-mastodon
  • cscount-thanks
  • translation-thanks
  • contributor-thanks
  • show_debug
  • debug
  • leftover-questions

1. Normal layers

MapComplete has a few data layers available in the theme which have special properties through builtin-hooks. Furthermore, there are some normal layers (which are built from normal Theme-config files) but are so general that they get a mention here.

Priviliged layers

• selected_element
• gps_location
• gps_location_history
• home_location
• gps_track
• range
• last_click
• conflation
• split_point
• split_road
• current_view
• import_candidate
• usersettings

selected_element

Highlights the currently selected element. Override this layer to have different colors

• This layer is shown at zoomlevel 0 and higher
• This layer is included automatically in every theme. This layer might contain no points
• 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

Basic tags for this layer

Elements must have the all of following tags to be shown on this layer:

Supported attributes

gps_location

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 (except latitude and longitude) returned by the browser, such as speed, altitude, heading, ....

• This layer is shown at zoomlevel 0 and higher
• This layer is included automatically in every theme. This layer might contain no points
• 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

Basic tags for this layer

Elements must have the all of following tags to be shown on this layer:

Supported attributes

gps_location_history

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

• This layer is shown at zoomlevel 1 and higher
• This layer is included automatically in every theme. This layer might contain no points
• This layer is not visible by default and must be enabled in the filter by the user.
• 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.
• This layer is not visible by default and the visibility cannot be toggled, effectively resulting in a fully hidden layer. This can be useful, e.g. to calculate some metatags. If you want to render this layer (e.g. for debugging), enable it by setting the URL-parameter layer-=true
• Not visible in the layer selection by default. If you want to make this layer toggable, override name

Basic tags for this layer

Elements must have the all of following tags to be shown on this layer:

Supported attributes

home_location

Meta layer showing the home location of the user. The home location can be set in the profile settings of OpenStreetMap.

• This layer is shown at zoomlevel 0 and higher
• This layer is included automatically in every theme. This layer might contain no points
• 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

Basic tags for this layer

Elements must have the all of following tags to be shown on this layer:

Supported attributes

gps_track

Meta layer showing the previous locations of the user as single line with controls, e.g. to erase, upload or download this track. Add this to your theme and override the maprendering to change the appearance of the travelled track.

• This layer is shown at zoomlevel 0 and higher
• This layer is included automatically in every theme. This layer might contain no points
• This layer is not visible by default and must be enabled in the filter by the user.
• Not rendered on the map by default. If you want to rendering this on the map, override mapRenderings

Basic tags for this layer

Elements must have the all of following tags to be shown on this layer:

Supported attributes

Warning:

this quick overview is incomplete

attribute	type	values which are supported by this layer
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

Privacy notice

This tagrendering has no question and is thus read-only

export_as_gpx

Shows a button to export this feature as GPX. Especially useful for route relations

This tagrendering has no question and is thus read-only

export_as_geojson

Shows a button to export this feature as geojson. Especially useful for debugging or using this in other programs

This tagrendering has no question and is thus read-only

upload_to_osm

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

delete

This tagrendering has no question and is thus read-only

leftover-questions

This tagrendering has no question and is thus read-only

all-tags

This tagrendering has no question and is thus read-only

range

Meta-layer, simply showing a bbox in red

• This layer is shown at zoomlevel 0 and higher
• This layer is included automatically in every theme. This layer might contain no points
• This layer is not visible by default and must be enabled in the filter by the user.
• 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.
• This layer is not visible by default and the visibility cannot be toggled, effectively resulting in a fully hidden layer. This can be useful, e.g. to calculate some metatags. If you want to render this layer (e.g. for debugging), enable it by setting the URL-parameter layer-=true
• 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

Basic tags for this layer

Elements must have the all of following tags to be shown on this layer:

Supported attributes

last_click

<img src='https://mapcomplete.org/

{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

• This layer is shown at zoomlevel 0 and higher
• This layer is included automatically in every theme. This layer might contain no points
• Not visible in the layer selection by default. If you want to make this layer toggable, override name

Basic tags for this layer

Elements must have the all of following tags to be shown on this layer:

Supported attributes

Warning:

this quick overview is incomplete

attribute	type	values which are supported by this layer
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

add_new

This tagrendering has no question and is thus read-only

This tagrendering is only visible in the popup if the following condition is met: has_presets=yes

add_note

This tagrendering has no question and is thus read-only

This tagrendering is only visible in the popup if the following condition is met: has_note_layer=yes

leftover-questions

This tagrendering has no question and is thus read-only

all-tags

This tagrendering has no question and is thus read-only

Filters

id	question	osmTags
action.0	only_if_action_is_possible	has_note_layer=yes|has_presets=yes

conflation

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.

• This layer is shown at zoomlevel 1 and higher
• This layer can not be included in a theme. It is solely used by special renderings showing a minimap with custom data.

Basic tags for this layer

Elements must have the all of following tags to be shown on this layer:

Supported attributes

split_point

Layer rendering the little scissors for the minimap in the 'splitRoadWizard'

• This layer is shown at zoomlevel 1 and higher
• This layer can not be included in a theme. It is solely used by special renderings showing a minimap with custom data.

Basic tags for this layer

Elements must have the all of following tags to be shown on this layer:

Supported attributes

split_road

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

• This layer is shown at zoomlevel 1 and higher
• This layer can not be included in a theme. It is solely used by special renderings showing a minimap with custom data.

Basic tags for this layer

Elements must have the all of following tags to be shown on this layer:

Supported attributes

current_view

A meta-layer which contains one single feature, namely the bounding box of the current map view. This can be used to trigger special actions. If a popup is defined for this layer, this popup will be accessible via an extra button on screen.

The icon on the button is the default icon of the layer, but can be customized by detecting 'button=yes'.

• This layer is shown at zoomlevel 0 and higher
• This layer can not be included in a theme. It is solely used by special renderings showing a minimap with custom data.

Themes using this layer

• grb
• mapcomplete-changes
• onwheels
• personal

Basic tags for this layer

Elements must have the all of following tags to be shown on this layer:

Supported attributes

Warning:

this quick overview is incomplete

attribute	type	values which are supported by this layer
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

leftover-questions

This tagrendering has no question and is thus read-only

all-tags

This tagrendering has no question and is thus read-only

import_candidate

Layer used as template in the importHelper

• This layer is shown at zoomlevel 0 and higher
• This layer can not be included in a theme. It is solely used by special renderings showing a minimap with custom data.

Basic tags for this layer

Elements must have the all of following tags to be shown on this layer:

Supported attributes

Warning:

this quick overview is incomplete

attribute	type	values which are supported by this layer
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

all_tags

This tagrendering has no question and is thus read-only

leftover-questions

This tagrendering has no question and is thus read-only

usersettings

A special layer which is not meant to be shown on a map, but which is used to set user settings

• This layer is shown at zoomlevel 0 and higher
• This layer can not be included in a theme. It is solely used by special renderings showing a minimap with custom data.

Basic tags for this layer

Elements must have the all of following tags to be shown on this layer:

Supported attributes

Warning:

this quick overview is incomplete

attribute	type	values which are supported by this layer
id	Multiple choice
__url_parameter_initialized:language	Multiple choice	yes
mapcomplete-preferred-background-layer	Multiple choice	osm photo map
mapcomplete-pictures-license	Multiple choice	CC0 [CC-BY 4.0](https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-pictures-license%3DCC-BY 4.0) [CC-BY-SA 4.0](https://wiki.openstreetmap.org/wiki/Tag:mapcomplete-pictures-license%3DCC-BY-SA 4.0)
mapcomplete-show_tags	Multiple choice	no yes full
mapcomplete-show-all-questions	Multiple choice	true false
mapcomplete-fixate-north	Multiple choice	yes
mapcomplete-translation-mode	Multiple choice	false true mobile
mapcomplete-translation-mode	Multiple choice	yes
_translation_percentage	Multiple choice	100
mapcomplete-show_debug	Multiple choice	yes no

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

profile

This tagrendering has no question and is thus read-only

language_picker

This tagrendering has no question and is thus read-only

• The language was set via an URL-parameter and cannot be set by the user.² corresponds with __url_parameter_initialized:language=yes

inbox

This tagrendering has no question and is thus read-only

• {link(Open your inbox,&LBRACE_backend&RBRACE/messages/inbox,,)} corresponds with _unreadMessages=0
• {link(You have &LBRACE_unreadMessages&RBRACE
  Open your inbox,&LBRACE_backend&RBRACE/messages/inbox,,)} corresponds with _unreadMessages>0

settings-link

This tagrendering has no question and is thus read-only

logout

This tagrendering has no question and is thus read-only

background-layer-readonly

This tagrendering has no question and is thus read-only

This tagrendering is only visible in the popup if the following condition is met: _theme:backgroundLayer~.+&mapcomplete-preferred-background-layer~.+&_theme:backgroundLayer!=

background-layer

The question is What background layer should be shown by default?

• Use the default background layer corresponds with ``
• Use OpenStreetMap-carto as default layer corresponds with mapcomplete-preferred-background-layer=osm
• Use aerial imagery as default background corresponds with mapcomplete-preferred-background-layer=photo
• Use a non-openstreetmap based map as default background corresponds with mapcomplete-preferred-background-layer=map
• Use the current background layer ({__current_background}) as default background corresponds with mapcomplete-preferred-background-layer=
• Use background layer {mapcomplete-preferred-background-layer} as default background corresponds with mapcomplete-preferred-background-layer~.+
• This option cannot be chosen as answer

picture-license

This question is not meant to be placed on an OpenStreetMap-element; however it is used in the user information panel to ask which license the user wants

The question is Under what license do you want to publish your pictures?

• Pictures you take will be licensed with CC0 and added to the public domain. This means that everyone can use your pictures for any purpose. This is the default choice. corresponds with ``
• This option cannot be chosen as answer
• Pictures you take will be licensed with CC0 and added to the public domain. This means that everyone can use your pictures for any purpose. corresponds with mapcomplete-pictures-license=CC0
• Pictures you take will be licensed with CC-BY 4.0 which requires everyone using your picture that they have to attribute you corresponds with mapcomplete-pictures-license=CC-BY 4.0
• Pictures you take will be licensed with CC-BY-SA 4.0 which means that everyone using your picture must attribute you and that derivatives of your picture must be reshared with the same license. corresponds with mapcomplete-pictures-license=CC-BY-SA 4.0

show_tags

The question is Show the raw OpenStreetMap-tags?

• Never show the tags. corresponds with mapcomplete-show_tags=no
• Show the tags that will be applied once I have made {__userjourney_tagsVisibleAt} changesets corresponds with ``
• Show the tags that will be applied when making a change corresponds with mapcomplete-show_tags=yes
• Show the tags that will be applied when making a change and show the tags table on every feature corresponds with mapcomplete-show_tags=full

all-questions-at-once

The question is Should questions for unknown data fields appear one-by-one or together?

• Show all questions in the infobox together corresponds with mapcomplete-show-all-questions=true
• Show questions one-by-one corresponds with mapcomplete-show-all-questions=false

fixate-north

The question is Should north always be up?

• Allow to rotate the map corresponds with ``
• Always keep north pointing up corresponds with mapcomplete-fixate-north=yes

mangrove-keys

This tagrendering has no question and is thus read-only

translations-title

This tagrendering has no question and is thus read-only

translation-mode

The question is Do you want to help translating MapComplete?

• Don't show a button to quickly change translations corresponds with mapcomplete-translation-mode=false
• Show a button to quickly open translations when using MapComplete on a big screen corresponds with mapcomplete-translation-mode=true
• Always show the translation buttons, including on mobile corresponds with mapcomplete-translation-mode=mobile

translation-help

This tagrendering has no question and is thus read-only

• Click the 'translate'-icon next to a string to enter or update a piece of text. You need a Weblate-account for this. Create one with your OSM-username to automatically unlock translation mode. corresponds with mapcomplete-translation-mode=yes|mapcomplete-translation-mode=true|mapcomplete-translation-mode=mobile

translation-completeness

This tagrendering has no question and is thus read-only

• Completely translated corresponds with _translation_percentage=100

This tagrendering is only visible in the popup if the following condition is met: mapcomplete-translation-mode=yes|mapcomplete-translation-mode=true|mapcomplete-translation-mode=mobile

translation-links

This tagrendering has no question and is thus read-only

This tagrendering is only visible in the popup if the following condition is met: _translation_links~.+&mapcomplete-translation-mode=true|mapcomplete-translation-mode=mobile

verified-mastodon

This tagrendering has no question and is thus read-only

• A link to your Mastodon-profile has been been found: {_mastodon_link} corresponds with _mastodon_link~.+
• We found a link to what looks to be a mastodon account, but it is unverified. Edit your profile description and place the following there: &lta href="{_mastodon_candidate}" rel="me"&gtMastodon&lt/a&gt corresponds with _mastodon_candidate~.+

cscount-thanks

This tagrendering has no question and is thus read-only

• You have made changes on {_csCount} different occasions! That is awesome! corresponds with _csCount>0

translation-thanks

This tagrendering has no question and is thus read-only

• You have contributed to translating MapComplete! That's awesome! corresponds with _translation_contributions>0

contributor-thanks

This tagrendering has no question and is thus read-only

• You have contributed code to MapComplete with {_code_contributions} commits! That's awesome! corresponds with _code_contributions>0
• This option cannot be chosen as answer

show_debug

The question is Show user settings debug info?

• Show debug info corresponds with mapcomplete-show_debug=yes
• Don't show debug info corresponds with mapcomplete-show_debug=no
• Don't show debug info corresponds with ``
• This option cannot be chosen as answer

debug

This tagrendering has no question and is thus read-only

This tagrendering is only visible in the popup if the following condition is met: mapcomplete-show_debug=yes

leftover-questions

This tagrendering has no question and is thus read-only

Normal layers

The following layers are included in MapComplete:

• address
• advertising
• ambulancestation
• artwork
• atm
• bank
• barrier
• bench
• bench_at_pt
• bicycle_library
• bicycle_rental
• bicycle_tube_vending_machine
• bike_cafe
• bike_cleaning
• bike_parking
• bike_repair_station
• bike_shop
• bike_themed_object
• binocular
• birdhide
• cafe_pub
• car_rental
• charging_station
• climbing
• climbing_area
• climbing_club
• climbing_gym
• climbing_opportunity
• climbing_route
• clock
• conflation
• crab_address
• crossings
• current_view
• cycleways_and_roads
• defibrillator
• dentist
• direction
• doctors
• dogpark
• drinking_water
• elevator
• elongated_coin
• entrance
• etymology
• extinguisher
• filters
• fire_station
• fitness_centre
• fitness_station
• fixme
• food
• ghost_bike
• governments
• gps_location
• gps_location_history
• gps_track
• guidepost
• hackerspace
• home_location
• hospital
• hotel
• hydrant
• icons
• id_presets
• import_candidate
• indoors
• information_board
• kerbs
• kindergarten_childcare
• last_click
• map
• maproulette
• maproulette_challenge
• maxspeed
• memorial
• named_streets
• nature_reserve
• note
• observation_tower
• osm_community_index
• parcel_lockers
• parking
• parking_spaces
• parking_ticket_machine
• pedestrian_path
• pharmacy
• physiotherapist
• picnic_table
• play_forest
• playground
• postboxes
• postoffices
• public_bookcase
• questions
• railway_platforms
• rainbow_crossings
• range
• reception_desk
• recycling
• school
• selected_element
• shelter
• shops
• shower
• slow_roads
• speed_camera
• speed_display
• split_point
• split_road
• sport_pitch
• sports_centre
• stairs
• street_lamps
• surveillance_camera
• tertiary_education
• ticket_machine
• ticket_validator
• toilet
• toilet_at_amenity
• trail
• transit_routes
• transit_stops
• tree_node
• usersettings
• vending_machine
• veterinary
• viewpoint
• village_green
• visitor_information_centre
• walls_and_buildings
• waste_basket
• waste_disposal
• windturbine

This document is autogenerated from src/Customizations/AllKnownLayouts.ts