Mapbox Maps SDK for iOS

The Mapbox Maps SDK for iOS is an open-source framework for embedding interactive map views with scalable, customizable vector maps into Cocoa Touch applications on iOS 9.0 and above using Objective-C, Swift, or Interface Builder. It takes stylesheets that conform to the Mapbox Style Specification, applies them to vector tiles that conform to the Mapbox Vector Tile Specification, and renders them using OpenGL.

Mapbox Maps SDK for iOS screenshots

For setup information, check out the Mapbox Maps SDK for iOS homepage. For detailed usage instructions, read “First steps with the Mapbox Maps SDK for iOS” and consult the online examples.

If you have any questions, please see our help page. We welcome your bug reports, feature requests, and contributions.

Changes in version 5.12.2


  • Exposes the windowBit value from zlib in the compress/decompress helper utils #147
  • Fix camera paddings reset on map view gestures performing #188

Recent changes


Bug Fixes

  • ScaleBar enhancements #120, #121
  • Invalid tile url template for MapLibre style #107
  • Address crash when localFontFamilyName is nil #109
  • Fix for annotations stuttering and drifting when panning #113
  • Adjust local glyphs #122
  • Return correct Mapbox TileServerOptions #132


  • Fix perf regression in cached tiles of tile pyramid #129
  • Upgrade to newest protozero #148
  • Fix build for Xcode 12.5 & 13-beta. #153



  • Added allowScrollGesturesDuringRotateOrZoom #60
  • Replacing hardcoded configuration with configurable API and removing Mapbox assets and dependencies #90

Bug Fixes

  • Fix map stuttering by switching render call to use setNeedsDisplay #60
  • Dispatch to main queue, rather than global #64
  • Use DisplayLink to prevent crashes in willResignActive #68
  • Ignore sizing and positioning for hidden elements in assertions #80
  • Disable map snapshots by default #83

See the full changelog for previous releases.