mapcomplete/Docs/BuiltinLayers.md

Special and other useful layers

Table of contents

1. Special and other useful layers
2. Priviliged layers
3. 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
  • Privacy notice
  • export_as_gpx
  • minimap
  • delete

1. type_node

• Basic tags for this layer
• Supported attributes

1. note

• Basic tags for this layer
• Supported attributes
  • conversation
  • add_image
  • comment
  • report-contributor
  • report-note

1. import_candidate

• Basic tags for this layer
• Supported attributes
  • all_tags

1. conflation

• Basic tags for this layer
• Supported attributes

1. left_right_style

• Basic tags for this layer
• Supported attributes

1. split_point

• Basic tags for this layer
• Supported attributes

1. current_view

• Basic tags for this layer
• Supported attributes

1. matchpoint

• Basic tags for this layer
• Supported attributes

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

• gps_location
• gps_location_history
• home_location
• gps_track
• type_node
• note
• import_candidate
• conflation
• left_right_style
• split_point
• current_view
• matchpoint

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 returned by the browser.

• This layer is included automatically in every theme. This layer might contain no points
• This layer cannot be toggled in the filter view. 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

Go to the source code

Basic tags for this layer

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

• id=gps

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 included automatically in every theme. This layer might contain no points
• This layer cannot be toggled in the filter view. 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

Go to the source code

Basic tags for this layer

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

• user:location=yes

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 included automatically in every theme. This layer might contain no points
• This layer cannot be toggled in the filter view. 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

Go to the source code

Basic tags for this layer

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

• user:home=yes

Supported attributes

gps_track

Meta layer showing the previous locations of the user as single line. Add this to your theme and override the icon to change the appearance of the current location.

• 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

Go to the source code

Basic tags for this layer

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

• id=location_track

Supported attributes

Privacy notice

This tagrendering has no question and is thus read-only

export_as_gpx

This tagrendering has no question and is thus read-only

minimap

This tagrendering has no question and is thus read-only

delete

This tagrendering has no question and is thus read-only

type_node

This is a priviliged meta_layer which exports every point in OSM. This only works if zoomed below the point that the full tile is loaded (and not loaded via Overpass). Note that this point will also contain a property parent_ways which contains all the ways this node is part of as a list. This is mainly used for extremely specialized themes, which do advanced conflations. Expert use only.

• Not rendered on the map by default. If you want to rendering this on the map, override mapRenderings

Go to the source code

Basic tags for this layer

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

• id~^node/.*$

Supported attributes

note

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)

• This layer is loaded from an external source, namely https://api.openstreetmap.org/api/0.6/notes.json?limit=10000&closed=7&bbox={x_min},{y_min},{x_max},{y_max}

Go to the source code

Basic tags for this layer

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

• id~^..*$

Supported attributes

conversation

This tagrendering has no question and is thus read-only

add_image

This tagrendering has no question and is thus read-only

comment

This tagrendering has no question and is thus read-only

report-contributor

This tagrendering has no question and is thus read-only

report-note

This tagrendering has no question and is thus read-only

import_candidate

Layer used in the importHelper

• Not visible in the layer selection by default. If you want to make this layer toggable, override name

Go to the source code

Basic tags for this layer

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

Supported attributes

all_tags

This tagrendering has no question and is thus read-only

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 can not be included in a theme. It is solely used by special renderings showing a minimap with custom data.

Go to the source code

Basic tags for this layer

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

• move=yes|newpoint=yes

Supported attributes

left_right_style

Special meta-style which will show one single line, either on the left or on the right depending on the id. This is used in the small popups with left_right roads. Cannot be included in a theme

• This layer can not be included in a theme. It is solely used by special renderings showing a minimap with custom data.

Go to the source code

Basic tags for this layer

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

• id=left|id=right

Supported attributes

split_point

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

• This layer can not be included in a theme. It is solely used by special renderings showing a minimap with custom data.

Go to the source code

Basic tags for this layer

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

• _split_point=yes

Supported attributes

current_view

A meta-layer which contains one single feature, namely the BBOX 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 can not be included in a theme. It is solely used by special renderings showing a minimap with custom data.

Go to the source code

Basic tags for this layer

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

• current_view=yes

Supported attributes

matchpoint

The default rendering for a locationInput which snaps onto another object

• This layer can not be included in a theme. It is solely used by special renderings showing a minimap with custom data.

Go to the source code

Basic tags for this layer

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

Supported attributes

Normal layers

The following layers are included in MapComplete:

• address
• ambulancestation
• artwork
• 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
• charging_station
• cluster_style
• conflation
• crab_address
• crossings
• current_view
• cycleways_and_roads
• defibrillator
• direction
• drinking_water
• entrance
• etymology
• extinguisher
• fire_station
• food
• ghost_bike
• gps_location
• gps_location_history
• gps_track
• grass_in_parks
• home_location
• hydrant
• import_candidate
• information_board
• left_right_style
• map
• matchpoint
• named_streets
• nature_reserve
• note
• note_import
• observation_tower
• parking
• pedestrian_path
• picnic_table
• play_forest
• playground
• public_bookcase
• shops
• slow_roads
• split_point
• sport_pitch
• street_lamps
• surveillance_camera
• toilet
• trail
• tree_node
• type_node
• viewpoint
• village_green
• visitor_information_centre
• walls_and_buildings
• waste_basket
• watermill

This document is autogenerated from Customizations/AllKnownLayouts.ts