# Map data sources
Last updated:
October 13, 2026
\| 16 minutes read
For developers: which map data each `sourcedata_id` number draws, for every layer type. You need this only to write or check a [style file](/docs/guides/map-studio/reference/style-file-format.md) by hand or with an AI. In Studio, Available Layers sets the numbers for you.
## How a layer finds its data[](#how-a-layer-finds-its-data "Direct link to How a layer finds its data")
A layer draws map data through two fields together: its `type` and its `sourcedata_id`. **The number alone does not name the data.** The same number means different things in different layer types:
| `type` | `sourcedata_id` | Draws |
| --------- | --------------- | ----------------------------- |
| `polygon` | 0 | Land |
| `line` | 0 | Motorway |
| `symbol` | 0 | Metropolis (over 500k) labels |
The numbers come in families:
* **Roads.** `line` (the road), `street` (its name), `linkarrows` (one-way arrows) and `roadshield` (route number shields) share one numbering: 0 is Motorway in all four.
* **Areas.** `polygon` and `polyline` share one numbering, and no number is used by both. `areaname` labels an area with the area's own number: 9 is Water as a `polygon` and Lake Name as an `areaname`.
* **Places and points.** `symbol` has its own numbering: city labels, POIs, house numbers.
* **The rest.** `buildings`, `country`, `raster`, `hillshade`, `elevation`, `wind`, `background` and `atmosphere` each draw one kind of data.
A layer takes one `sourcedata_id`, so each class needs its own layer: motorways and trunk roads are two layers.
All the map data on this page uses `"source": "map"` unless a table says otherwise.
A water layer, shortened from the Basic 1 template:
```json
{
"COMMENT": "Water",
"id": 37,
"type": "polygon",
"source": "map",
"sourcedata_id": 9,
"minzoom": 0,
"paint": {
"fill-color": {
"color_stops": {
"color_stop": [{ "level_id": 0, "color": 4294957738 }],
"easing_type": 1
}
}
}
}
```
## Where these numbers come from[](#where-these-numbers-come-from "Direct link to Where these numbers come from")
Every number on this page is used by at least one of Magic Lane's 40 official templates, the ones the portal offers when you create a style. **Typical zoom** says at which zoom levels the templates show the layer. The map has zoom levels 0 to 17: 0 shows the whole world, 17 a few streets. `4–17` means the layer appears once you zoom in to level 4 and stays visible all the way in to 17; zoomed out further than 4, it is hidden. This is the `minzoom` and `maxzoom` most templates give the layer; a range ending in 17 includes layers with no `maxzoom`. **Templates** says how many of the 40 use the number.
The map data may hold classes that no template draws. A number that is not on this page may draw nothing.
## Roads[](#roads "Direct link to Roads")
Each road class can be drawn by four layer types: the road itself, its name, its one-way arrows and its route number shield (such as A1). All four use the same number. Each cell gives the typical zoom at which the templates show it; — means no official template draws it.
For example, the Motorway row says: the motorway line appears from zoom 4, its name from zoom 11, its one-way arrows from zoom 14 and its shields from zoom 5.
| `sourcedata_id` | Road class | Road line (`line`) | Name (`street`) | One-way arrows (`linkarrows`) | Shield (`roadshield`) |
| --------------- | -------------- | ------------------ | --------------- | ----------------------------- | --------------------- |
| 0 | Motorway | 4–17 | 11–17 | 14–17 | 5–17 |
| 1 | Trunk | 4–17 | 11–17 | 14–17 | 8–17 |
| 2 | Primary | 4–17 | 11–17 | 13–17 | 8–17 |
| 3 | Secondary | 4–17 | 11–17 | 14–17 | 9–17 |
| 4 | Tertiary | 4–17 | 11–17 | 14–17 | 10–17 |
| 5 | Unclassified | 11–17 | 12–17 | 14–17 | 10–17 |
| 6 | Residential | 11–17 | 13–17 | 14–17 | — |
| 7 | Service | 13–17 | 13–17 | 14–17 | — |
| 8 | Motorway Link | 8–17 | 11–17 | 14–17 | — |
| 9 | Trunk Link | 10–17 | 13–17 | 14–17 | — |
| 10 | Primary Link | 10–17 | 13–17 | 14–17 | — |
| 11 | Secondary Link | 11–17 | 13–17 | 14–17 | — |
| 12 | Tertiary Link | 11–17 | 13–17 | 14–17 | — |
| 13 | Living Street | 11–17 | 13–17 | 14–17 | — |
| 14 | Pedestrian | 13–17 | 13–17 | 14–17 | — |
| 15 | Track | 12–17 | 13–17 | 14–17 | — |
| 16 | Bus Guideway | 12–17 | 13–17 | 14–17 | — |
| 17 | Raceway | 14–17 | 14–17 | 14–17 | — |
| 18 | Road | 12–17 | 13–17 | 14–17 | — |
| 19 | Footway | 12–17 | 14–17 | 14–17 | — |
| 20 | Cycleway | 14–17 | 14–17 | 14–17 | — |
| 21 | Bridleway | 14–17 | 14–17 | 14–17 | — |
| 22 | Steps | 13–17 | 13–17 | 17–17 | — |
| 23 | Path | 14–17 | 14–17 | 14–17 | — |
| 24 | Unpaved | 11–17 | 13–17 | 14–17 | — |
| 25 | Ferry | 6–17 | 12–17 | 14–17 | — |
| 26 | Train-Ferry | 11–17 | 14–17 | 14–17 | — |
| 27 | Construction | 14–17 | 13–17 | 14–17 | — |
## Areas (`polygon`)[](#areas-polygon "Direct link to areas-polygon")
Filled areas. Numbers 96 to 114 are road and path surfaces drawn as areas.
Order matters where areas overlap. The official templates put, from top to bottom: lakes and rivers (Water, 9) above the parks and other land-use areas, then Island (1), Water Sea (94) and Land (0) at the bottom, just above the background. They give the background the water colour.
| `sourcedata_id` | Draws | Typical zoom | Templates |
| --------------- | ---------------------- | ------------ | --------- |
| 0 | Land | 0–17 | 30 |
| 1 | Island | 0–17 | 24 |
| 2 | Wood | 3–17 | 14 |
| 3 | Built-up / Urban Areas | 0–17 | 4 |
| 4 | Industry | 8–17 | 4 |
| 5 | Airport | 4–17 | 26 |
| 6 | Green | 0–17 | 8 |
| 9 | Water | 0–17 | 30 |
| 23 | Green Park | 8–17 | 30 |
| 25 | Parking | 11–17 | 12 |
| 26 | Gas Station | 11–17 | 4 |
| 27 | Cemetery | 8–17 | 28 |
| 28 | Marketplace | 11–15 | 8 |
| 29 | Fountain | 0–17 | 30 |
| 30 | Transport Station | 11–17 | 4 |
| 31 | Pedestrian | 10–17 | 6 |
| 32 | Trailer Park | 8–17 | 4 |
| 33 | Farm | 4–17 | 6 |
| 34 | Public Square | 11–17 | 4 |
| 35 | Campground | 11–17 | 4 |
| 36 | Bridge | 0–17 | 20 |
| 39 | Snow | 4–17 | 8 |
| 42 | Archaeological Site | 11–17 | 4 |
| 43 | Sand | 4–17 | 24 |
| 44 | Wetland | 0–17 | 6 |
| 45 | Ice | 4–17 | 4 |
| 46 | Fence | 11–17 | 4 |
| 48 | Yard | 11–17 | 8 |
| 49 | Rock | 3–17 | 14 |
| 51 | Harbour | 0–17 | 30 |
| 53 | Playground | 11–17 | 20 |
| 54 | Sports Pitch | 4–17 | 28 |
| 55 | Commons | 4–17 | 6 |
| 56 | Brownfield | 8–17 | 4 |
| 57 | Vineyard | 4–17 | 6 |
| 58 | Forest | 0–17 | 14 |
| 59 | Military | 8–17 | 4 |
| 60 | Heathland | 0–17 | 8 |
| 61 | Apron | 8–17 | 8 |
| 62 | Runway | 8–17 | 24 |
| 64 | Terminal | 4–17 | 24 |
| 66 | Quarry | 11–17 | 4 |
| 67 | Zoo | 8–17 | 4 |
| 69 | Track Polygon | 11–17 | 4 |
| 70 | Allotments | 11–17 | 4 |
| 71 | Power Station | 11–17 | 4 |
| 73 | School / University | 11–17 | 22 |
| 74 | Rest Area | 11–17 | 4 |
| 76 | Beach | 4–17 | 26 |
| 77 | Desert | 4–17 | 8 |
| 78 | Glacier | 4–17 | 24 |
| 79 | Mud | 8–17 | 4 |
| 80 | Farmyard | 8–17 | 4 |
| 81 | Garages | 0–17 | 8 |
| 82 | Grassland | 4–17 | 6 |
| 84 | Hospital | 9–17 | 24 |
| 85 | Theme Park | 11–17 | 4 |
| 91 | Platform | 11–17 | 4 |
| 94 | Water Sea | 0–17 | 30 |
| 96 | Motorway Area | 4–17 | 6 |
| 97 | Trunk Area | 4–17 | 6 |
| 98 | Primary Area | 4–17 | 6 |
| 99 | Secondary Area | 6–17 | 6 |
| 100 | Tertiary Area | 6–17 | 6 |
| 101 | Unclassified Area | 9–17 | 6 |
| 102 | Residential Area | 11–17 | 2 |
| 103 | Service Area | 11–17 | 2 |
| 104 | Living Street Area | 11–17 | 2 |
| 105 | Pedestrian Area | 11–17 | 2 |
| 106 | Track Area | 11–17 | 2 |
| 107 | Bus Guideway Area | 9–17 | 6 |
| 108 | Raceway Area | 11–17 | 6 |
| 109 | Road Area | 11–17 | 2 |
| 110 | Footway Area | 11–17 | 2 |
| 111 | Cycleway Area | 11–17 | 2 |
| 112 | Bridleway Area | 11–17 | 2 |
| 113 | Path Area | 11–17 | 2 |
| 114 | Unpaved Area | 11–17 | 2 |
## Lines that are not roads (`polyline`)[](#lines-that-are-not-roads-polyline "Direct link to lines-that-are-not-roads-polyline")
Borders, rail, water lines and other outlines. Some templates draw a border twice with the same number: a background line underneath and the border on top.
| `sourcedata_id` | Draws | Typical zoom | Templates |
| --------------- | ----------------- | ------------ | --------- |
| 8 | Airplane Road | 8–17 | 24 |
| 10 | Water Line | 0–17 | 4 |
| 11 | Rail | 9–17 | 24 |
| 12 | State Park | 4–17 | 20 |
| 13 | Disputed Border | 0–17 | 33 |
| 14 | Country Border | 0–17 | 33 |
| 17 | State Border | 3–17 | 33 |
| 37 | Track | 5–17 | 8 |
| 38 | Wall | 11–17 | 4 |
| 40 | Dam | 8–17 | 4 |
| 47 | Aerialway | 10–17 | 8 |
| 50 | Subway Bridge | 11–17 | 14 |
| 52 | Slide | 8–17 | 4 |
| 63 | Runway Line | 8–17 | 24 |
| 65 | Harbour Line | 8–17 | 4 |
| 72 | Power Line | 0–17 | 4 |
| 83 | Harbour Outline | 12–17 | 4 |
| 86 | Narrow Water Line | 7–17 | 30 |
| 88 | Subway | 11–17 | 14 |
| 93 | Thick Wall | 11–17 | 4 |
## Area labels (`areaname`)[](#area-labels-areaname "Direct link to area-labels-areaname")
The name of an area, with the area's own number. 10 and 86 label the water lines drawn by `polyline` 10 and 86.
| `sourcedata_id` | Draws | Typical zoom | Templates |
| --------------- | ----------------------- | ------------ | --------- |
| 1 | Island Label | 5–15 | 23 |
| 4 | Industry Label | 12–17 | 4 |
| 5 | Airport Label | 8–17 | 28 |
| 9 | Lake Name | 9–17 | 34 |
| 10 | Water Line Label | 12–17 | 34 |
| 12 | State Park Label | 7–17 | 8 |
| 23 | Green Park Label | 9–17 | 12 |
| 27 | Cemetery Label | 13–17 | 4 |
| 33 | Farm Label | 9–17 | 4 |
| 58 | Forest Label | 9–17 | 4 |
| 76 | Beach Label | 13–17 | 4 |
| 86 | Narrow Water Line Label | 12–17 | 34 |
| 94 | Water Sea Name | 2–17 | 34 |
## Places and points (`symbol`)[](#places-and-points-symbol "Direct link to places-and-points-symbol")
33024 and 3076010 come from the `overlay` source; the rest from `map`.
| `sourcedata_id` | Draws | `source` | Typical zoom | Templates |
| --------------- | ---------------------------------------------------------------------------- | --------- | ------------ | --------- |
| 0 | Metropolis (Over 500k) | `map` | 3–13 | 35 |
| 1 | Large City (100k-500k) | `map` | 4–13 | 35 |
| 2 | City (50k-100k) | `map` | 5–13 | 35 |
| 3 | City (10k-50k) | `map` | 6–13 | 35 |
| 4 | City (5k-10k) | `map` | 7–13 | 34 |
| 5 | Small City (1k-5k) | `map` | 6–13 | 34 |
| 6 | Small City (500-1k) | `map` | 10–13 | 34 |
| 7 | Village / Hamlet (0-500) | `map` | 10–13 | 34 |
| 9 | Exit Names | `map` | 14–17 | 19 |
| 12 | POIs, one layer per category (see [Points of interest](#points-of-interest)) | `map` | 16–17 | 34 |
| 14 | House Numbers | `map` | 16–17 | 4 |
| 15 | State Name | `map` | 4–7 | 31 |
| 33024 | Safety Cameras | `overlay` | 13–17 | 38 |
| 3076010 | Public Transit Stops | `overlay` | 14–17 | 34 |
## Other layer types[](#other-layer-types "Direct link to Other layer types")
| `type` | `sourcedata_id` | `source` | Draws | Typical zoom | Templates |
| ------------ | --------------- | -------------------------------- | -------------------- | ------------ | --------- |
| `country` | 0 | `map` | Country Labels | 0–7 | 35 |
| `buildings` | 3 | `map` | Built Up (buildings) | 14–17 | 30 |
| `raster` | 5 | `satellite`, `satelliteExternal` | Satellite | 0–17 | 9 |
| `hillshade` | 13 | `elevation` | Hillshade | 0–6 | 13 |
| `elevation` | 13 | `elevation` | Elevation | 7–17 | 13 |
| `wind` | 11 | `weather` | Wind | 3–15 | 1 |
| `background` | 0 | leave out | Background | 0–17 | 39 |
| `atmosphere` | 0 | leave out | Atmosphere | 0–17 | 38 |
`background` must be the last layer in `definition.layers`, so it is drawn under everything else. A `satelliteExternal` raster layer also needs its source declared in `sources_list`; see the [style file format](/docs/guides/map-studio/reference/style-file-format.md).
Contour lines use `"source": "contourpolyline"`, with type `contour_polyline` for the lines and `contour_label` for their labels, and `contour_interval` for the interval between lines. No official template draws them.
## Points of interest[](#points-of-interest "Direct link to Points of interest")
POIs are `symbol` layers on `sourcedata_id` 12. Most templates draw them as one layer per category, each with the category in `metaCategoryID`; the map engine draws the category's own icon. The other templates have a single POI layer with no `metaCategoryID`.
| `metaCategoryID` | Category | Templates |
| ---------------- | ------------------------------ | --------- |
| 1000 | Gas Stations | 21 |
| 1001 | Parking | 21 |
| 1002 | Food and Drink | 21 |
| 1003 | Accommodation | 21 |
| 1004 | Medical Services | 21 |
| 1005 | Shopping | 21 |
| 1006 | Auto Service | 21 |
| 1007 | Transport | 21 |
| 1008 | Wikipedia | 21 |
| 1009 | Education | 21 |
| 1010 | Entertainment | 21 |
| 1011 | Public Services | 20 |
| 1012 | Geographical Areas | 21 |
| 1013 | Business | 20 |
| 1014 | Sightseeing | 21 |
| 1015 | Religious Places | 21 |
| 1016 | Roadside | 21 |
| 1017 | Sports | 21 |
| 1018 | NOC | 21 |
| 1019 | Fire Hydrant | 21 |
| 1020 | Emergency Services | 21 |
| 1021 | Civil Emergency Infrastructure | 21 |
| 1022 | Charging Stations | 12 |
| 1023 | Bicycle Charging Stations | 12 |
| 1024 | Bicycle Parking | 12 |
These are the categories the official templates use. Studio's POI Category field lists the categories the map engine offers.
## Fields you can filter on[](#fields-you-can-filter-on "Direct link to Fields you can filter on")
A layer's `filter` (the Data Filter tab in Studio) compares the fields below, which the map engine fills in for each kind of map data.
| Layer types | Fields |
| ------------------------------------- | --------------------------------------------------------------------------------- |
| `line` (roads), `street` (road names) | `Class`, `Lanes count`, `Country ISO Code`, `Name` |
| `linkarrows` (one-way arrows) | `Class`, `Country ISO Code`, `Name` |
| `symbol` (city labels) | `Name`, `Is Capital`, `Is Federal State`, `Is Region Capital`, `Country ISO code` |
| `polygon`, `polyline`, `areaname` | `Geometry Type` (`Line` or `Polygon`), `Name` |
| `buildings` | `Height` |
| Your own data (`"source": "overlay"`) | the features' own properties, and `Geometry Type` (`point`, `line` or `polygon`) |
* `Class` holds a road's flags: any of `Bridge`, `Construction`, `Oneway`, `Tollway`, `Tunnel` and `Roundabout`. Use `in`, for example `{ "key": "Class", "condition": "in", "values": ["Tunnel"] }`.
* `Is Capital` and the other "Is" fields hold `Yes` or `No`.
* `Lanes count` and `Height` are numbers. `>`, `<`, `>=` and `<=` compare whole numbers and work only on these two fields; on any other field, including every property of your own data, they let every feature through.
* Comparisons of text ignore upper and lower case, except `in` and `notin` on `Class`.
## Layers with no `sourcedata_id`[](#layers-with-no-sourcedata_id "Direct link to layers-with-no-sourcedata_id")
These layers draw what an app adds at run time, not map data, and carry `"isTemplate": 1`: routes (`route_car_primary` and the other `route_` types), route labels (`route_label_` types), the travelled route (`traveled_route_` types), `turn_arrow`, `route_traffic`, `route_waypoints`, `traffic_links`, `traffic_icons`, `highlighted_lmks`, `lmk_store`, `social_reports`, and the In-App Drawing types `draw_points`, `draw_poly`, `drawpath` and `paths`. Their properties are in the [layer types reference](/docs/guides/map-studio/reference/layer-types-reference.md).
## Your own data sources[](#your-own-data-sources "Direct link to Your own data sources")
A layer that draws one of your [data sources](/docs/guides/map-studio/data/data-sources.md) uses `"source": "overlay"` and the source's tileset id as its `sourcedata_id`. Once the source is tiled, the id is on the layer's JSON tab as `sourceDataId`. The layer's `type` is `symbol`, `symbol group`, `polyline` or `polygon`.
See also: [Style file format](/docs/guides/map-studio/reference/style-file-format.md) · [Layer types reference](/docs/guides/map-studio/reference/layer-types-reference.md)