Skip to main content


To start developing your application using the Mapbox Java SDK, you'll need to first decide which installation method works for you. The SDK is fully compatible with Android using Gradle and can also be included in a generic Java project using either Gradle or Maven. You can find all dependencies given below on MavenCentral.


  1. Start Android Studio.
  2. Open your project's module-level build.gradle file.
  3. Make sure that your project's minSdkVersion is API 14 or higher.
  4. In the dependencies block, add a new implementation dependency for each Java SDK package you want in your project, as shown below.
  5. Click Sync Project with Gradle Files near the toolbar in Android Studio.
repositories {

dependencies {
// Replace `DESIRED_JAVA_SDK_PACKAGE` with the name of an available package:

implementation 'com.mapbox.mapboxsdk:DESIRED_JAVA_SDK_PACKAGE:7.0.0'

implementation 'androidx.annotation:annotation:1.0.0'
Android's 64K method count limit
If your project is close or exceeds the 64K method count limit, you can mitigate this problem by selectively compiling only the specific Mapbox Android Service APIs you are using in your project.


If your project is using Maven instead of Gradle, you can add the dependency inside your project's POM.xml file, as shown below.

{/* Replace `DESIRED_JAVA_SDK_PACKAGE` with the name of an available package: */}
Was this page helpful?