Skip to main content

Changelog

v4.6​

Q1 2026

Highlights​

  • Worldview updates for Türkiye, Argentina, Chile (New)
  • 52,804 boundaries added and 10,566 boundaries updated in 40 countries covering North and South Americas, Asia and Europe
  • Refresh of all US data layers with latest data. Full statistical coverage expanded to US external territories: American Samoa, Guam, Northern Mariana Islands, Puerto Rico, US Virgin Islands
  • Refresh of all Canada data layers with latest data. Introduce Canada locality-2 and locality-3 layers with 20,810 place boundaries.
  • Reorganization of Vietnam admin-1 and admin-2 per 2025 Vietnamese administrative reform
  • Expansion of high resolution postcode boundary coverage in Mexico, Brazil and Russia

Breaking Changes

  • CA-stats: Reorganized all levels as per latest StatCan in Canada
  • US-admin: Replacement of US-admin-2 counties for Connecticut with planning regions
  • US-stats: Reorganized all levels to be in sync with the latest US Census
  • US-legislative: Reorganization of Congressional Districts and State House Districts as per the latest US Census
  • US-locality: Reorganization of rural areas in US-locality-4, promotion of CDP in US-locality-4 to US-locality-3
  • VN-admin: Partial reorganization of VN-admin-1, complete reorganization of VN-admin-2, removal of VN-admin-3 district level which has been abolished in Vietnam
  • BR-postal-4: Replace postcode districts 83-87 with full 5-digit postcode boundaries in Brazil
  • MX-postal-4: Replace postcode districts 45-49, 68-71 & 91-96 with full 5-digit postcode boundaries in Brazil
  • RU-postal-4: Replace postcode district 39 with full 5-digit postcode boundaries in Russia

Corrections

  • AF-admin-1: Fix whitespace in name
  • BR-stats-3: Fix em-dash in names in Brazil
  • HT-admin: Fix names in Haiti across all levels
  • NP-admin-1: Fix whitespace in name
  • PE-admin-3: Fix capitalization of names in Peru
  • PL-admin-4: Fix description for cities in Poland
  • US-admin-2: Removed 'city' suffix from cities in Virginia except for cities requiring disambiguation

Boundary changes​

v4.5​

Q1 2025

Highlights​

  • Worldview updates for Türkiye and Argentina
  • 107,816 boundaries added and 56,911 boundaries updated in 44 countries covering Europe
  • Added over 70,000 postcode boundaries in the UK
  • Added over 2,000 postcode boundaries in the Netherlands
  • Added over 30,000 muhalle neighborhood boundaries in Türkiye
  • Complete refresh of Ireland Local Administrative Units with latest data
  • Complete refresh of Norway Local Administrative Units with latest data

Corrections

  • Fix Han River Boundary line in Republic of Korea to match official maps
  • Fix names for India postcodes
  • Fix descriptions for Vietnam towns

Boundary changes​

v4.4​

Q2 2024

Highlights​

  • Data refresh of all countries in Asia region with latest changes
  • Additional updates to Norway to match 2024 county changes
  • Expanded coverage of 5-digit postcodes in Brazil
  • Updated coastline details for Taiwan, Hong Kong, Macau, Singapore, UAE, Baharain, Qatar, Sri Lanka, Maldives
  • Türkiye worldview: Türkiye boundary updated to match Turkish Government regulations
  • China worldview: Addition of postal boundaries for Hong Kong and Macao
  • Thailand: Update name labels from English to Thai
  • Uzbekistan: Update name labels from Russian to Uzbek

Corrections

  • Fixes missing NUTS 2021 statistical boundaries for Belgium, Croatia, Estonia, Italy, Serbia, United Kingdom and French overseas territories
  • Fixes outdated ISO 3166-2 subdivision codes for Latvia based on 2021 administrative reform
  • Fixes missing English labels for Azerbaijan
  • Fixes incorrect names for Kuwait districts
  • Fixes name stemming for Armenia provinces
  • Fixes names for Bangladesh unions
  • Fixes names for Bhutan blocks
  • Fixes names for Indonesia villages and postcodes

Boundary changes​

v4.3​

Q4 2023

Highlights​

  • Data refresh of Africa and Oceania regions with latest administrative, postal, statistical and legislative changes
  • Additional updates to Philippines, South Korea and Japan based on latest changes

