Skip to main content

Maps SDK for iOS

Current version: v11.5.1View changelog

  • check
    Map styles
  • check
    Runtime styling
  • check
    Camera manipulation
  • check
    Querying the map
  • check
    User interaction

The Mapbox Maps SDK for iOS is a library for embedding highly customized maps within iOS applications.

Select a style for your application. Start with the expertly designed Mapbox Standard or any other Mapbox-designed styles that are optimized for various use cases, or design your own custom style in Mapbox Studio. Enhance the experience with 3D terrain. You can even alter your map's style at runtime.

Add your own custom data to the map. Whether you're adding markers to a map to include a store locator right in your app or creating compelling data visualizations, the Maps SDK gives you control over how you display data on your map. You can style map features at runtime based on data properties, user interaction, or device settings.


The Mapbox Maps SDK for iOS is compatible with applications that are:

  • Deployed on iOS 12 or higher
  • Xcode - Recommended Version: 15.3
    • Minimum Versions:
      • Mapbox iOS v10 - Xcode 14
      • Mapbox iOS v11 - Xcode 15
  • Written in Swift version 5.9 or higher

Use with other Mapbox tools

Use the Mapbox Maps SDK for iOS with other Mapbox products. Mix and match other tools and plugins to create a location-savvy application to your exact specifications.

Static maps

The Mapbox Maps SDK for iOS includes methods to generate a static snapshot of an existing map within your application. Use the Snapshotter class to create a static raster image of a map, without having to make a request to another API.

Deliver a consistent experience across your companion tvOS and watchOS applications with static map snapshots using MapboxStatic.swift, powered by the Mapbox Static API.

Mapbox Studio

The Mapbox Maps SDK is compatible with Mapbox Studio. Design a map that seamlessly matches your brand and application design, then infuse it with your own custom data all within the Mapbox Studio web interface.



You must include the Mapbox wordmark on any map that uses the Mapbox Maps SDK for iOS. You must display attribution on maps unless the map's data comes entirely from non-Mapbox sources.

You may adjust the position of the Mapbox wordmark and attribution notice, but they must stay visible on the map. You may also change the background and text color of the attribution notice to match your design aesthetics, but all information must be legible.

You may not otherwise alter the Mapbox wordmark or text attribution notice.

Attribution guidelines

Learn more about what kinds of attribution Mapbox requires and why.


Telemetry opt out

Mapbox Telemetry is a powerful location analytics platform included in this SDK. By default, the SDK sends de-identified location and usage data to Mapbox whenever the host app causes it to be gathered. The Mapbox Terms of Service require your app to provide users with a way to individually opt out of Mapbox Telemetry, which is provided automatically as part of the attribution control. If you hide the attribution control, you must provide an alternative opt out for your users to use.

Older versions of the SDK

Looking for an older version of the Maps SDK? See the Maps SDK v10 API reference or Maps SDK v6 documentation.

Was this page helpful?