Content

Service version: 1
Last edit: 2022.07.15

TomTom Vector Format

TomTom Vector tiles contain map features (points, lines, road shapes, water polygons, building footprints, etc.) that can be used to visualize map data. The data is divided into multiple protobuf layers. Besides the layers, the protobuf tags are also used to further describe the geographic features.

Vector tile property dependencies

Legend

Tile
Represents a vector tile as a whole entity. It consists of at least one TileLayer.
If the tile does not contain any relevant data, it contains one layer named empty.

TileLayer
Part of a Tile, representing one of the layers that can be rendered later. One layer consists of e.g., all Parks, Roads, Build up areas, or Points of interest.
Each TileLayer contains geometries of the same type. A geometry in the vector tile can be one of three types: POINT, LINESTRING, or POLYGON. Every TileLayer contains the following fields:
  • name
  • version
  • extent
It may also contain the following fields:
  • keys are an array of unique strings.
  • values are an array of unique TileValues.
  • features are an array of unique TileFeatures.
Arrays of keys and values contain the mapping for tags of TileFeature.
TileFeature
Member of an array of features stored in a TileLayer, containing a geometry representation that can be rendered.
It always contains the following fields:
  • type is a type of geometry. It can be point, linestring, or polygon.
  • geometry is an array of encoded geometry that can be used for rendering. See the Decoding tile geometry section for details.
It may also contain the following fields:
  • tags is an array containing properties of feature.
    • They are a TileFeature's detailed description which can be used for styling and later rendering the geometry.
    • They are encoded into an array of integers.
    • In order to decode them, the arrays of keys and values from a corresponding TileLayer must be used.
    • See the Decoding feature tags section for details.
TileValue
Encoded representation of a string, integer, floating point, or boolean value.
  • It is stored in a values array, in a TileLayer.
  • It is used for decoding tags of a TileFeature (together with the members of a keys array).
  • See the Decoding feature tags section for details.

TomTom Vector Schema

Schema data

Formally, the structure of vector tile is described by the protocol buffer schema. It allows the generation of C++, Java, Python, Go, Ruby, Objective-C, and C# code based on proto file.

Protocol buffer schema - Vector tile structure
1package vector_tile;
2
3option optimize_for = LITE_RUNTIME;
4
5message Tile {
6
7 enum GeomType {
8 UNKNOWN = 0;
9 POINT = 1;
10 LINESTRING = 2;
11 POLYGON = 3;
12 }
13
14 message Value {
15 optional string string_value = 1;
16 optional float float_value = 2;
17 optional double double_value = 3;
18 optional int64 int_value = 4;
19 optional uint64 uint_value = 5;
20 optional sint64 sint_value = 6;
21 optional bool bool_value = 7;
22 extensions 8 to max;
23 }
24
25 message Feature {
26 optional uint64 id = 1 [ default = 0 ];
27 repeated uint32 tags = 2 [ packed = true ];
28 optional GeomType type = 3 [ default = UNKNOWN ];
29 repeated uint32 geometry = 4 [ packed = true ];
30 optional bytes raster = 5;
31 }
32
33 message Layer {
34 required uint32 version = 15 [ default = 1 ];
35 required string name = 1;
36 repeated Feature features = 2;
37 repeated string keys = 3;
38 repeated Value values = 4;
39 optional uint32 extent = 5 [ default = 4096 ];
40
41 extensions 16 to max;
42 }
43
44 repeated Layer layers = 3;
45
46 extensions 16 to 8191;
47}

Decoding tile geometry

Vector Tile geometry uses the following coordinate system:

  • Coordinates are always integers.
  • The (0,0) point is located in the upper-left corner of the tile.
  • The X axis has values increasing towards the right of the tile.
  • The Y axis has values increasing towards the bottom of the tile.
  • The tile may have margin, which is a buffer around the tile in the shape of a square frame. The size of the margin is by default equal to 10% of the width/length of the tile.
  • The extent is equal to 4096, so the value range for X and Y coordinates is from 0 to 4095 for visible points.
  • If the tile has a margin, the coordinates values range is extended by its size in both directions. This may cause coordinate values for points in the left or upper margin to be negative.

