An open source alternative for native maps on Android. This library lets you use Mapbox, OpenStreetMap, and other tile sources in your app, as well as overlays like GeoJSON data and interactive tooltips.

This is a fork of osmdroid, so the entire core is open source: it doesn't depend on the Google Maps SDK or any components outside of AOSP that would require the Google Play Store.

We recommend using the Mapbox Android SDK with Gradle: this will automatically install the necessary dependencies and pull the SDK binaries from the Maven Central repository ( Mapbox Android SDK on Maven Central ).

Add this to your to your build.gradle:

repositories {
    mavenCentral()
}

dependencies {
    compile ('com.mapbox.mapboxsdk:mapbox-android-sdk:0.2.3@aar'){
        transitive=true
    }
}

At any given time there will be 3 different versions of the SDK to use. You're welcome to use whichever one makes the most sense for your project, just be aware that each comes with a different level of stability. The installation instructions below all describe how to use the Stable / Supported version (although the SNAPSHOT version can make use of the same instructions. Just need to update the Repo and the Version Number).

1. Stable / Supported

• Currently 0.2.3

2. SNAPSHOT

• Currently 0.3.0-SNAPSHOT and available via the Maven Central Snapshot Repo https://oss.sonatype.org/content/repositories/snapshots/com/mapbox/mapboxsdk/mapbox-android-sdk/

3. Source

Download and include the mapbox-android-sdk.aar file and all artifacts (.aar and .jar files listed) listed in MapboxAndroidSDK / build.gradle. These will change over time so please check back regularly.

Example:

• Mapbox Android SDK (.aar) - 0.2.3
• Android Support V4 - 19.1
• OkHttp - 1.3.0
• NineOldAndroids - 2.4.0
• DiskLRUCache - 2.0.1
• Guava - 16.0.1

The Mapbox Android SDK is also packaged as a .apk file. This allows integration with older tools (Eclipse) that don't support the .aar format yet. It's also available from Maven Central via:

<dependency> 
    <groupId>com.mapbox.mapboxsdk</groupId> 
    <artifactId>mapbox-android-sdk</artifactId> 
    <version>0.2.3</version> 
    <type>apklib</type> 
</dependency>

Building from source means you get the very latest version of our code. The first step is to clone the repository to a directory in your system

git clone https://github.com/mapbox/mapbox-android-sdk.git

We use Gradle as a configuration and build tool: to use it with your IDE, import the project by selecting build.gradle in the project root directory as the project file.

Don't worry about installing Gradle on your system if you don't already have it: the project makes use of Gradle Wrapper, so a correct & current project version of Gradle will automatically be installed and used to run the builds. To use the Gradle wrapper just look for gradlew or gradlew.bat (Windows) in the project's main directory. For example:

cd <PROJECT_ROOT>
 ./gradlew --version

which will produce something like:

------------------------------------------------------------
Gradle 1.10
------------------------------------------------------------

Build time:   2013-12-17 09:28:15 UTC
Build number: none
Revision:     36ced393628875ff15575fa03d16c1349ffe8bb6

Groovy:       1.8.6
Ant:          Apache Ant(TM) version 1.9.2 compiled on July 8 2013
Ivy:          2.2.0
JVM:          1.7.0_40 (Oracle Corporation 24.0-b56)
OS:           Mac OS X 10.9.2 x86_64

See the Gradle Wrapper documentation for more details.

Then you can build an archive:

./gradlew clean assembleRelease

# The archive (mapbox-android-sdk-<VERSION>.aar) will be found in
<PROJECTHOME>/MapboxAndroidSDK/build/libs

Don't forget to then also include the dependencies from MapboxAndroidSDK / build.gradle in your classpath!

This project is a fork of OSMDroid, but is significantly different as the result of major refactoring and rethinking.

• GeoJSON and TileJSON support added.
• The Mapbox Android SDK is Apache 2.0 licensed, and does not include any GPL or copyleft add-ons.
• Mapbox Android SDK is a small core design. OSMDroid's semi-related utilities like GPX uploading, UI zoom buttons, GEM & Zip file support, Scale Bar, Compass Overlay, and more have been removed. These requirements will be better served by separate modules that do one thing well.
• Interfaces and abstract classes are only defined when suitable: most single-use interfaces are removed for simplicity.
• Data objects like points and lines use doubles instead of the E6 int convention. This simplifies implementations. The reuse pattern is also deemphasized, since it's less necessary with newer JITs.
• Instead of supporting specific tile layers with hardcoded paths, Mapbox Android SDK provides an easy-to-configure TileLayer class.
• Small modules are used in place of local implementations - DiskLRUCache for caching, OkHttp for connection niceties, and android-geojson for GeoJSON parsing.
• Markers can optionally use the Mapbox marker API for customized images.
• Code style follows the Sun conventions
• Automated tests are included.
• slf4j dependency is removed