Changelog
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 numerous 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 neighbourhood 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 numerous countries (e.g. 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 150K 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 that represents a country name.
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.