---
title: "MapTiler Grid | Schema"
description: "Tileset contains graticule (parallels and meridians) and timezone layers"
---

> For AI agents: a documentation index is available at [/llms.txt](https://docs.maptiler.com/llms.txt). Markdown versions of all pages are available by appending .md to any URL.

# MapTiler Grid schema

The vector tile schema describes how the vector data is organized into different thematic layers and which attribute and values each layer contains. This is useful for writing a map style.

MapTiler Grid is a vector tileset providing global spatial reference layers, including international timezones, UTC offset boundaries, and a standardized WGS84 graticule.

Explore the tileset in the interactive map viewer, check the date of the last update, use it as vector tiles, etc.

[Go to MapTiler Grid](https://cloud.maptiler.com/tiles/grid/)

## Maps with this tileset

[![Ocean map](https://cloud.maptiler.com/static/img/maps/ocean-v4.png)

Ocean

](https://cloud.maptiler.com/maps/ocean-v4/)[![Ocean Dark map](https://cloud.maptiler.com/static/img/maps/ocean-v4-dark.png)

Ocean Dark

](https://cloud.maptiler.com/maps/ocean-v4-dark/)

## Definition of layers

The MapTiler Grid tileset contains the following layers:

## dateline [#](#dateline)

Layer containing an established navigation boundary located near 180° longitude that serves as the globally recognized demarcation for the transition between calendar days.

### Fields

#### name

Name of the dateline.

Value:

-   `International Date Line`

#### name:{code}

Localized name of the International Date Line in a specific language.

`{code}` represents [ISO 639 language code](#languages).

### Min zoom:

`0`

### Max zoom:

`14` (possible overzooming up to `22`)

### Unique id

`True`

## grid\_wgs\_84 [#](#grid_wgs_84)

Layer containing geographic lines - meridians and parallels - with 1 degree step, major circles of latitudes and prime meridians.

### Fields

#### class

Classification category to distinguish between meridians and parallels.

Values:

-   `meridian`
-   `parallel`

#### degree

Value of latitude (for parallels) or longitude (for meridians).

Min/max values:

-   `-180`
-   `180`

#### latitude

Classification category to distinguish between northern and southern hemisphere.

Values:

-   `North`
-   `South`

#### longitude

Classification category to distinguish between western and eastern hemisphere.

Values:

-   `West`
-   `East`

#### name

Name of major circles of latitudes or prime meridians.

Values:

-   `Antarctic Circle`
-   `Arctic Circle`
-   `Athens`
-   `Bern`
-   `Bogota`
-   `Brussels`
-   `Copenhagen`
-   `Equator`
-   `Ferro`
-   `Greenwich`
-   `Jakarta`
-   `Lisbon`
-   `Madrid`
-   `Oslo`
-   `Paris`
-   `Rome`
-   `Stockholm`
-   `Tropic of Cancer`
-   `Tropic of Capricorn`

#### name:{code}

Localized name of the major circles of latitudes or prime meridians in a specific language.

`{code}` represents [ISO 639 language code](#languages).

#### nth\_line

Specifies the order of a geographic line.

Values:

-   `1`
-   `5`
-   `15`
-   `30`

### Min zoom:

`0`

### Max zoom:

`14` (possible overzooming up to `22`)

### Unique id

`True`

## timezone [#](#timezone)

Layer containing timezone boundaries as polygons based on IANA timezone database.

## Fields

### abbr\_sdt

Timezone abbreviation during standard time.

Values:

-   `ACST`
-   `AEST`
-   `AKST`
-   `AST`
-   `AWST`
-   `CAT`
-   `CET`
-   `CST`
-   `ChST`
-   `EAT`
-   `EET`
-   `EST`
-   `GMT`
-   `HKT`
-   `HST`
-   `IST`
-   `JST`
-   `KST`
-   `MSK`
-   `MST`
-   `NST`
-   `NZST`
-   `PKT`
-   `PST`
-   `SAST`
-   `SST`
-   `UTC`
-   `WAT`
-   `WET`
-   `WIB`
-   `WIT`
-   `WITA`

### abbr\_dst

Timezone abbreviation during daylight saving time.

Values:

-   `ACDT`
-   `ADT`
-   `AEDT`
-   `AKDT`
-   `BST`
-   `CDT`
-   `CEST`
-   `EDT`
-   `EEST`
-   `HDT`
-   `IDT`
-   `IST`
-   `MDT`
-   `NDT`
-   `NZDT`
-   `PDT`
-   `WEST`

### tz\_id

Unique IANA timezone identifier.

Examples:

-   `America/New_York`
-   `Europe/London`

### utc\_offset\_sdt

UTC offset in hours during standard time.

Values:

-   `-12`
-   `-11`
-   `-10`
-   `-9.5`
-   `-9`
-   `-8`
-   `-7`
-   `-6`
-   `-5`
-   `-4`
-   `-3`
-   `-2.5`
-   `-2`
-   `-1`
-   `0`
-   `+1`
-   `+2`
-   `+3`
-   `+3.5`
-   `+4`
-   `+4.5`
-   `+5`
-   `+5.5`
-   `+5.75`
-   `+6`
-   `+6.5`
-   `+7`
-   `+8`
-   `+8.75`
-   `+9`
-   `+9.5`
-   `+10`
-   `+10.5`
-   `+11`
-   `+12`
-   `+13`
-   `+13.75`
-   `+14`

### utc\_offset\_dst

UTC offset in hours during daylight saving time.

Values:

-   `-12`
-   `-11`
-   `-10`
-   `-9.5`
-   `-9`
-   `-8`
-   `-7`
-   `-6`
-   `-5`
-   `-4`
-   `-3.5`
-   `-3`
-   `-2`
-   `-1`
-   `0`
-   `+1`
-   `+2`
-   `+3`
-   `+3.5`
-   `+4`
-   `+4.5`
-   `+5`
-   `+5.5`
-   `+5.75`
-   `+6`
-   `+6.5`
-   `+7`
-   `+8`
-   `+8.75`
-   `+9`
-   `+9.5`
-   `+10`
-   `+10.5`
-   `+11`
-   `+12`
-   `+12.75`
-   `+13`
-   `+14`

### Min zoom:

`0`

### Max zoom:

`14` (possible overzooming up to `22`)

### Unique id

`True`

## timezone\_label [#](#timezone_label)

Layer containing label points for timezone zones, suitable for placing timezone name labels on a map.

## Fields

### abbr\_sdt

Timezone abbreviation during standard time.

Values:

-   `ACST`
-   `AEST`
-   `AKST`
-   `AST`
-   `AWST`
-   `CAT`
-   `CET`
-   `CST`
-   `ChST`
-   `EAT`
-   `EET`
-   `EST`
-   `GMT`
-   `HKT`
-   `HST`
-   `IST`
-   `JST`
-   `KST`
-   `MSK`
-   `MST`
-   `NST`
-   `NZST`
-   `PKT`
-   `PST`
-   `SAST`
-   `SST`
-   `UTC`
-   `WAT`
-   `WET`
-   `WIB`
-   `WIT`
-   `WITA`

### abbr\_dst

Timezone abbreviation during daylight saving time.

Values:

-   `ACDT`
-   `ADT`
-   `AEDT`
-   `AKDT`
-   `BST`
-   `CDT`
-   `CEST`
-   `EDT`
-   `EEST`
-   `HDT`
-   `IDT`
-   `IST`
-   `MDT`
-   `NDT`
-   `NZDT`
-   `PDT`
-   `WEST`

### tz\_id

Unique IANA timezone identifier.

Examples:

-   `America/New_York`
-   `Europe/London`

### utc\_offset\_sdt

UTC offset in hours during standard time.

Values:

-   `-12`
-   `-11`
-   `-10`
-   `-9.5`
-   `-9`
-   `-8`
-   `-7`
-   `-6`
-   `-5`
-   `-4`
-   `-3`
-   `-2.5`
-   `-2`
-   `-1`
-   `0`
-   `+1`
-   `+2`
-   `+3`
-   `+3.5`
-   `+4`
-   `+4.5`
-   `+5`
-   `+5.5`
-   `+5.75`
-   `+6`
-   `+6.5`
-   `+7`
-   `+8`
-   `+8.75`
-   `+9`
-   `+9.5`
-   `+10`
-   `+10.5`
-   `+11`
-   `+12`
-   `+13`
-   `+13.75`
-   `+14`

### utc\_offset\_dst

UTC offset in hours during daylight saving time.

Values:

-   `-12`
-   `-11`
-   `-10`
-   `-9.5`
-   `-9`
-   `-8`
-   `-7`
-   `-6`
-   `-5`
-   `-4`
-   `-3.5`
-   `-3`
-   `-2`
-   `-1`
-   `0`
-   `+1`
-   `+2`
-   `+3`
-   `+3.5`
-   `+4`
-   `+4.5`
-   `+5`
-   `+5.5`
-   `+5.75`
-   `+6`
-   `+6.5`
-   `+7`
-   `+8`
-   `+8.75`
-   `+9`
-   `+9.5`
-   `+10`
-   `+10.5`
-   `+11`
-   `+12`
-   `+12.75`
-   `+13`
-   `+14`

### Min zoom:

`0`

### Max zoom:

`14` (possible overzooming up to `22`)

### Unique id

`True`

## utc\_offset\_zone\_dst [#](#utc_offset_zone_dst)

Layer containing polygons of UTC timezones based on daylight saving time offset.

## Fields

### utc\_offset

UTC offset in hours.

Values:

-   `-12`
-   `-11`
-   `-10`
-   `-9.5`
-   `-9`
-   `-8`
-   `-7`
-   `-6`
-   `-5`
-   `-4`
-   `-3`
-   `-2.5`
-   `-2`
-   `-1`
-   `0`
-   `+1`
-   `+2`
-   `+3`
-   `+3.5`
-   `+4`
-   `+4.5`
-   `+5`
-   `+5.5`
-   `+5.75`
-   `+6`
-   `+6.5`
-   `+7`
-   `+8`
-   `+8.75`
-   `+9`
-   `+9.5`
-   `+10`
-   `+10.5`
-   `+11`
-   `+12`
-   `+13`
-   `+13.75`
-   `+14`

### Min zoom:

`0`

### Max zoom:

`14` (possible overzooming up to `22`)

### Unique id

`True`

## utc\_offset\_zone\_label [#](#utc_offset_zone_label)

Layer containing polygons of UTC timezones based on standard time offset.

## Fields

### order

Order of the points for given zone from south to north.

Values:

-   `0`
-   `1`
-   `2`
-   `3`
-   `4`
-   `5`
-   `6`
-   `7`
-   `8`
-   `9`
-   `10`
-   `11`
-   `12`
-   `13`
-   `14`
-   `15`
-   `16`
-   `17`
-   `18`
-   `19`
-   `20`
-   `21`
-   `22`

### utc\_offset\_dst

UTC offset in hours for daylight saving time.

Values:

-   `-12`
-   `-11`
-   `-10`
-   `-9.5`
-   `-9`
-   `-8`
-   `-7`
-   `-6`
-   `-5`
-   `-4`
-   `-3`
-   `-2.5`
-   `-2`
-   `-1`
-   `0`
-   `+1`
-   `+2`
-   `+3`
-   `+3.5`
-   `+4`
-   `+4.5`
-   `+5`
-   `+5.5`
-   `+5.75`
-   `+6`
-   `+6.5`
-   `+7`
-   `+8`
-   `+8.75`
-   `+9`
-   `+9.5`
-   `+10`
-   `+10.5`
-   `+11`
-   `+12`
-   `+13`
-   `+13.75`
-   `+14`

### utc\_offset\_sdt

UTC offset in hours for standard time.

Values:

-   `-12`
-   `-11`
-   `-10`
-   `-9.5`
-   `-9`
-   `-8`
-   `-7`
-   `-6`
-   `-5`
-   `-4`
-   `-3.5`
-   `-3`
-   `-2`
-   `-1`
-   `0`
-   `+1`
-   `+2`
-   `+3`
-   `+3.5`
-   `+4`
-   `+4.5`
-   `+5`
-   `+5.5`
-   `+5.75`
-   `+6`
-   `+6.5`
-   `+7`
-   `+8`
-   `+8.75`
-   `+9`
-   `+9.5`
-   `+10`
-   `+10.5`
-   `+11`
-   `+12`
-   `+12.75`
-   `+13`
-   `+14`

### Min zoom:

`0`

### Max zoom:

`14` (possible overzooming up to `22`)

### Unique id

`True`

## utc\_offset\_zone\_sdt [#](#utc_offset_zone_sdt)

Layer containing polygons of UTC timezones based on standard time offset.

## Fields

### utc\_offset

UTC offset in hours.

Values:

-   `-12`
-   `-11`
-   `-10`
-   `-9.5`
-   `-9`
-   `-8`
-   `-7`
-   `-6`
-   `-5`
-   `-4`
-   `-3.5`
-   `-3`
-   `-2`
-   `-1`
-   `0`
-   `+1`
-   `+2`
-   `+3`
-   `+3.5`
-   `+4`
-   `+4.5`
-   `+5`
-   `+5.5`
-   `+5.75`
-   `+6`
-   `+6.5`
-   `+7`
-   `+8`
-   `+8.75`
-   `+9`
-   `+9.5`
-   `+10`
-   `+10.5`
-   `+11`
-   `+12`
-   `+12.75`
-   `+13`
-   `+14`

### Min zoom:

`0`

### Max zoom:

`14` (possible overzooming up to `22`)

### Unique id

`True`

## languages [#](#languages)

List of possible languages available in MapTiler Grid.

Read more in the article about [Change language in a map](https://docs.maptiler.com/guides/map-design/change-language-in-a-map).

### Fields

#### name:{code}

Localized name of the feature in a specific language.

`{code}` represents ISO 639 language code.

Values:

-   `am` (Amharic)
-   `ar` (Arabic)
-   `az` (Azerbaijani)
-   `be` (Belorussian)
-   `bg` (Bulgarian)
-   `bn` (Bengali)
-   `br` (Breton)
-   `bs` (Bosnian)
-   `ca` (Catalan)
-   `co` (Corsican)
-   `cs` (Czech)
-   `cy` (Welsh)
-   `da` (Danish)
-   `de` (German)
-   `el` (Greek)
-   `en` (English)
-   `eo` (Esperanto)
-   `es` (Spanish)
-   `et` (Estonian)
-   `eu` (Basque)
-   `fa` (Persian)
-   `fi` (Finnish)
-   `fr` (French)
-   `fy` (Western Frisian)
-   `ga` (Irish)
-   `gd` (Scottish Gaelic)
-   `he` (Hebrew)
-   `hi` (Hindi)
-   `hr` (Croatian)
-   `hu` (Hungarian)
-   `hy` (Armenian)
-   `id` (Indonesian)
-   `is` (Icelandic)
-   `it` (Italian)
-   `ja` (Japanese)
-   `ja_kana` (Japanese Kana form)
-   `ja_rm` (romanization of Japanese)
-   `ja-Latn` (romanisation of Japanese since 2018)
-   `ja-Hira` (Japanese Hiragana form)
-   `ka` (Georgian)
-   `kk` (Kazakh)
-   `kn` (Kannada)
-   `ko` (Korean)
-   `ko-Latn` (romanization of Korean)
-   `ku` (Kurdish)
-   `la` (Latin)
-   `lb` (Luxembourgish)
-   `lt` (Lithuanian)
-   `lv` (Latvian)
-   `mk` (Macedonian)
-   `mt` (Maltese)
-   `ml` (Malayalam)
-   `nb` (Norwegian Bokmål)
-   `nl` (Dutch)
-   `nn` (Norwegian Nynorsk)
-   `no` (Norwegian)
-   `oc` (Occitan (post 1500))
-   `pa` (Punjabi)
-   `pnb` (Western Punjabi)
-   `pl` (Polish)
-   `pt` (Portuguese)
-   `rm` (Romansh)
-   `ro` (Romania)
-   `ru` (Russian)
-   `sk` (Slovak)
-   `sl` (Slovene)
-   `sq` (Albanian)
-   `sr` (Serbian, Cyrillic)
-   `sr-Latn` (Serbian)
-   `sv` (Swedish)
-   `ta` (Tamil)
-   `te` (Telugu)
-   `th` (Thai)
-   `tr` (Turkish)
-   `uk` (Ukrainian)
-   `ur` (Urdu)
-   `vi` (Vietnamese)
-   `zh` (Chinese)
-   `zh-Hant` (Traditional Chinese)
-   `zh-Hans` (Simplified Chinese)

## License

With the use of this API, you must visibly credit these attributions:

[© MapTiler](https://www.maptiler.com/copyright/) [© OpenStreetMap contributors](https://www.openstreetmap.org/copyright)