Boundary changes​

  • Algeria:
    • 10 new provinces (admin-1)
    • 37 new communes (admin-2)
    • 10 new 2-digit postcode area (postal-3)
  • Australia
    • 11,000 new statistical areas (stats-2/3/4/5)
    • 8 new 4-digit postcode areas (postal-4)
    • Update admin codes to match official local government area codes
  • Democratic Republic of the Congo: 13 new cities (admin-2)
  • Egypt: 1 new region (admin-2)
  • Ethiopia:
    • 2 new regions, 6 special districts and 12 zones (admin-2)
    • Reorganized districts and towns (admin-3)
  • Ghana: 25 new municipal districts and 19 districts (admin-2)
  • Japan: Update Hamamatsu ward boundary changes
  • Kenya: 3 new sub-counties (admin-2)
  • Mali: 1 new region (admin-1)
  • Marshall Islands: 9 new municipalities (admin-1)
  • Mauritania: 2 new departments (admin-2)
  • Mozambique: 6 new municipal districts (admin-2)
  • New Zealand
    • 24 new rural settlements (stats-1)
    • 12,000 new statistical areas (stats-2/3/4/5)
    • 18 new wards (admin-3)
    • 2 new 4-digit postcode areas (postal-4)
  • Northern Mariana Islands: Move block groups from stats-4 to stats-5
  • Philippines:
  • Add 33 highly urbanized cities to the same level as province (admin-2)
  • Replace City of Manila with 14 city districts (admin-3)
  • Updated all admin features and codes to match official Philippine Standard Geographic Code (PSGC) list
  • South Korea: Update Daegu City boundary changes
  • Solomon Islands: 1 new capital territory (admin-1)
  • Sudan: 1 new special administrative area (admin-1) and 18 new districts (admin-2)
  • Somalia: 1 new region (admin-1)
  • South Africa: 131 new 4-digit postcode areas (postal-4)
  • South Sudan: 2 new administrative areas (admin-1)
  • Togo: 3 new prefectures (admin-2)
  • Uganda: 1 new county (admin-2)
  • Zambia: 43 new districts (admin-2) and 1 constituency (legislative-1)

New layers​

Africa

  • British Indian Ocean Territory: postcode unit (postal-4)
  • Burkina Faso: departments (admin-3)
  • Central African Republic: communes (admin-3)
  • Republic of the Congo: districts and communes (admin-2)
  • Ivory Coast: sub-prefectures (admin-4)
  • Lesotho: community council (admin-2), 3-digit postcode areas (postal-4)
  • Madagascar: communes (admin-3)
  • Mauritius: 3-digit postcode areas (postal-3)
  • Namibia: constituencies (admin-2)
  • Niger: 1-digit postcode areas (postal-3)
  • Mali: communes (admin-3)
  • Malawi: traditional authorities (admin-3), 6-digit postcode areas (postal-4)
  • Rwanda: cells (admin-4)
  • Senegal: arrondissements (admin-3)
  • Sierra Leone: chiefdom (admin-3)
  • Tanzania: wards (admin-3)
  • Uganda: 3-digit postcode areas (postal-3), regions (stats-1)

Oceania

  • Fiji: tikinas (admin-3)
  • Federated States of Micronesia: municipalities (admin-2), 5-digit postcode area (postal-4)
  • Heard Island and McDonald Islands: 2-digit postcode area (postal-3), 4-digit postcode area (postal-4)
  • Kiribati: groups (stats-1), divisions (stats-2), islands (stats-3)
  • Niue: villages (admin-2)
  • Northern Mariana Islands: 5-digit postcode areas (postal-4)
  • Palau: hamlets (admin-2)
  • Pitcairn: postcode unit (postal-4)
  • Samoa: villages (admin-2), 4-digit postcode area (postal-4)
  • Solomon Islands: wards (admin-2)
  • Saint Helena, Ascension and Tristan da Cunha: divisions (admin-2), districts and islands (admin-3), postcode unit (postal-4)
  • Tonga: districts (admin-2) and villages (admin-3)
  • Vanuatu: councils (admin-2)
  • Wallis and Futuna: districts (admin-2), 5-digit postcode areas (postal-4)

Others

  • Saint Pierre and Miquelon: 5-digit postcode area (postal-4)

v4.2​

Q2 2023

Highlights​

  • Data refresh of entire Europe region with latest administrative, postal, statistical and legislative changes up to 2022
  • Addition of Serbia worldview

