Skip to content

MFD_standard Vector Schema

The MapsForDevs vector tile schema. Layer names and key attributes are stable across releases. Based on OpenMapTiles with MapsForDevs additions (country-aware highway networks, expanded language coverage).

Layers

LayerGeometryMin ZMax ZDescription
waterpolygon017Oceans, large lakes
waterwayline417Rivers, streams, canals
landcoverpolygon017Forest, grass, sand, ice
landusepolygon417Residential, industrial, parks
mountain_peakpoint717Peaks with elevation
parkpolygon617National parks, protected areas
boundaryline017Country and admin boundaries
aerowayline, polygon1017Runways, taxiways, aprons
transportationline417Roads, railways, ferries, paths
transportation_nameline617Road labels with network, ref, name, name:*
buildingpolygon1317Building footprints with height, levels (z15+)
water_namepoint017Ocean / lake / river labels
placepoint017Continent → city → suburb names
place_labelpoint017Same as place, used by symbol layers
housenumberpoint1617Building numbers (z16+ only)
poipoint1217Points of interest
poi_labelpoint1217POI labels
aerodrome_labelpoint817Airport names

Key attributes

transportation

AttributeValuesMin Z
classmotorway, trunk, primary, secondary, tertiary, minor, service, path, track, rail, ferry4
subclassmotorway_link, path:footway, path:cycleway, …7
networkcountry-aware: us-interstate, de-bundesstrasse, gb-trunk, e-road, asian-highway, road (default)6
refshield text (e.g. M1, A4, I-95)6
oneway0 / 112
surfacepaved, unpaved15
toll0 / 114

transportation_name

AttributeValuesMin Z
namelocal namevaries by class
name:latinromanizedvaries
name:de, name:fr, …per-language (~80 codes)varies (major langs always, minor langs z>=10)
networkas transportation6
refshield text6

Min-zoom by class for labels:

  • motorway → z6
  • trunk → z7
  • primary → z9
  • secondary → z10
  • tertiary → z12
  • minor / track → z13
  • residential → z14

building

AttributeValuesMin Z
render_heightmeters, polygon-extrude usable15
render_min_heightmeters15
heightmeters (raw)15
levelsfloor count15

housenumber

AttributeValuesMin Z
housenumberstring16

poi / poi_label

AttributeValues
classrestaurant, cafe, hotel, shop, transport, attraction, …
subclassOSM amenity / shop / tourism value
rank1 (most important) → 5 (least). Rank > 4 only renders at z15+
name, name:latin, name:*as place

place

AttributeValues
classcontinent, country, state, city, town, village, suburb, neighbourhood, island, islet
rank1 (largest) → 6 (smallest)
iso_a2ISO 3166-1 alpha-2 country code (on class=country)
capital1 if national capital (on class=country)

water

AttributeValues
classocean, lake, river, pond, swimming_pool
intermittent0 / 1

boundary

AttributeValues
admin_level2 (country), 3-4 (state), 5-8 (sub-state)
disputed0 / 1
maritime0 / 1

Network values (country-aware)

ValueWhat
us-interstateI-shield
us-highwayUS highway shield
us-stateUS state highway
de-bundesautobahnGerman A-road
de-bundesstrasseGerman B-road
gb-motorwayUK motorway (M)
gb-trunkUK A-road
fr-autorouteFrench A-road
fr-route-nationaleFrench N-road
e-roadEuropean E-road
asian-highwayUN ESCAP AH-network
roaddefault fallback

Use these in match expressions to render country-correct highway shields. See shields.md.