Mapbox Streets v7
This tileset reference document includes information to help you use the data in the Mapbox Streets v7 tileset.
Overview
The Mapbox Streets v7 tileset includes geometries and metadata for roadways, terrain, administrative boundaries, building footprints, land use classifications, rail stations, points of interest, and more.
OpenStreetMap
Mapbox Streets vector tiles are largely based on data from OpenStreetMap, a free & global source of geographic data built by volunteers. An understanding of the OpenStreetMap data structure and tagging system is not necessary to make use of Mapbox Streets vector tiles, though it's helpful to understand some of the details.
When you publicly use styles or software that use Mapbox Streets vector tiles, you must display proper attribution.
Name fields
There are 12 different name fields for each of the label layers:
| Field | Description |
|---|---|
name | The name (or names) used locally for the place. |
name_ar | Arabic (if available, otherwise same as name) |
name_en | English (if available, otherwise same as name) |
name_es | Spanish (if available, otherwise same as name_en) |
name_fr | French (if available, otherwise same as name_en) |
name_de | German (if available, otherwise same as name_en) |
name_pt | Portuguese (if available, otherwise same as name_en) |
name_ru | Russian (if available, otherwise same as name) |
name_ja | Japanese (if available, otherwise same as name) |
name_ko | Korean (if available, otherwise same as name) |
name_zh | Chinese* (if available, otherwise same as name) |
name_zh-Hans | Simplified Chinese* (if available, otherwise same as name) |
* The name_zh field contains Mandarin using simplified Chinese characters for our custom label layers: #country_label, #state_label, and #marine_label. All other label layers are sourced from OpenStreetMap and may contain one of several dialects and either simplified or traditional Chinese characters in the name_zh field. The name_zh-Hans field is similar, except any Traditional Chinese characters are automatically transformed to Simplified Chinese.
Boolean fields
Some fields represent a boolean condition; the value may be either true or false. To keep the vector tiles compact these fields may be stored as integers, where 0 = false and 1 = true.
Multiple geometry types
Mapnik vector tiles support multiple geometry types in the same layer. The Mapbox Streets source takes advantage of this for some layers.
A geometry in the vector tile can be one of 3 types:
In Mapbox Studio, you can select one, two, or all three of these geometry types with the Geometry Type toggles in each layer's Select data tab.
Data updates
The current supported version of the Mapbox Streets vector tiles receives regular data updates as new information becomes available and existing information is improved.
| Layer | Source |
|---|---|
| most layers | OpenStreetMap replication feed |
| #admin | custom OpenStreetMap processing |
| #water (ocean parts) | OpenStreetMap Data |
| #marine_label, #country_label, #state_label | custom data |
OpenStreetMap IDs
OpenStreetMap IDs are not stored as object properties but as object IDs within the vector tile. This means they are not available for styling via Mapbox Studio, but can still be interacted with via Mapbox GL JS and other vector tile libraries.
OpenStreetMap ID spaces are not unique across node, way, and relation object types. To make them unique for vector tiles, the IDs are transformed based on their OpenStreetMap object type.
| OpenStreetMap type | OpenStreetMap ID transform |
|---|---|
| node | id × 10 123 → 1230 |
| way | (id × 10) + 1 123 → 1231 |
| relation | (id × 10) + 4 123 → 1234 |
Often, multiple objects from OpenStreetMap will be combined into a single object in our vector tiles. For example, water polygons are unioned to avoid seams and road lines are joined to save space and simplify better. In these cases the osm_id will either be 0, or one of the input IDs chosen at random.
Layer Reference
The mapbox-streets-v7 tileset contains the following layers. For reference, the current minimum-available zoom level for each layer is mentioned, but note that this is subject to change as we roll out updates and improvements. It also does not apply to all features within a layer - only the most prominent features are available at lower-numbered zoom levels, and more features are available as you zoom in.
| Layer | Min. zoom level |
|---|---|
landuse | 5 |
waterway | 7 |
water | 0 |
aeroway | 9 |
barrier_line | 13 |
building | 13 |
landuse_overlay | 5 |
road | 5 |
admin | 0 |
country_label | 0 (max: 10) |
marine_label | 0 (max: 9) |
state_label | 1 (max: 11) |
place_label | 4 |
water_label | 8 |
airport_label | 8 |
rail_station_label | 12 |
mountain_peak_label | 8 |
poi_label | 5 |
motorway_junction | 11 |
road_label | 6 |
waterway_label | 13 |
housenum_label | 16 |
#landuse
This layer includes polygons representing both land-use and land-cover.
It's common for many different types of landuse/landcover to be overlapping, so the polygons in this layer are ordered by the area of their geometries to make sure smaller objects will not be obscured by larger ones. Pay attention to use of transparency when styling - the overlapping shapes can cause muddied or unexpected colors.
Classes
The main field used for styling the landuse layer is class.
| Value | Description |
|---|---|
'aboriginal_lands' | The boundary of aboriginal lands. |
'agriculture' | Various types of crop and farmland |
'cemetery' | Cemeteries and graveyards |
'glacier' | Glaciers or permanent ice/snow |
'grass' | Grasslands, meadows, fields, lawns, etc |
'hospital' | Hospital grounds |
'industrial' | Only includes airport areas |
'park' | City parks, village greens, playgrounds, national parks, nature reserves, etc |
'pitch' | Sports fields & courts of all types |
'rock' | Bare rock, scree, quarries |
'sand' | Sand, beaches, dunes |
'school' | Primary, secondary, post-secondary school grounds |
'scrub' | Bushes, scrub, heaths |
'wood' | Woods and forestry areas |
Type
The type field is pulled from the primary OpenStreetMap tags for that class.
#waterway
The waterway layer contains classes for rivers, streams, canals, etc represented as lines. These classes can represent a wide variety of possible widths. Since larger rivers and canals are usually also represented by polygons in the #water layer, make your line styling biased toward the smaller end of the scales. It should also be under the #water layer.
Classes and types
The waterway layer has two fields for styling - class and type - each with similar values.
| Value | Description |
|---|---|
'river' | Everything from the Amazon down to small creeks a couple meters wide |
'canal' | Medium to large artificial waterway |
'stream' | Small waterway, usually no wider than a meter or two |
'stream_intermittent' | Class only. A stream that does not always have water flowing through it. |
'drain' | Medium to small artificial channel for rainwater drainage, often concrete lined. |
'ditch' | Small artificial channel dug in the ground for rainwater drainage. |
#water
This layer includes all types of water bodies: oceans, rivers, lakes, ponds, reservoirs, fountains, and more.
It is a polygon layer with no differentiating types or classes, and consists of a single merged shape per tile. This allows for seamless stroke and transparency styling, but means there is no way to filter out or highlight specific water bodies or a partial subset of them.
Each zoom level includes a set of water bodies that has been filtered and simplified according to scale. The tileset shows only oceans, seas, and large lakes at the lowest zoom levels, while smaller and smaller lakes and ponds appear as you zoom in.
#aeroway
The aeroway layer includes both lines and polygons representing runways, helipads, etc.
Types
The type field separates different types of aeroways for styling.
| Value | Description |
|---|---|
'runway' | Where planes take off & land |
'taxiway' | Where planes move between runways, gates, and hangars |
'apron' | Where planes park, refuel, load |
'helipad' | Where helicopters take off & land |
#barrier_line
This layer includes lines and polygons for barriers - things such as walls and fences.
Classes
| Value | Description |
|---|---|
'cliff' | The precipice of a vertical or steep drop, gullies are included |
'fence' | Include various types of fence and wall barriers |
'gate' | Only gates that are lines or areas are included |
'hedge' | A line of closely spaced shrubs and tree species, which form a barrier or mark the boundary of an area |
'land' | Includes breakwaters and piers |
Cliff data from OpenStreetMap is designed such that the left-hand side of the line is the top of the cliff, and the right-hand side is the bottom.
#building
Large buildings appear at zoom level 13, and all buildings are included in zoom level 15 and up.
Underground buildings
The underground field is usually false, but will be true for buildings that are underground (for example, some subway stations).
Building types
The type field lets you differentiate building parts from building outlines. Building part polygons intended primarily for 3D rendering have a value of building:part. Building outlines (covering the full footprint of a building) will have a value of building if tagged as building=yes on OpenStreetMap, otherwise the value will match the building tag from OpenStreetMap (see TagInfo for common values).
Building heights
The height field contains the height of a building or building part in meters (rounded to the nearest integer). Often this value is derived from the building:levels tag on OpenStreetMap - we estimate 3 meters per level if no exact height is specified.
The min_height field contains the height in meters from the ground to the bottom of a building part, for cases where the bottom of the part is not on the ground. This allows for proper extrusion rendering of things such as sky bridges and cantilevered building parts.
The extrude field is true or false depending one whether the object should be included in 3D-extrusion renderings. For example a complex building might have various building:part objects mapped with different heights and a building object representing the footprint of the entire building. Only the building:part objects are needed for 3D rendering, so the full footprint outline will have an extrude value of false.
#landuse_overlay
This layer is for landuse / landcover polygons that your style should draw above the #water layer.
Classes
The main field used for styling the landuse_overlay layer is class.
| Value | Description |
|---|---|
'national_park' | Relatively large area of land set aside by a government for human recreation and enjoyment, animal and environmental protection |
'wetland' | Wetlands that may include vegetation (marsh, swamp, bog) |
'wetland_noveg' | Wetlands that probably don't contain vegetation (mud, tidal flat) |
Types
The type field is pulled from the primary OpenStreetMap tags for that class.
#road
The roads layers are some of the most complex ones in Mapbox Streets. The tileset merged separate bridge and tunnel layers into road. structure field describes whether the road segment is a bridge, tunnel, ford, or none. Bridges and tunnels are not distinct from roads until zoom level 13.
Classes
The main field used for styling the road layers is class.
| Value | Description |
|---|---|
'motorway' | High-speed, grade-separated highways |
'motorway_link' | Interchanges / on & off ramps |
'trunk' | Important roads that are not motorways. |
'primary' | A major highway linking large towns. |
'secondary' | A highway linking large towns. |
'tertiary' | A road linking small settlements, or the local centers of a large town or city. |
'link' | Contains link roads |
'street' | Standard unclassified, residential, road, and living_street road types |
'street_limited' | Streets that may have limited or no access for motor vehicles. |
'pedestrian' | Includes pedestrian streets, plazas, and public transportation platforms. |
'construction' | Includes motor roads under construction (but not service roads, paths, etc). |
'track' | Roads mostly for agricultural and forestry use etc. |
'service' | Access roads, alleys, agricultural tracks, and other services roads. Also includes parking lot aisles, public & private driveways. |
'ferry' | Those that serves automobiles and no or unspecified automobile service. |
'path' | Foot paths, cycle paths, ski trails. |
'major_rail' | Railways, including mainline, commuter rail, and rapid transit. |
'minor_rail' | Yard and service railways. |
'aerialway' | Ski lifts, gondolas, and other types of aerialway. |
'golf' | The approximate center line of a golf course hole |
One-way roads
The oneway field will have a value of either 'true' or 'false' to show whether the motor traffic on the road is one-way or not. If the road is one-way, traffic travels in the same direction as the linestring.
Types
The type field is the value of the road's "primary" OpenStreetMap tag. For most roads this is the highway tag, but for aerialways it will be the aerialway tag, and for golf holes it will be the golf tag. See TagInfo for a list of used tag values. Several classes pull in additional detail when it is available from OpenStreetMap.
Possible construction class type values:
'construction:motorway'
'construction:motorway_link'
'construction:trunk'
'construction:trunk_link'
'construction:primary'
'construction:primary_link'
'construction:secondary'
'construction:secondary_link'
'construction:tertiary'
'construction:tertiary_link'
'construction:unclassifed'
'construction:residential'
'construction:road'
'construction:living_street'
'construction:pedestrian'
'construction'
Possible track class type values:
'track:grade1'
'track:grade2'
'track:grade3'
'track:grade4'
'track:grade5'
'track'
Possible service class type values:
'service:alley'
'service:emergency_access'
'service:drive_through'
'service:driveway'
'service:parking'
'service:parking_aisle'
'service'
For the path class, the tileset made custom type assignments based on insight from various categorical, physical, and access tags from OpenStreetMap.
| Value | Description |
|---|---|
'steps' | aka stairs |
'corridor' | An indoors passageway |
'sidewalk' | aka 'pavement' in many places outside North America |
'crossing' | Usually connects sidewalk lines across a road |
'piste' | Ski & snowboard trails, both downhill and cross-country. |
'mountain_bike' | Trails used primarily or only for mountain biking |
'hiking' | Hiking trails or otherwise rough pedestrian paths |
'trail' | May be suitable for either hiking or mountain biking |
'cycleway' | Paths primarily or only for cyclists |
'footway' | Paths primarily or only for pedestrians |
'path' | Unspecified or mixed-use paths |
'bridleway' | Equestrian trails |
Possible ferry class type values:
| Value | Description |
|---|---|
'ferry_auto' | Ferry serves automobiles |
'ferry' | No or unspecified automobile service |
Possible aerialway class type values:
| Value | Description |
|---|---|
'aerialway:cablecar' | One or two large cars. The cable forms a loop, but the cars do not loop around, they move up and down on their own side. |
'aerialway:gondola' | Many cars on a looped cable. |
'aerialway:mixed_lift' | Mix of chair lifts and gondolas on the same line; may change seasonally. |
'aerialway:chair_lift' | Looped cable with a series of single chairs and exposed to the open air. |
'aerialway:drag_lift' | Includes t-bars, j-bars, platter/button lifts, and tow ropes |
'aerialway:magic_carpet' | Conveyor belt installed at the level of the snow, some include a canopy or tunnel. |
'aerialway' | Other or unspecified type of aerialway |
Layers
The layer field is used to determine drawing order of overlapping road segments in the tunnel and bridge layers. 95% of values are -1, 1, or 0, and 99.9999% of values are between -5 and 5.
#admin
Administrative boundary lines. These are constructed from the OpenStreetMap data in such a way that there are no overlapping lines where multiple boundary areas meet.
Administrative level
The admin_level field separates different levels of boundaries, using a similar numbering scheme to OpenStreetMap.
| Value | Description |
|---|---|
2 | Countries |
3 | Some subnational regions or groupings: regions of Papua New Guinea, The Philippines, Venezuela; governorates of Lebanon; federal districts of Russia; some disputed and semi-autonomous regions. |
4 | Most first-level subnational boundaries (states, provinces, etc.) |
Disputes
The disputed field should be used to apply a dashed or otherwise distinct style to disputed boundaries. No single map of the world will ever keep everybody happy, but acknowledging disputes where they exist is an important aspect of good cartography.
Maritime boundaries
The maritime field can be used as a filter to downplay or hide maritime boundaries, which are often not shown on maps. Note that the practice of tagging maritime boundaries is not entirely consistent or complete within OpenStreetMap, so some boundaries may not have this field set correctly (this mostly affects admin levels 3 & 4).
ISO 3166-1 Codes
The iso_3166_1 field contains the ISO 3166-1 alpha-2 code or codes that apply to a boundary. For subnational boundaries this will be a single code of the parent country. For international boundaries between two countries, the value will be the codes of both countries in alphabetical order, separated by a dash (-).
#country_label
This layer contains points used for labeling countries. The points are placed for minimal overlap with small to medium-sized text.
Names
See Name fields in the overview for information about names and translations.
ISO 3166-1 Code
The code field contains the ISO 3166-1 2-letter country code.
Administrative Code
For territories and other special entities in the countries layer, the admin_code field contains the ISO 3166-1 2-letter country code of the administering or "parent" state.
Scalerank
The scalerank field is intended to help assign different label styles based on the size and available room to label different countries. The possible values are 1 through 6.
#marine_label
Points and lines for labeling major marine features such as oceans, seas, large lakes & bays.
Names
See Name fields in the overview for information about names and translations.
Labelrank & placement
The labelrank field is intended to help assign different label styles based on the size and available room to label different water bodies. The possible values are whole numbers 1 through 6.
The value of the placement field will be either point or line depending on the geometry type of the object. (You can also make this distinction with a Geometry Type filter.)
#state_label
Points for labeling states and provinces. Only a small number of countries are included.
Names
See Name fields in the overview for information about names and translations.
Abbreviations
The abbr field contains abbreviated versions of the names suitable for labeling at lower zoom levels.
Area
The area field is the physical area of the entity in square kilometers. Use it to help filter and size your state labels at different zoom levels.
#place_label
This layer contains points for labeling human settlements.
Names
See Name fields in the overview for information about names and translations.
Types
The main field for styling labels for different kinds of places is type.
| Value | Description |
|---|---|
'city' | Settlement of about 100,000 or more people. |
'town' | Urban or rural settlement of about 10,000-100,000 people |
'village' | Usually rural settlement of less than about 10,000 |
'hamlet' | Rural settlement with a population of about 200 or fewer |
'suburb' | A distinct section of an urban settlement such as an annexed town, historical district, or large & important neighborhood. |
'neighbourhood' | A named part of a larger settlement |
'island' | |
'islet' | A small island. |
'archipelago' | Collective name for a group of islands |
'residential' | Named residential areas, including subdivisions and apartment complexes |
'aboriginal_lands' | Reservations and other aboriginal lands |
Capitals
The capital field allows distinct styling of labels or icons for the capitals of countries, regions, or states & provinces. The value of this field may be 2, 3, 4, 5, or 6. National capitals are 2, and 3 through 6 represent capitals of various sub-national administrative entities. These levels come from OpenStreetMap and have different meanings in different countries - see the OpenStreetMap wiki for specific details.
Scalerank
The scalerank field can be used to adjust the prominence of label styles for larger and more prominent cities. The value number from 0 through 9, where 0 is the large end of the scale (for example New York City). All places other than large cities will have a scalerank of null.
Localrank
The localrank field can be used to adjust the label density by showing fewer labels. It is a whole number greater than 0 calculated by grouping places into a 128 pixel grid at each zoom level, then assigning each place a ranking within that grid. The most important place in that 128 pixels will get a localrank of 1, the second most important is 2, and so on. So to reduce the label density to 4 labels per tile, you can add the filter [localrank=1].
Label direction
The ldir field can be used as a hint for label offset directions at lower zoom levels. For places with a scalerank value set, the ldir will be a cardinal direction such as 'N', 'E', 'SW'.
#water_label
This layer contains points for labeling bodies of water such as lakes and ponds.
Names
See Name fields in the overview for information about names and translations.
Area
The area field holds the area of the associated water polygon in square meters (Mercator-projected units rounded to the nearest whole number, not real-world area). You can use it to adjust label size and visibility.
#poi_label
This layer is used to place icons and labels for various points of interest (POIs).
Names
See Name fields in the overview for information about names and translations.
Maki icons
The maki field is designed to make it easier to add icons to POIs using the Maki icon project, or with other icons that follow the same naming scheme.
Not all Maki icons are used, and different types of related POIs will sometimes have the same maki value (for example universities and colleges, or art supply shops and art galleries). Nameless POIs will have never have a Maki value of marker (the generic default). The possible values for the maki field are listed below.
null
'airfield'
'alcohol-shop'
'amusement-park'
'aquarium'
'art-gallery'
'attraction'
'bakery'
'bank'
'bar'
'beer'
'bicycle'
'bicycle-share'
'bus'
'cafe'
'car'
'campsite'
'castle'
'cemetery'
'cinema'
'clothing-store'
'college'
'dentist'
'doctor'
'dog-park'
'drinking-water'
'embassy'
'entrance'
'fast-food'
'ferry'
'fire-station'
'fuel'
'garden'
'golf'
'grocery'
'harbor'
'heliport'
'hospital'
'ice-cream'
'information'
'laundry'
'library'
'lodging'
'monument'
'museum'
'music'
'park'
'pharmacy'
'picnic-site'
'place-of-worship'
'playground'
'police'
'post'
'prison'
'religious-christian'
'religious-jewish'
'religious-muslim'
'restaurant'
'rocket'
'school'
'shop'
'stadium'
'swimming'
'suitcase'
'theatre'
'toilet'
'town-hall'
'veterinary'
'zoo'
Types
The type field contains a more specific classification intended for display - for example 'Cafe', 'Hotel', 'Laundry'. These values come from the original OpenStreetMap tags and are not a limited set.
Scalerank
The scalerank field is intended to help assign different label styles based on the prominence of different features.
| Value | Description |
|---|---|
1 | The POI has a large area |
2 | The POI has a medium-large area |
3 | The POI has a small area, or is of a type that is commonly large and important (for example hospital, university) |
4 | The POI has no known area |
5 | The POI has no name |
Controlling label density
The localrank field can be used to adjust the label density by showing fewer labels. It is a whole number >=1 calculated by grouping places into a ~300m projected grid, then assigning each place a ranking within that grid. The most important place in each cell will get a localrank of 1, the second most important is 2, and so on.
#road_label
Names
See Name fields in the overview for information about names and translations.
Route numbers
Besides the standard name fields, there is also a ref field that holds any reference codes or route numbers a road may have. From zoom levels 6 through 10, all geometries are points and the only labels are highways shields. From zoom level 11 and up the geometries are all lines.
The shield field indicates the style of shield needed for the route. Current possibilities are:
| Value | Description |
|---|---|
default | |
at-motorway | Austria (Autobahnen) |
at-expressway | Austria (Schnellstraßen) |
at-state-b | Austria (Landesstraßen B) |
br-federal | Brazil |
br-state | Brazil |
bg-motorway | Bulgaria |
bg-national | Bulgaria |
hr-motorway | Croatia |
hr-state | Croatia |
hr-county | Croatia |
cz-motorway | Czech Republic |
cz-expressway | Czech Republic |
cz-road | Czech Republic |
dk-primary | Denmark |
dk-secondary | Denmark |
fi-main | Finland |
fi-trunk | Finland |
fi-regional | Finland |
de-motorway | Germany (Autobahnen) |
de-federal | Germany (Bundesstraßen) |
gr-motorway | Greece |
gr-national | Greece |
hu-motorway | Hungary |
hu-main | Hungary |
in-national | India |
in-state | India |
nz-state | New Zealand |
pe-national | Peru |
pe-regional | Peru |
pl-motorway | Poland |
pl-expressway | Poland |
pl-national | Poland |
pl-voivodeship | Poland |
ro-motorway | Romania |
ro-national | Romania |
ro-county | Romania |
ro-communal | Romania |
rs-motorway | Serbia |
rs-state-1b | Serbia |
rs-state-2a | Serbia |
rs-state-2b | Serbia |
sk-highway | Slovakia |
sk-road | Slovakia |
si-motorway | Slovenia |
si-expressway | Slovenia |
si-main | Slovenia |
za-national | South Africa |
za-provincial | South Africa |
za-regional | South Africa |
za-metropolitan | South Africa |
se-main | Sweden |
ch-motorway | Switzerland |
ch-main | Switzerland |
mx-federal | United States |
mx-state | United States |
us-interstate | United States |
us-interstate-duplex | United States |
us-interstate-business | United States |
us-interstate-truck | United States |
us-highway | United States |
us-highway-duplex | United States |
us-highway-alternate | United States |
us-highway-business | United States |
us-highway-bypass | United States |
us-highway-truck | United States |
us-state | United States |
e-road | European E-roads |
To aid with shield styling the reflen field conveys the number of characters present in the ref field. Values can be 1-4. If the ref is 'M27', then the reflen is 3.
Classes
The class field for road labels matches the #road layers.
| Value | Description |
|---|---|
'motorway' | High-speed, grade-separated highways |
'motorway_link' | Interchanges / on & off ramps |
'trunk' | Important roads that are not motorways. |
'primary' | A major highway linking large towns. |
'secondary' | A highway linking large towns. |
'tertiary' | A road linking small settlements, or the local centers of a large town or city. |
'link' | Contains link roads |
'street' | Standard unclassified, residential, road, and living_street road types |
'street_limited' | Streets that may have limited or no access for motor vehicles. |
'pedestrian' | Includes pedestrian streets, plazas, and public transportation platforms. |
'construction' | Includes motor roads under construction (but not service roads, paths, etc). |
'track' | Roads mostly for agricultural and forestry use etc. |
'service' | Access roads, alleys, agricultural tracks, and other services roads. Also includes parking lot aisles, public & private driveways. |
'ferry' | Those that serves automobiles and no or unspecified automobile service. |
'path' | Foot paths, cycle paths, ski trails. |
'major_rail' | Railways, including mainline, commuter rail, and rapid transit. |
'minor_rail' | Yard and service railways. |
'aerialway' | Ski lifts, gondolas, and other types of aerialway. |
'golf' | The approximate center line of a golf course hole |
Additional information
The len field stores the length of the road segment in projected meters, rounded to the nearest whole number. This can be useful for limiting some label styles to longer roads.
#motorway_junction
This layer contains point geometries for labeling motorway junctions (aka highway exits). Classes and types match the types in the road layer.
Label text
The motorway junction layer has a ref field and a name field for styling labels. The reflen field tells you how long the ref value is in case you want to style this layer with shields.
Classes & types
The class and type fields tell you what kind of road the junction is on. See the #road layer for possible values.
#waterway_label
This layer contains line geometries that match those in the #waterway layer but with name fields for label rendering.
Label text
See Name fields in the overview for information about names and translations.
Classes & types
The class and type fields match those in the #waterway layer.
| Value | Description |
|---|---|
'river' | Everything from the Amazon down to small creeks a couple meters wide |
'canal' | Medium to large artificial waterway |
'stream' | Small waterway, usually no wider than a meter or two |
'stream_intermittent' | Class only. A stream that does not always have water flowing through it. |
'drain' | Medium to small artificial channel for rainwater drainage, often concrete lined. |
'ditch' | Small artificial channel dug in the ground for rainwater drainage. |
#airport_label
This layer contains point geometries that are one of: airport, airfield, heliport, and rocket.
Label text
See Name fields in the overview for information about names and translations.
Airport Codes
The ref field contains short identifier codes for many airports. These are pulled from the OpenStreetMap tags iata, ref, icao, or faa (in order of preference).
Maki
The maki field lets you assign different icons to different types of airports.
| Value | Description |
|---|---|
'airport' | Most commercial airports |
'airfield' | Smaller airports & private airfields |
'heliport' | For helicopters |
'rocket' | Spaceflight facilities |
Scalerank
The scalerank field is a number representing the size / importance of the airport. Possible values are 1 (large airport) through 4 (small airport).
#rail_station_label
This layer contains point geometries with name fields for label rendering.
Label text
See Name fields in the overview for information about names and translations.
Maki
The maki field lets you assign icons to the rail station based on a few basic station types:
| Value | Description |
|---|---|
'rail' | Default rail station |
'rail-metro' | Station for a subway, metro, or other rapid-transit system |
'rail-light' | Light rail station |
'entrance' | Specific station entrance points (for example stairs, escalators, elevators) |
Network
The network field lets you assign more specific icons for rail stations that are part of specific local or regional transit systems. They don't necessarily correspond to a specific network - for example de-u-bahn applies to any U-Bahn network in Germany since these can all use the same icon in a map style. Some stations serve multiple networks; in these cases, multiple network names are joined with a dot (in alphabetical order).
If none of the specific networks below apply to a station, the network value will be the same as the maki value (see previous section).
| Value | Description |
|---|---|
'barcelona-metro' | Barcelona, Spain |
'boston-t' | Boston, Massachusetts |
'chongqing-rail-transit' | Chongqing, China |
'de-s-bahn' | Germany |
'de-s-bahn.de-u-bahn' | Germany |
'de-u-bahn' | Germany |
'delhi-metro' | Delhi, India |
'gb-national-rail' | London, United Kingdom |
'gb-national-rail.london-dlr' | London, United Kingdom |
'gb-national-rail.london-dlr.london-overground.london-tfl-rail.london-underground' | London, United Kingdom |
'gb-national-rail.london-dlr.london-overground.london-underground' | London, United Kingdom |
'gb-national-rail.london-dlr.london-underground' | London, United Kingdom |
'gb-national-rail.london-overground' | London, United Kingdom |
'gb-national-rail.london-overground.london-tfl-rail.london-underground' | London, United Kingdom |
'gb-national-rail.london-overground.london-underground' | London, United Kingdom |
'gb-national-rail.london-tfl-rail' | London, United Kingdom |
'gb-national-rail.london-tfl-rail.london-overground' | London, United Kingdom |
'gb-national-rail.london-tfl-rail.london-underground' | London, United Kingdom |
'gb-national-rail.london-underground' | London, United Kingdom |
'hong-kong-mtr' | Hong Kong |
'kiev-metro' | Kiev, Ukraine |
'london-dlr' | Docklands Light Rail, London, United Kingdom |
'london-dlr.london-tfl-rail' | London, United Kingdom |
'london-dlr.london-tfl-rail.london-underground' | London, United Kingdom |
'london-dlr.london-underground' | London, United Kingdom |
'london-overground' | London Overground, United Kingdom |
'london-overground.london-tfl-rail' | London Overground, United Kingdom |
'london-overground.london-tfl-rail.london-underground' | London Overground, United Kingdom |
'london-overground.london-underground' | London, United Kingdom |
'london-tfl-rail' | London, United Kingdom |
'london-tfl-rail.london-underground' | London, United Kingdom |
'london-underground' | London Underground, United Kingdom |
'madrid-metro' | Madrid, Spain |
'mexico-city-metro' | Mexico City, Mexico |
'milan-metro' | Milan, Italy |
'moscow-metro' | Moscow Metro, Russia |
'new-york-subway' | New York City, New York |
'osaka-subway' | Osaka, Japan |
'oslo-metro' | Oslo, Norway |
'paris-metro' | Paris Metro, France |
'paris-rer' | Paris regional commuter rail, France |
'paris-metro.paris-rer' | Paris, France |
'paris-rer.paris-transilien' | Paris, France |
'paris-transilien' | Paris suburban rail, France |
'philadelphia-septa' | Philadelphia, Pennsylvania |
'san-francisco-bart' | San Francisco, California |
'singapore-mrt' | Singapore |
'stockholm-metro' | Stockholm, Sweden |
'taipei-metro' | Taipei, Taiwan |
'tokyo-metro' | Tokyo, Japan |
'vienna-u-bahn' | Vienna, Austria |
'washington-metro' | Washington DC Metro |
#mountain_peak_label
This layer contains point geometries that are contains mountain peaks. Include fields elevation_m & elevation_ft which contain the peak elevations in meters and feet, respectively. Values are rounded to the nearest integer.
Label text
See Name fields in the overview for information about names and translations.
Maki
The maki field lets you distinguish volcanoes from other types of peaks.
| Value | Description |
|---|---|
'volcano' | Volcanoes |
'mountain' | All other types of peaks (including hilltops) |
Elevations
The elevation_m and elevation_ft fields hold the peak elevation in meters and feet, respectively. Values are rounded to the nearest whole number and do not include units. Use a text field such as {elevation_ft} feet or {elevation_m}m in Mapbox Studio to display the units.
#housenum_label
This layer contains points used to label the street number parts of specific addresses.
The house_num field contains house and building numbers. These are commonly integers but may include letters or be only letters, for example "1600", "31B", "D". If an address has no number tag but has a house name or building name, the house_num field will be the name instead.
Changelog
A summary of the changes from v6:
Mapbox Streets v7 contains 10 major changes that may require reworking of your styles depending on how they've been constructed:
- The tileset merged separate
#bridgeand#tunnellayers into#road. A newstructureclass field describes whether the road segment is abridge,tunnel,ford, ornone. When upgrading from v6, bridge and tunnel style layers should be pointed at the#roadlayer with appropriate filters on thestructurefield. Bridges and tunnels are not distinct from roads until zoom level 13. - The tileset introduced major changes to the
classfields in the #road layer:- The
mainclass has been separated intotrunk,primary,secondary, andtertiaryclasses. - The
streetclass has been modified to includeunclassified,residential,roadandliving_street. - The
street_limitedclass no longer includes pedestrian streets or roads under construction. - New classes:
pedestrian- includes pedestrian streets, plazas, and public transportation platformsconstruction- includes motor roads under construction (but not service roads, paths, etc)track- contains tracks that were part of theserviceclass in v6ferry
- The following class names have been unchanged:
motorway,motorway_link,path,golf,major_rail, andminor_rail. - Class names
mainanddrivewayhave been removed. - Classes
construction,track,service,path,ferryandaerialwaypull in additionaltypedetail when it is available from OpenStreetMap as outlined in #road section.
- The
- Road labels: new road classes will also apply to their corresponding labels.
- New possible combination of
shield=us-highwaywithreflen=4. This may require a new sprite image. New networks added to theroad_labellayer'sshieldfield. These will require new sprite images. - New layer #mountain_peak_label contains mountain peaks that were in the
poi_labellayer in v6. New fieldselevation_m&elevation_ftcontain the peak elevations in meters and feet, respectively. Values are rounded to the nearest integer. New values in themakifield:mountain,volcano. - New layer #airport_label contains airports that were in the
poi_labellayer in v6. - New layer #rail_station_label contains rail stations that were in the
#poi_labellayer in v6. The tileset introduced major changes tonetworkfield values. New networks have been added and existing networks renamed for clarity. If you are using this field to style rail station icons you will need to rename existing sprite images and add new ones. See outlined below in #rail_station_label. - National parks and similar parks are now in their own class
national_parkin thelanduse_overlaylayer, while in v6 they were part of theparkclass of thelanduselayer. - New
typevalues have been added to theplace_labellayer:island(moved frompoi_label),islet(moved frompoi_label),archipelago,residential, andaboriginal_lands. - OpenStreetMap ID transformation algorithm has changed (see previous section) and are stored as vector tile object IDs rather than standalone fields.
Additionally, v7 includes the following more specific/limited changes:
- Landuse:
class=aboriginal_landshas been added here fromboundary=aboriginal_landsandboundary:type=aboriginal_landsin OpenStreetMap. - POI labels: the
namefield of thepoi_labellayer may be null (in v6, nameless POIs were not included). Nameless POIs will have never have amakivalue ofmarker(the generic default). - POI labels: adjustments to existing Maki values:
grocery: now includes marketplacesshop: now includes camera and photo shops (cameravalue is removed)
- Gullies: the
class=clifffeatures in the barrier_line layer now includenatural=earth_bank(aka gully) objects from OpenStreetMap. - Road labels: 'Park' is no longer abbreviated to 'Pk'.
- Bridges and tunnels are not distinct from roads until zoom level 13.
- Underground buildings: the
buildinglayer includes a newundergroundfield that is eithertrueorfalsedepending on whether the building is underground (for example a subway station)