Vector Basemap Layers
Every feature in a map tile belongs to one layer as defined in the MVT vector tile specification.
Every feature may have any number of tags expressed as key-value pairs. Keys are always strings; values may be strings, integers or decimal numbers. In order to capture the full range of data in OpenStreetMap, feature tags in Protomaps are a schemaless system; some keys may only be present in a subset of features.
To aid cartographic design, certain special keys prefixed with
pmap: are included.
The organization of features with layers and tags is specific to Protomaps services; this means that map styles are not directly portable with other systems such as OpenMapTiles or Mapzen tiles. The organization of features as described here, independent of any particular implementation, download, or service, is published under a CC0 license.
name: tags are always included. Keys that begin with
name such as
name:es for multilingual names are also included.
This layer contains ▩ polygons of physical features like forests, wetlands and glaciers.
natural in wood, glacier, scrub, sand, wetland, bare_rock
landuse in forest, meadow
boundary in national_park,protected_area
This layer contains ▩ polygons of manmade features like parks, schools and farms as well as abstract residential areas.
highway = pedestrian AND area=yes
highway = footway AND area=yes
man_made = bridge AND area=yes
This layer contains ▩ polygons of lakes, oceans, wide rivers, and manmade bodies of water such as pools and reservoirs.
natural = water
landuse = reservoir
leisure = swimming_pool
This layer contains ▩ polygon features for manmade buildings.
This layer contains ⟋ lines of physical features such as embankments and waterway centerlines.
has waterway AND waterway not in riverbank, reservoir
natural in strait, cliff
pmap:kind IN waterway, natural
This layer contains ⟋ line features of manmade roads.
has highway AND highway not in construction, proposed
pmap:level in 1, 0, -1for bridges, ground level or tunnels
pmap:kind in highway, major_road, medium_road, minor_road, other
This layer contains ⟋ line features for railways, runways and other features used by non-private vehicles.
has railway AND railway not in abandoned,construction,platform,proposed
aerialway = cable_car
route = ferry
aeroway in runway, taxiway
pmap:kind in aeroway,railway,ferryway,aerialway,other
This layer contains ⟋ lines for human-defined administrative boundaries such as countries and states.
boundary=adminstrative AND natural!=coastline AND maritime!=yes
This layer contains • points for neighborhoods, cities, countries and neighborhoods, useful for labeling.
pmap:kind in neighbourhood,city,country,state
pmap:rank in 1,2
This layer contains • points for natural features such as mountain peaks or labels for seas.
place in sea, ocean
This layer contains • points for points of interests such as transit stations and amenities.