All docschevron-rightarrow-leftMapbox Boundarieschevron-rightGuides

Mapbox Boundaries

Current version: v4

  • check
    Millions of curated boundaries using the latest data sources
  • check
    Highly optimized geometries for fast performance using Mapbox GL
  • check
    Worldviews support for cutomized rendering of disputed areas
  • check
    Extensive metadata, including reference codes and name translations

Mapbox Boundaries is a comprehensive dataset of global boundary features, expertly curated across every country to support data visualization and geospatial analysis needs at scale. Explore the data coverage using the Mapbox Boundaries Explorer.

With Boundaries, you can connect your own tabular data with a managed set of geographical features representing various types of boundaries, such as administrative divisions or postal code areas. Polygons in Mapbox Boundaries are edge matched for seamless global coverage, so you can create exact data visualizations and accurate analysis.

You can use Mapbox Boundaries data to support use cases from business intelligence analysis and data journalism to customized territory planning and logistics management. For example, you can:

  • Visualize county-level data like the unemployment rates in the United States
  • Create interactive maps that showcase data like the top streaming songs per country
  • Enables users to search for business locations by state or zip code
  • Merge multiple polygons to form custom areas likes sales territories

Our product page shows more examples of how other Mapbox customers are using Boundaries.

Boundaries access

Access to the Mapbox Boundaries tilesets is controlled by your Mapbox account access token. If you do not have access on your account, contact Mapbox sales to request access to Boundaries tilesets.

For more information on access and licensing, refer to the Boundaries FAQ.

For free access, try the country-level Mapbox Boundaries that are available to all Mapbox users. For more details, see Mapbox Countries v1 reference.

Product format

There are two product components to Mapbox Boundaries:

Boundaries tilesets (Geometry)

The boundary geometries are packaged in Mapbox vector tilesets containing high resolution boundary features for all map scales. Each feature has a unique id and minimal set of feature properties to keep them small and performant. Raw geometries are not provided for offline use.

Boundaries lookup tables (Metadata)

The metadata for every tileset feature such as local names, name translations, hierarchy information and codes are provided as offline CSV lookup tables. These can be manipulated by the user application as needed and joined to the tilesets at runtime.

For detailed product specification, see the Mapbox Boundaries Reference.

Data coverage

The Mapbox Boundaries data organizes global coverage into five layer types and multiple levels of hierarchy. Multiple worldviews are provided for representing boundaries per local context.

Data sources

Data in the Mapbox Boundaries tilesets is based on information obtained from officially recognized local or international entities whenever possible. For more information, see Data sources for Mapbox Boundaries.

Attribution

When you publicly use styles or software that use Mapbox Boundaries tiles, you must display proper attribution.