Changelog
v4.3
Q4 2023
Highlights
- Data refresh of Africa and Oceania regions with latest administrative, postal, statistical and legislative changes up to 2022
- 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 highly 33 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
- Update
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 offeature_id
andid
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 apromoteId: "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
- Improved feature density in vector tiles
- Vetted international boundaries for all countries in Asia to align with the Large Scale International Boundaries dataset.
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
- New Argentina worldview.
- New Morocco worldview.
- New Russia worldview.
- New Turkey worldview.
- Adds 3 new disputed areas to
adm0
:- The United Nations buffer zone in Cyprus
- South Ossetia in Georgia
- Abkhazia in Georgia
Data coverage improvements
- Refresh of EU and UK admin, postal, and statistical layers. Highlights include expanded full postal coverage in many countries (for example 7 digit postcodes in Portugal, 5 digit postcode in Ukraine urban centers).
v3.3
Q3 2021
Data coverage improvements
- Refresh of US Admin layers with 2020 Census data.
- New Postal coverage including Canada 6-digit postal codes.
- New Admin coverage including Guernsey parishes.
- New Legislative coverage including three Canada layers.
- New Locality coverage including Czech Republic ORPs.
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
.
- Added UN M49 region and subregion names at
- 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 atadmin-1
but some atadmin-2
. - Added UN M49 region and subregion IDs at
admin-0
.
- Added ISO 3166-2 codes as part of
- 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.
- Added
Data coverage improvements
- Refresh of EU admin, postal, and statistical layers
- New Admin coverage including Monaco quartiers, Hong Kong districts, Isle of Man districts, and Jersey parishes.
- New Stats coverage including Canada census subdivisions, Ireland LAU1 and 2, Norway okonomisk regioner, four New Zealand layers, and Isle of Man sheadings.
- New Legislative coverage including three New Zealand layers, Ireland Local Electoral Areas, and France cantons.
v3.1
Q3 2020
Data coverage improvements
- Refresh of Australia, Asia, and Africa that includes over 150,000 new polygons in additional coverage.
- African countries with new layers are Algeria, Ghana and Kenya.
- APAC countries with new layers are Australia, Bangladesh, Cambodia, Indonesia, UAE, Singapore, Thailand, and Vietnam.
v3.0
Q1 2020
Data types and tilesets
- Two new data types,
locality
andlegislative
, will be included as part of the product to complement the existing data types ofadministrative
,postal
, andstatistical
.- 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).
- The
- Separated lines and points tilesets that enable the inclusion of names on a map from the points tilesets.
Worldviews / Disputes
- New Japanese worldview.
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
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
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?