Vector Tile geometry is encoded as an array of 32 bit unsigned integers in the geometry field of the TileFeature.

Encoded format has the following structure:

[command_and_count][x0][y0]..[xn][yn][command_and_count][x0][y0]..

  • command_and_count contains encoded values of command and count.
  • [x0][y0]..[xn][yn] are (x,y) coordinate pairs.

Command

The value of command is decoded as follows:

command = command_and_count & 0x7

Commands are to be executed relative to previous path coordinates or the point (0,0) if it is the first command.

Command typeValueCoordinatesDescription
MoveTo1x,yIt defines the (x,y) coordinate.
  • In the case of a POINT type geometry, the coordinate is a new point.
  • In the case of a LINESTRING or POLYGON type geometry, the coordinate is the start of a new shape.
LineTo2x,yIt defines a new segment, starting at the current position of the cursor and ending at the (x,y) coordinate.
  • In the case of a LINESTRING type geometry, the segment extends the current line.
  • In the case of a POLYGON type geometry, the segment extends the current linear ring.
ClosePath7noneIt closes the current linear ring of a POLYGON type geometry.

Count

The value of count is decoded as follows:

count = command_and_count >> 0x3

  • It defines the n number of [xn][yn] encoded coordinate pairs following the command_and_count value.
  • These coordinate pairs must be interpreted according to the preceding command type.

Coordinates

Coordinates [x0][y0]..[xn][yn] are encoded in zigzag encoding and are relative to the previous coordinate pair. This means that only the first coordinate pair [x0][y0] in the first command in every TileFeature stores absolute values.

The coordinates are decoded as follows:

Decoding coordinates
1decode(x0) = ((x0 >> 0x1) ^ (-(x0 & 0x1)))
2decode(y0) = ((y0 >> 0x1) ^ (-(y0 & 0x1)))
3
4decode(x1) = decode(x0) + ((x1 >> 0x1) ^ (-(x1 & 0x1)))
5decode(y1) = decode(y0) + ((y1 >> 0x1) ^ (-(y1 & 0x1)))
6
7...
8
9decode(xn) = decode(xn-1) + ((xn >> 0x1) ^ (-(xn & 0x1)))
10decode(yn) = decode(yn-1) + ((yn >> 0x1) ^ (-(yn & 0x1)))

Examples

For a POINT type feature

INPUT
1layer: 0
2 feature: 0
3 type: POINT
4 geometry: [9, 1136, 6564]
DECODING
1geometry:
2 command_and_count = 9
3 command = 9 & 0x7 = 1
4 count = 9 >> 0x3 = 1
5
6 x0 = 1136, y0 = 6564
7 decode(x0) = ((1136 >> 0x1) ^ (-(1136 & 0x1))) = 568
8 decode(y0) = ((6564 >> 0x1) ^ (-(6564 & 0x1))) = 3282
OUTPUT
1layer: 0
2 feature: 0
3 geometry: POINT(561, 3282)

For a LINESTRING type feature

INPUT
1layer: 0
2 feature: 0
3 type: LINESTRING
4 geometry: [9, 846, 2312, 10, 652, 1938]
DECODING
1geometry:
2 1:
3 command_and_count = 9
4 command = 9 & 0x7 = 1
5 count = 9 >> 0x3 = 1
6
7 x0 = 846, y0 = 2312
8 decode(x0) = ((846 >> 0x1) ^ (-(846 & 0x1))) = 423
9 decode(y0) = ((2312 >> 0x1) ^ (-(2312 & 0x1))) = 1156
10 2:
11 command_and_count = 10
12 command = 9 & 0x7 = 2
13 count = 9 >> 0x3 = 1
14
15 x0 = 652, y0 = 1938
16 decode(x0) = ((652 >> 0x1) ^ (-(652 & 0x1))) = 326
17 decode(y0) = ((1938 >> 0x1) ^ (-(1938 & 0x1))) = 969
OUTPUT
1layer: 0
2 feature: 0
3 geometry: LINESTRING[(423, 1156), (326, 969)]

