Mapbox Boundaries
All docschevron-rightarrow-leftMapbox Boundarieschevron-rightChangelog

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 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 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

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

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

v3.1

Q3 2020

Data coverage improvements

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 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

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.