尹诚 / Mapbox-iOS-SDK · Files

Go to a project
README.markdown 4.32 KB

MapBox iOS SDK

Based on the Route-Me iOS map library (Alpstein fork) with custom MapBox additions.

Requires iOS 5 and Xcode 4.3 or greater. Does not yet support ARC.

Major differences from Alpstein fork of Route-Me:

  • Requires iOS 5.0 and above.
  • MapBox & MBTiles tile source integration code.
  • MapBox Markers support.
  • UTFGrid interactivity.
  • Improved network tile loading performance.
  • Prepackaged binary framework.
  • CocoaPods support.
  • Removal of two-finger double-tap gesture for zoom out (to speed up two-finger single-tap recognition like MapKit).
  • Different default starting location for maps.
  • Built-in attribution view controller with button on map views & default OpenStreetMap attribution.
  • Removal of included example projects in favor of separate examples on GitHub.
  • A few added defaults for convenience.
  • Improved documentation.

Route-Me

Route-Me is an open source map library that runs natively on iOS. It's designed to look and feel much like the built-in iOS map library, but it's entirely open, and works with any map source using a pluggable backend system.

Supported map tile sources include MapBox/TileStream, the offline-capable, database-backed format MBTiles, OpenStreetMap, and several others.

Please note that you are responsible for getting permission to use the map data, and for ensuring your use adheres to the relevant terms of use.

Installation

There are three ways that you can install the SDK, depending upon your needs:

  1. Clone from GitHub and integrate as a dependent Xcode project.
  2. Use the binary framework. Use like regular frameworks, linking it in your project, adding #import <MapBox/MapBox.h>, and additionally, including the -ObjC linker flag.
  3. Install via CocoaPods.

The two main branches of the GitHub repository are pretty self-explanatory: release and develop. When we tag a release, we also merge develop over to release, except in the case of minor point releases (e.g., 0.4.2), where we might just bring over a fix or two from develop.

Then, update the submodules:

  git submodule update --init

Some example apps showing usage of the SDK:

More documentation is available: 

  http://mapbox.com/mapbox-ios-sdk/

There are two subdirectories - MapView and Proj4. Proj4 is a support library used to do map projections. The MapView project contains only the Route-Me map library.

See License.txt for license details. In any app that uses this SDK, include the following text on your "preferences" or "about" screen: "Uses MapBox iOS SDK, (c) 2008-2012 MapBox and Route-Me Contributors". Your data provider will have additional attribution requirements.

News, Support and Contributing

Complete API documentation is available online or as an Xcode docset Atom feed.

The MapBox iOS SDK has a support resource where you can open cases and browse other developers' discussions about use of the SDK.

We have a basic technical overview along with the installation instructions.

MapBox has an IRC channel on irc.freenode.net in #mapbox.

To report bugs and help fix them, please use the issue tracker.