For a POLYGON type feature

INPUT
1layer: 0
2 feature: 0
3 type: POLYGON
4 geometry: [9, 1320, 5622, 18, 1736, 4914, 68, 612, 483, 96, 7]
DECODING
1geometry:
2 1:
3 command_and_count = 9
4 command = 9 & 0x7 = 1
5 count = 9 >> 0x3 = 1
6
7 x0 = 1320, y0 = 5622
8 decode(x0) = ((1320 >> 0x1) ^ (-(1320 & 0x1))) = 660
9 decode(y0) = ((5622 >> 0x1) ^ (-(5622 & 0x1))) = 2811
10 2:
11 command_and_count = 26
12 command = 9 & 0x7 = 2
13 count = 9 >> 0x3 = 3
14
15 x0 = 1736, y0 = 4914
16 decode(x0) = ((1736 >> 0x1) ^ (-(1736 & 0x1))) = 868
17 decode(y0) = ((4914 >> 0x1) ^ (-(4914 & 0x1))) = 2457
18
19 x1 = 68, y1 = 612
20 decode(x1) = decode(x0) + ((68 >> 0x1) ^ (-(68 & 0x1))) = 902
21 decode(y1) = decode(y0) + ((612 >> 0x1) ^ (-(612 & 0x1))) = 2763
22
23 x2 = 483, y2 = 96
24 decode(x2) = decode(x1) + ((483 >> 0x1) ^ (-(483 & 0x1))) = 660
25 decode(y2) = decode(y1) + ((96 >> 0x1) ^ (-(96 & 0x1))) = 2811
26 3:
27 command_and_count = 7
28 command = 9 & 0x7 = 7
29 count = 9 >> 0x3 = 0
OUTPUT
1layer: 0
2 feature: 0
3 geometry: POLYGON[(660, 2811), (868, 2457), (902, 2763), (660, 2811)]

Decoding feature tags

In order to reduce tile size, the properties of each feature are encoded in a tags array. The tags array contains integer values which are indexes of keys and values arrays belonging to the corresponding layer. The size of a tags array is always even.

The content of a tags array can be grouped into a list of pairs. Each odd element of an array is the first element of a pair, and each even element of an array is the second element of a pair.

  • The first element of each pair should be mapped to a keys array.
  • The second element of each pair should be mapped to a values array.

As a result, we get a decoded list of tags where the first element is the tag name and the second element is the tag value in the form of TileValue.

Example

Below is an example of what an encoded tile may look like.

Example of an encoded tile
1layer: 0
2 keys: ["country_code", "icon_text"],
3 values: ["SWE", "E4"]
4 feature: 0
5 tags : [0,0,1,1]

After decoding it has to be read like this:

After decoding
1layer: 0
2 feature: 0
3 properties:
4 country_code : "SWE"
5 icon_text : "E4"

Tile Layers

The data in TomTom Vector Tiles is organized in layers that can be arranged into groups, consisting of layers that describe similar map features. The following section provides detailed information about:

  • All groups.
  • Layers that are contained in each group.
  • Tags that typically appear in features from a given group.

Landuse

The landuse layers include polygons that represent land use and land cover.

  • Group name: landuse
  • Geometry type: polygon

Landuse layers

