The Mapbox iOS SDK is more dynamic than ever! Version 3.1.0 is now available, featuring numerous improvements to the installation process, animation, and customizability.

If you’ve installed this SDK before, the first thing you’ll notice is how small it is. If your application targets iOS 8.0 and above, you can download the SDK as a dynamic framework that’s 37% smaller than the static framework and eliminates most of the setup steps.

Sophisticated animations

Now, when the user tracking mode is set to “follow”, the map pans smoothly between location updates. And with “fly to” animations, chained together using completion handlers, you can take your users on a breathtaking journey around the world in just a few lines of code:

More options and zoom levels

We’ve added some powerful new customization options to the SDK. For example:

  • Anchor the user location annotation at the bottom of the map view, just as you’d see in a turn-by-turn navigation interface.
  • Replace the standard annotation callout view with a custom view of your own, perfect for presenting lots of detail about an annotation.
  • If your annotation image has a large shadow, you can exclude it from the tappable region by setting the image’s alignment rect insets.

We’ve also increased the maximum zoom level, from 18 in previous versions to 20 in version 3.1.0. But if that’s still too coarse for your needs, you can kick it all the way up to 25.5, for scale of one point to 1.6 centimeters at the Equator!

Gulu huts
Traditional grass-thatched huts in Gulu, Uganda, seen here at zoom level 22. Gulu is one of the most densely mapped places in OpenStreetMap, thanks to a collaboration between the Humanitarian OpenStreetMap Team, the American Red Cross, and the Uganda Red Cross Society.

Getting started

Install the SDK either manually or using CocoaPods. If you use Fabric, you’ll be able to upgrade in the coming days as well. If you’re upgrading from an older version, be sure to read the long list of improvements in version 3.1.0.

Browse our examples and in-depth guides to get started. To get the most out of the SDK, consult our revamped API documentation, which is also integrated with Xcode. Don’t forget to check out our Android SDK, which includes many of the same awesome features.