Boundary changes​

  • EU region statistical boundaries updated from NUTS 2016 to NUTS 2021 classification
  • Ireland: Local electoral areas (stats-4 & legislative-4) reorganized to reflect latest 2019 election boundaries
  • Latvia: Administrative restructuring of admin-1 per 2021 territorial reform from 119 counties to 43 counties
  • Netherlands: Municipality (admin-2) boundaries updated
  • Serbia:
  • Update name field from Serbian-Latin to Serbian-Cyrillic for administrative levels for consistency with other boundary types
  • New level of 28 city municipalities (admin-3) covering 5 cities

Data improvements​

  • Europe 2022 data refresh
  • 4,600 new administrative boundaries
  • 160,000 new postcode boundaries
  • 43 new statistical boundaries
  • Italy: Align unit_code of municipalities (admin-3) to match ISTAT municipality code
  • Kosovo: Introduce new 1-digit postcode area (postal-1) and 5-digit postcode area (postal-4) coverage
  • Netherlands: Added 3.8k new 6-digit postcodes (postal-4)
  • Ukraine: Added 28k new features for country wide coverage of 5-digit postcodes (postal-4)
  • United Kingdom: Added 89k postcode (postal-4) boundaries
  • Turkey: Expanded coverage of neighborhoods (admin-3) with 4k new boundaries in 84 districts
  • New disputed area polygon for Croatia-Slovenia border dispute iso_3166_1='D0HRSI1'

Asia

  • China: Align unit_code of (admin-3) to match official administrative codes
  • Philippines: Updated name and unit_code for admin-1/2/3 to match official PGSC administrative codes

Bug fixes​

  • Fixes missing Liancourt Rocks in JP worldview
  • Add missing islands: Niulakita (Tuvalu), Nukulaelae (Tuvalu), and Eldey (Iceland) islands
  • Hungary: district (admin-2) names corrected
  • Canada: census division (stats-2) and census subdivision (stats-3) names corrections
  • Greece: (stats-4/5) fixed names with correct diactrics
  • Spain: Fix capitalization of administrative names
  • United States: locality name corrections for comma separated names (locality-2/3/4)

v4.1​

Q4 2022

Data coverage improvements​

This minor release includes an update to the U.S. legislative datasets and U.S. territories based on the decennial redistricting data program from the 2020 Census.

v4.0​

Q3 2022

This major release includes several breaking API and data changes. See Migrate from v3 to v4 for details on migrating your application.

Breaking changes​

  • The primary key field in the vector tilesets and lookup tables is now a globally unique mapbox_id. The primary key values of feature_id and id are now deprecated and will no longer work for joins with v4 tilesets. References to all v3 IDs need to be recomputed and all Boundaries tilesets must be added to a Mapbox map using a promoteId: "mapbox_id" argument.
  • Boundaries lookup tables are only delivered in flat CSV format. Nested JSON lookup tables have been deprecated.
  • Several fields in the Boundaries lookup tables have been renamed for consistency.
  • Data reorganization and fixes to many layers have resulted in breaking changes in data coverage:
  • US-legislative layers have been temporarily removed to make way for final 2022 redistricting boundaries in v4.1.
  • US-locality layers have been completely reorganized for parity with Mapbox Search API.
  • See the migration guide for a full list of breaking data layers.

Tileset improvements​

Data coverage improvements​

  • 🇧🇷 Brazil: 3k+ 5-digit postcode boundaries added
  • 🇰🇭 Cambodia: New 6-digit postcode boundaries 
  • 🇨🇦 Canada: New locality level of 3k+ neighbourhood boundaries
  • 🇮🇳 India: 21 new districts and 800+ subdistricts added
  • 🇮🇩 Indonesia: 
  • Administrative: 500+ districts 4.8k villages added
  • Postal: 2k+ 5-digit postcode boundaries added
  • 🇲🇾 Malaysia: Added new division level for Sabah and Sarawak states
  • 🇲🇽 Mexico: 20k+ 5-digit postcode boundaries added
  • 🇷🇺 Russia: 1k+ 6-digit postcode boundaries added
  • 🇹🇷 Turkey: 4k+ neighborhoods added
  • 🇺🇦 Ukraine: Reorganized administrative boundaries introduced in 2020
  • 🇺🇸 United States
  • Administrative: Updated with latest changes as per Census 2020
  • Statistical: Updated census tracts and block groups per Census 2020
  • Postal: Improved zip code boundaries validated with USPS zip code list. Added boundaries for 3-digit zip code groups 
  • Legislative: Placeholder for congressional and state redistricting expected in late 2022
  • Locality: Expanded coverage and data parity with Mapbox search API with 123k+ new place and neighborhood boundaries
  • 🇻🇳 Vietnam: Reorganized postal boundaries introduced in 2017
  • 🌎 Rest of North and South Americas, Asia
  • Refreshed geometries and metadata with latest available data sources

