Where you can find everything iOS from Mapzen
Swift Ruby Shell
Latest commit f33d5e9 Jan 24, 2017 @migurski migurski committed with ecgreb Updated for future docs repo name change (#149)
* Updated for future docs repo name change

* Update circle.yml
Failed to load latest commit information.
docs follow > track Oct 5, 2016
images Restructure project and remove unused files Dec 13, 2016
ios-sdk.xcodeproj Centralize API Key Manager and Implement Route Line Drawing (#144) Jan 19, 2017
ios-sdkTests Centralize API Key Manager and Implement Route Line Drawing (#144) Jan 19, 2017
scripts Finalize nightly scripts, enabling team notification Dec 13, 2016
tangram/scenes Restructure project and remove unused files Dec 13, 2016
.gitignore Testing adding the workspace to make circle happy Oct 6, 2016
circle.yml Updated for future docs repo name change (#149) Jan 23, 2017
ios-sdk.podspec Add images import to podfile Jan 2, 2017


The Mapzen iOS SDK

Circle CI

The Mapzen iOS SDK is a thin wrapper that packages up everything you need to use Mapzen services in your iOS applications.

We're currently under heavy development with this SDK. We welcome feature requests by posting an issue and labeling it appropriately as an "Enhancement". Feel free to also reach out to us using any of the other channels we have available on https://mapzen.com/.


At Mapzen we're developing our various SDKs using Xcode 8 and Swift 2.3. However, minor changes are needed to run in Xcode 7 / Swift 2.2. If you need Swift 2.2 support, or you run into any other issues, please open an issue ticket on Github and we'll figure it out together!

The Mapzen iOS SDK uses Cocoapods to handle importing the various necessary dependencies that underpin our services. The full instructions for installing Cocoapods can be found on https://cocoapods.org/. As of the writing of this document, the Cocoapods installation instructions are diverged as Xcode 8's introduction has made backwards support of Xcode 7 challenging for the Cocoapods maintainers.

When you have installed the appropriate version of Cocoapods for your current development environment, run pod install from the command line inside the directory where you cloned this repository. Once that process completes (it can take several minutes depending upon how busy the GitHub servers are that serve Cocoapods), go ahead and open the ios-sdk.workspace file container to open the demo application codebase.


As noted above, we're currently under heavy development of this SDK. There's a couple of things you should probably know about up front:

  • Full Objective-C support is coming soon, see this issue https://github.com/mapzen/ios/issues/68. If you run into issues in your obj-c project, feel free to comment on that issue.
  • If you wish to install this to a device, you will need to update the bundle identifier and the code signing in the Xcode project and go through the general code signing process necessary for installing to a device. This will require a free Apple Developer account.