mapcomplete/Docs/BuiltinLayers.md
2022-01-14 03:14:56 +01:00

29 KiB

Special and other useful layers

Table of contents

  1. Special and other useful layers
  2. Priviliged layers
  3. 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

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.

Go to the source code

  • 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

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

Go to the source code

  • 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

home_location

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

Go to the source code

  • 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

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.

Go to the source code

  • 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

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.

Go to the source code

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

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)

Go to the source code

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.

Go to the source code

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

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

Go to the source code

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

split_point

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

Go to the source code

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

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'.

Go to the source code

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

matchpoint

The default rendering for a locationInput which snaps onto another object

Go to the source code

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

Normal layers

The following layers are included in MapComplete

Frequently reused layers

The following layers are used by at least 2 mapcomplete themes and might be interesting for your custom theme too

bicycle_library

A facility where bicycles can be lent for longer period of times

Go to the source code

Themes using this layer

drinking_water

A layer showing drinking water fountains

Go to the source code

  • This layer will automatically load drinking_water 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

Themes using this layer

food

A layer showing restaurants and fast-food amenities (with a special rendering for friteries)

Go to the source code

Themes using this layer

map

A map, meant for tourists which is permanently installed in the public space

Go to the source code

Themes using this layer

walls_and_buildings

Special builtin layer providing all walls and buildings. This layer is useful in presets for objects which can be placed against walls (e.g. AEDs, postboxes, entrances, addresses, surveillance cameras, ...). This layer is invisible by default and not toggleable by the user.

Go to the source code

  • This layer is not visible by default and must be enabled in the filter by the user.
  • 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 layer is needed as dependency for layer defibrillator
  • This layer is needed as dependency for layer entrance
  • This layer is needed as dependency for layer surveillance_camera

Themes using this layer

ambulancestation

An ambulance station is an area for storage of ambulance vehicles, medical equipment, personal protective equipment, and other medical supplies.

Go to the source code

Themes using this layer

artwork

Diverse pieces of artwork

Go to the source code

Themes using this layer

barrier

Obstacles while cycling, such as bollards and cycle barriers

Go to the source code

  • This layer will automatically load cycleways_and_roads into the layout as it depends on it: a preset snaps to this layer (presets[0])
  • This layer will automatically load cycleways_and_roads into the layout as it depends on it: a preset snaps to this layer (presets[1])

Themes using this layer

bench

A bench is a wooden, metal, stone, ... surface where a human can sit. This layers visualises them and asks a few questions about them.

Go to the source code

Themes using this layer

bench_at_pt

A layer showing all public-transport-stops which do have a bench

Go to the source code

Themes using this layer

bicycle_tube_vending_machine

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, ...)

Go to the source code

Themes using this layer

bike_cafe

A bike café is a café geared towards cyclists, for example with services such as a pump, with lots of bicycle-related decoration, ...

Go to the source code

Themes using this layer

bike_cleaning

A layer showing facilities where one can clean their bike

Go to the source code

Themes using this layer

bike_parking

A layer showing where you can park your bike

Go to the source code

Themes using this layer

bike_repair_station

A layer showing bicycle pumps and bicycle repair tool stands

Go to the source code

Themes using this layer

bike_shop

A shop specifically selling bicycles or related items

Go to the source code

Themes using this layer

bike_themed_object

A layer with bike-themed objects but who don't match any other layer

Go to the source code

Themes using this layer

binocular

Binoculas

Go to the source code

Themes using this layer

birdhide

Een vogelkijkhut

Go to the source code

Themes using this layer

cafe_pub

A layer showing cafés and pubs where one can gather around a drink. The layer asks for some relevant questions

Go to the source code

Themes using this layer

charging_station

A charging station

Go to the source code

Themes using this layer

crossings

Crossings for pedestrians and cyclists

Go to the source code

  • This layer will automatically load cycleways_and_roads into the layout as it depends on it: a preset snaps to this layer (presets[0])
  • This layer will automatically load cycleways_and_roads into the layout as it depends on it: a preset snaps to this layer (presets[1])

Themes using this layer

cycleways_and_roads

All infrastructure that someone can cycle over, accompanied with questions about this infrastructure"

Go to the source code

  • This layer is needed as dependency for layer barrier
  • This layer is needed as dependency for layer barrier
  • This layer is needed as dependency for layer crossings
  • This layer is needed as dependency for layer crossings

Themes using this layer

defibrillator

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

Go to the source code

  • This layer will automatically load walls_and_buildings into the layout as it depends on it: a preset snaps to this layer (presets[1])

Themes using this layer

direction

This layer visualizes directions

Go to the source code

  • This layer cannot be toggled in the filter view. If you import this layer in your theme, override title to make this toggleable.

Themes using this layer

entrance

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, ...)

Go to the source code

  • This layer will automatically load walls_and_buildings into the layout as it depends on it: a preset snaps to this layer (presets[0])
  • This layer will automatically load pedestrian_path into the layout as it depends on it: a preset snaps to this layer (presets[0])

Themes using this layer

etymology

All objects which have an etymology known

Go to the source code

Themes using this layer

extinguisher

Map layer to show fire hydrants.

Go to the source code

Themes using this layer

fire_station

Map layer to show fire stations.

Go to the source code

Themes using this layer

ghost_bike

A layer showing memorials for cyclists, killed in road accidents

Go to the source code

Themes using this layer

hydrant

Map layer to show fire hydrants.

Go to the source code

Themes using this layer

information_board

A layer showing touristical, road side information boards (e.g. giving information about the landscape, a building, a feature, a map, ...)

Go to the source code

Themes using this layer

nature_reserve

Een natuurgebied is een gebied waar actief ruimte gemaakt word voor de natuur. Typisch zijn deze in beheer van Natuurpunt of het Agentschap Natuur en Bos of zijn deze erkend door de overheid.

Go to the source code

Themes using this layer

note_import

Template for note note imports.

Go to the source code

  • This layer will automatically load public_bookcase into the layout as it depends on it: a tagrendering needs this layer (import)

Themes using this layer

observation_tower

Towers with a panoramic view

Go to the source code

Themes using this layer

parking

A layer showing car parkings

Go to the source code

Themes using this layer

pedestrian_path

Pedestrian footpaths, especially used for indoor navigation and snapping entrances to this layer

Go to the source code

  • This layer is needed as dependency for layer entrance

Themes using this layer

picnic_table

The layer showing picnic tables

Go to the source code

Themes using this layer

playground

Playgrounds

Go to the source code

Themes using this layer

public_bookcase

A streetside cabinet with books, accessible to anyone

Go to the source code

  • This layer is needed as dependency for layer note_import

Themes using this layer

shops

A shop

Go to the source code

Themes using this layer

sport_pitch

A sport pitch

Go to the source code

Themes using this layer

street_lamps

A layer showing street lights

Go to the source code

Themes using this layer

surveillance_camera

This layer shows surveillance cameras and allows a contributor to update information and add new cameras

Go to the source code

  • This layer will automatically load walls_and_buildings into the layout as it depends on it: a preset snaps to this layer (presets[1])

Themes using this layer

toilet

A layer showing (public) toilets

Go to the source code

Themes using this layer

tree_node

A layer showing trees

Go to the source code

Themes using this layer

waste_basket

This is a public waste basket, thrash can, where you can throw away your thrash.

Go to the source code

Themes using this layer

This document is autogenerated from AllKnownLayers.ts