Built-up areaNational or state parkCity parkWoodland
Regional parkNational parkState or province parkCounty park
CemeteryMoor or heathlandBeach or duneZoo
Industrial harbor areaIndustrial areaStadiumHospital
ShoppingAmusement parkUniversitySchool
GolfParking areaSports hallInstitution
AirportRunwayMilitarySand
ForestPedestrian DeckTown shoreTown garden path
Town swimming poolTown paved areaTown walkwayTown carriageway divider
Town factory groundTown school groundTown hospital groundTown railway ground
Town greensTown grassTown water bodyMeridian
SidewalkBreakwaterPoolPark

This layer group does not use any additional tags.

Earth Cover

The Earth Cover layers include polygons that represent the dominant physical cover of the earth's surface from a top-down perspective.

  • Group name: earth_cover
  • Geometry type: polygon

Earth Cover layer

Earth Cover - - -

Earth Cover tags

TagDescription
category
string
This tag provides a distinction between different types of earth cover.
Allowed values:
  • woody vegetation: Surfaces that have a dominant cover of vegetation which has a wooden structure above the ground.
  • herbaceous vegetation: Surfaces that have a dominant cover of permanent vegetation which do not have a wooden structure above the ground.
  • cropland: Surfaces that have a dominant cover of cropland vegetation. This will typically be herbaceous vegetation that is not permanently there.
  • sand: Surfaces that have a dominant cover of sand.
  • ice and snow: Surfaces which have a dominant and permanent cover of frozen water.

Water

The water layers include polygons that represent water bodies like ocean, seas, rivers, lakes, and other water bodies.

  • Group name: water
  • Geometry type: polygon
Water layers
Other waterIntermittent waterRiverLake
Sea 1Ocean 1Ocean or sea -
1 Layer for future use. Not supported yet.

This layer group does not use any additional tags.


Buildings

The building layers represent footprints of buildings.

  • Group name: buildings
  • Geometry type: polygon
Buildings layers
Subway StationFactory buildingPlace of worshipHospital building
School buildingHotel buildingCultural FacilityRailway Station
Government Administration OfficeOther buildingOther town block -
Buildings tags
TagDescription
height
float
The height of the building in meters.

Places

The places layers includes points that can be used for labeling places like countries, states, cities, towns, and villages.

  • Group name: places
  • Geometry type: point
Places layers
Capital cityLarge cityMedium citySmall city
TownVillageCountry nameState name
State name short - - -
Places tags
TagDescription
city_priority
integer
The tag value represents a priority of the city which is based on the combination of the population of the city and its administrative importance. The lower the value of this tag the more important the city is. Not applicable for layers: Country name, State name, or State name short.
state_capital
integer
The tag presence indicates that the point representing a city center is a state capital. The value of this tag is always 1. Not applicable for layers: Country name, State name, or State name short.
category
string
This tag provides a distinction between different types of settlements.
Allowed values:
  • neighborhood: A geographically localized area within a city or town with distinctive characteristics and considerable social interactions between inhabitants.
  • hamlet: A very small settlement or a small cluster of houses usually situated in a rural area.

POI