v3.4​

Q4 2021

Worldviews / Disputes​

Data coverage improvements​

v3.3​

Q3 2021

Data coverage improvements​

v3.2​

Q1 2021

Worldviews / Disputes​

  • Add Nogorno Karabkh disputed area boundary based on 1994 ceasefire line.
  • Add Kuril and Dokdo-ri islands to Japan worldview.

Metadata​

  • New grouping_attribute. This JSON string captures relevant "groupings" or "aggregated areas" that the individual feature is a part of. Initial data additions include:
  • Added UN M49 region and subregion names at admin-0.
  • New joined_attribute. This JSON string lists codes that are helpful for joining data against the feature.
  • Added ISO 3166-2 codes as part of join_attributes, primarily at admin-1 but some at admin-2.
  • Added UN M49 region and subregion IDs at admin-0.
  • Significant improvements to fill rates and density of metadata attributes:
  • Added admin-0 full language coverage for all Mapbox Streets-supported languages.
  • 100% Wikidata and municipality code coverage for France, Belgium, Germany, Netherlands, Greece, Poland, Portugal, Spain, Italy, and Czech.
  • Ukraine and Poland name and alias improvements.

Data coverage improvements​

  • Refresh of EU admin, postal, and statistical layers

v3.1​

Q3 2020

Data coverage improvements​

  • Refresh of Australia, Asia, and Africa that includes over 150,000 new polygons in additional coverage.

v3.0​

Q1 2020

Release blog post

Data types and tilesets​

  • Two new data types, locality and legislative, will be included as part of the product to complement the existing data types of administrative, postal, and statistical.
  • The locality data type will have 4 levels that aim to capture local expectations of settlements that have non-official or fuzzy areas: Level 1 = Metro */} Level 2 = City */} Level 3 = District */} Level 4 = Neighborhood.
  • The legislative data type will have 5 levels that capture electoral boundaries: Level 1 = National Upper (aka US Senate) */} Level 2 = National Lower (aka US House of Representatives) */} Level 3 = Regional Upper (State Senate) */} Level 4 = Regional Lower (State House) */} Level 5 = Local (Community or Town specific boundaries).
  • Separated lines and points tilesets that enable the inclusion of names on a map from the points tilesets.

Worldviews / Disputes​

Data coverage improvements​

  • US scope expanded to include cities and municipalities. The definition of a city is fluid in how it’s used and perceived by people. To avoid misrepresenting a boundary, we used several data types and levels to properly capture US city and municipality boundary polygons.
  • Admin, level 3 = US county sub-divisions that are active governments or entities with designated officials that provide primary general-purpose functions to their residents.
  • Admin, level 4 = US census incorporated places (excludes Census Designated Places, or CDPs, which are only statistical).
  • Stats, level 3 = all US county sub-divisions (all serve a statistical purpose, while only some serve an administrative purpose).
  • Locality, level 2 = this level was created to provide a one-stop location to provide what people colloquially refer to as a city in the US. It is constructed by using all US county sub-divisions as a basis, then adding all US census places (both incorporated and CDPs).
  • Completed a full review of all global Administrative boundaries, which resulted in recategorizing several boundaries to a statistical or legislative level as the purpose, function, or both purpose and function of those boundaries was changed by the government.

v2.2​

Q4 2019

Release blog post

Metadata​

  • New iso_3166_1_alpha_3. This field is the ISO 3166-1 or Alpha-3 code for a country.

Data coverage improvements​

  • 228,000 new boundaries including complete, global admin-1 coverage.
  • Refresh to the Caribbean and South Pacific regions.
  • Updates to US postal-4 (5-digit zip code) layer.

v2.1​

Q3 2019

Release blog post

Metadata​

  • Wikidata IDs, translations and aliases added for admin-1 and admin-2 boundaries.

Data coverage improvements​

  • Added two million new boundaries, increasing our data coverage in over 100 countries.
  • Statistical — Over 275,000 new US Census boundaries including metropolitan areas, micropolitan areas, tracts, and block groups.
  • Statistical — Almost 2,000 new European NUTS (Nomenclature of Territorial Units for Statistics) areas across three hierarchical levels
  • Postal — Full detail Postal-4 coverage for countries such as the UK, Netherlands, South Korea and Japan.
Was this page helpful?