The POI group consists of layers that represent points of interest. Depending on the type of tile layer in a request, (see Tiles Layers and Styles different layers will be present in the protobuf tile.

  • Group name: poi
  • Geometry type: point
POI layers (basic, hybrid, and labels vector tiles)
Airport POIRailway stationNational park nameFerry terminal
POIPoint of Interest - -
POI layers (basic, hybrid, and labels vector tiles)
Point of Interest - - -
POI tags
TagDescription
name
string
A Point of Interest name in a language provided as a query parameter to the request. For more information about languages in the Map Display API, please see the list of supported languages.
brand
string
The tag value represents a brand name of a facility or accommodation.
id
string
A unique Point of Interest identifier that can be used across other TomTom services.
category
string
This tag groups Points of Interest into broad categories that can be used for styling purposes. Allowed values depend on the tile layer in a request. For values available in basic, hybrid, and labels vector tiles, see Point of Interest Categories: basic, hybrid, and labels vector tiles. For values available in POI vector tiles, see Point of Interest Categories: poi tiles .
subcategory
string
This tag narrows down the category values allowing fine grained styling and providing distinction between Points of Interest in the same category. Allowed values depend on the tile layer in a request. For values available in basic, hybrid, and labels vector tiles, see Point of Interest Categories: basic, hybrid, and labels vector tiles. For values available in POI vector tiles, see Point of Interest Categories: poi tiles.
category_id
integer
An identifier representing category. Either 4 digits integer for Points of Interest without subcategory or 7 digits integer for Points of Interest with subcategory (where the first 4 digits identify a category). It can be used across other TomTom services.
priority
integer
The tag value represents a priority of the Point of Interest. The lower the value of this tag the more important the Point of Interest is.
icon
string
The name of the icon asset in the TomTom styles that should be used for the visualization purpose of the Point of Interest.

Point of Interest Categories: basic, hybrid, and labels vector tiles

The Category ID and Subcategory ID in the following table correspond to the ID in poiCategories in the Search API.

Category IDCategoryPossible subcategoriesSubcategory ID
9383Industrial Building--
7377College/University--
7392Fire Station/Brigade--
7367Government Office--
9913Library--
9388Military Installation--
9389Native Reservation--
7322Police Station--
7324Post Office--
9154Prison/Correctional Facility--
7372School--
7321Hospital--
9902Amusement Park--
7317Museum--
9362Park & Recreation AreaNational Park
Cemetery
9362008
9362003
9927Zoo, Arboreta & Botanical Garden--
7373Shopping Center--
9911Golf Course--
7374Stadium--
7376Tourist Attraction--
7339Place of WorshipChurch
Mosque
Synagogue
Temple
Gurudwara
Ashram
Pagoda
7339002
7339003
7339004
7339005
7339006
7339007
7339008
7383Airport--
7352Ferry Terminal--
9942Public Transportation StopBus Stop
Taxi Stand
Coach Stop
Streetcar Stop
9942002
9942003
9942005
9942004
7380Railroad StationInternational Railroad Station
National Railroad Station
Subway Station
738002
738003
738005
8099Geographic FeatureMountain Peak
Ridge
Valley
Reef
Hill
8099002
8099004
8099006
8099014
8099025

Point of Interest Categories: poi vector tiles

The Category ID and Subcategory ID in the following table correspond to the ID in poiCategories in the Search API.

Category IDCategoryPossible subcategoriesSubcategory ID
9910Automotive Dealer--
9155Car Wash--
7309Electric Vehicle Station--
7368Motoring Organization Office--
7369Open Parking Area--
7313Parking Garage--
7311Gas Station--
7312Rent-a-Car Facility--
9930Rent-a-Car-Parking--
7310Repair Facility--
7395Rest Area--
7375Toll Gate--
7358Truck Stop--
7359Weigh Station--
7335Agriculture Business--
7328Bank--
7378Business Park--
7397ATM--
9382Commercial Building--
9352Company--
7388Courier Drop Box--
7391Emergency Medical Service--
9160Exchange--
9377Exhibition & Convention Center--
9383Industrial Building--
9156Manufacturing Facility--
9158Media Facility--
9157Research Facility--
9376Café/PubCafé
Pub
Internet Café
Tea House
Coffee Shop
Microbrewery
9376002
9376003
9376004
9376005
9376006
9376007
7315Restaurant--
7377College/University--
9363Courthouse--
7365Embassy--
7392Fire Station/Brigade--
7367Government Office--
9913Library--
9388Military Installation--
9389Native Reservation--
9152Non Governmental Organization--
7322Police Station--
7324Post Office--
9150Primary Resource/Utility--
9154Prison/Correctional Facility--
9932Public Amenity--
7372School--
7301Traffic Service Center--
9151Transport Authority/Vehicle Registration--
9153Welfare Organization--
9374Dentist--
9373Doctor--
9956Emergency Room--
9663Health Care Service--
7321Hospital--
7326Pharmacy--
9375Veterinarian--
9902Amusement Park--
7341Casino--
7342Movie Theater--
9937Club & Association--
7363Community Center--
7319Cultural Center--
9900Entertainment--
9378Leisure Center--
7347Marina--
7317Museum--
9379Nightlife--
9362Park & Recreation AreaNational Park
Cemetery
9362008
9362003
7318Theater--
7302Trail System--
7349Winery--
9927Zoo, Arboreta & Botanical Garden--
7360Camping Ground--
7304Vacation Rental--
7314Hotel/Motel--
7303Residential Accommodations--
7327Department Store--
7332Market--
9361Shop--
7373Shopping Center--
9911Golf Course--
9360Ice Skating Rink--
7320Sports Center--
7374Stadium--
7338Swimming Pool--
9369Tennis Court--
9371Water Sport--
7305Adventure Sports Venue--
9357Beach--
7376Tourist Attraction--
7339Place of WorshipChurch
Mosque
Synagogue
Temple
Gurudwara
Ashram
Pagoda
7339002
7339003
7339004
7339005
7339006
7339007
7339008
7337Scenic/Panoramic View--
7316Tourist Information Office--
7389Access Gateway--
7383Airport--
9955Checkpoint--
7352Ferry Terminal--
7366Frontier Crossing--
7308Helipad--
9935Mountain Pass--
9159Port/Warehouse Facility--
9942Public Transportation StopBus Stop
Taxi Stand
Coach Stop
Streetcar Stop
9942002
9942003
9942005
9942004
7380Railroad StationInternational Railroad Station
National Railroad Station
Subway Station
738002
738003
738005
8099Geographic FeatureMountain Peak
Cave
Ridge
Dune
Valley
Plain/Flat
Plateau
Pan
Well
Oasis
Rocks
Reservoir
Reef
Rapids
Bay
Cove
Harbor
Lagoon
Cape
Mineral/Hot Springs
Island
Marsh
River Crossing
Hill
Quarry
Locale
8099002
8099003
8099004
8099005
8099006
8099007
8099008
8099009
8099010
8099011
8099012
8099013
8099014
8099015
8099016
8099017
8099018
8099019
8099020
8099021
8099022
8099023
8099024
8099025
8099026
8099027

Cartolabels

The cartolabels layers include points that represent cartographic labels. Please note that most of the layers in this group are being replaced by Points of Interest with equivalent categories.

  • Group name: cartolabels
  • Geometry type: point
Cartolabels layers
Airport labelAmusement area labelCemetery labelPark/Garden label
Stadium labelMilitary Territory labelGolf Course labelHospital label
Industrial area labelOther water body labelWoodland labelPrison label
University/School labelIntermittent water labelIsland labelLake label
Zoo labelReservation labelShopping centre labelLandmark label
River labelOcean labelSea labelNational park label
Other labelMuseum label - -
Cartolabels tags
TagDescription
name
string
Label name in a language provided as a query parameter to the request. For more information about languages in the Map Display API, please see the list of supported languages.
Cartolabels layers
Airport labelAmusement area labelCemetery labelPark/Garden label
Stadium labelMilitary Territory labelGolf Course labelHospital label
Industrial area labelOther water body labelWoodland labelPrison label
University/School labelIntermittent water labelIsland labelLake label
Zoo labelReservation labelShopping centre labelLandmark label
River labelOcean labelSea labelNational park label
Other labelMuseum label - -
Cartolabels tags
TagDescription
name
string
Label name in a language provided as a query parameter to the request. For more information about languages in the Map Display API, please see the list of supported languages.

Roads

The roads layers include lines that can be used for drawing roads.

  • Group name: cartolabels
  • Geometry type: line
Roads layers
MotorwayInternational roadMajor roadSecondary road
Connecting roadMajor local roadLocal roadMinor local road
Motorway tunnelInternational road tunnelMajor road tunnelSecondary road tunnel
Connecting road tunnelMajor local road tunnelLocal road tunnelMinor local road tunnel
Toll motorwayToll international roadToll major roadToll secondary road
Toll connecting roadToll major local roadToll local roadToll minor local road
Toll motorway tunnelToll international road tunnelToll major road tunnelToll secondary road tunnel
Toll connecting road tunnelToll major local road tunnelToll local road tunnelToll minor local road tunnel
Ferry roadPedestrian roadNon public roadWalkway road

Each road may have one or more road shields. The shields are indexed from 0, and described by sets of tags.

Roads tags
TagDescription
name
string
Label name in a language provided as a query parameter to the request. For more information about languages in the Map Display API, please see the list of supported languages.
icon
string
Icon id used in older styles. Currently replaced by the shield_icon_{idx} tag.
shield_icon_{idx}
string
The name of the road shield icon associated with the road.
Value: For easier referencing and implementation, the name of a roadshield follows one of two formats:
  • shapeType-fillColor-strokeColor-numOfChars: for shields to be reused by many countries.
  • countryName-stateCode-shieldType-numOfChars: for country or region specific shields.
See the Shield icon shape types section for existing shape types.
See the Shield icon fill and stroke colors section for existing shield colors.
See the Shield icon countries and states section for details on country names and state codes.
numOfChars is a number in the range 1-7.
shieldType is a unique shield ID.
icon_text_{idx}
string
Text to be placed on the road shield icon with the corresponding shield_icon idx.
Value: road number
shield_icon_text_color_{idx}
string
The color of the text on the road shield icon with the corresponding shield_icon idx.
Value: hexadecimal color code
shield_icon_text_color_night_{idx}
string
The color of the text on the road shield icon in night mode with the corresponding shield_icon idx.
Value: hexadecimal color code
under_construction
boolean
The tag presence indicates that the road is under construction. The value of this tag is always true.
direction
integer
The tag presence indicates that the road is a one way road. The value of this tag is -1 for a traffic along geometry and 1 for a traffic against geometry.
Note: This tag is currently sent from zoom level 15 inclusive up to zoom level 22.
country_code
string
A 3 character ISO code of a country to which a given road belongs.
country_subdivison
string
The value of the tag indicates a portion of a country or other region delineated for the purpose of administration such as State, District, Region, or Province Codes.
z_level
integer
The integer value used to determine the drawing order of overlapping road segments. The values are in the range -3, 3 inclusive.
Note: This tag is currently sent from zoom level 13 inclusive up to zoom level 22.

Shield icon shape types

rectanglehexagonhexagon2octagonspecial01special02special03special04
shield01shield02shield03shield04shield05shield06shield07shield08
shield09shield10shield11shield12pentagoncirclepillus1
us2us3ovaldiamond    

Shield icon fill and stroke colors

whiteyellow1yellow2yellow3orangegreen1green2green3blue1
blue2blue3brown1brown2redgreyanthraciteblack 

Shield icon countries and states

Possible values of the countryName part of a name are listed in the following table.

  • For Canada shields, the stateCode part of the shield's name is either a two-letter province name abbreviation or empty.
  • For USA shields, the stateCode may be a two-letter ISO-3166 state name abbreviation, highway, county, or empty.
  • For other country shields the stateCode is empty.
colombiasouthmexicoindonesiataiwancanadausavenezuelasouthafrica
cubaindiaaustraliaargentinasaudiarabiauaeperukorea 

Transit

The transit layers include lines that can be used to draw transit lines.

  • Group name: transit
  • Geometry type: line
Transit layers
Railway - - -

This layer group does not use any additional tags.

Boundaries

The boundaries layers include lines that can be used to draw different types of boundaries.

  • Group name: boundaries
  • Geometry type: line
Boundaries layers
Country borderDisputed country borderTreaty country borderState border

This layer group does not use any additional tags.