/mapbox-java

Mapbox Java and Android Services.

Primary LanguageJavaMIT LicenseMIT

Maven Central CircleCI

Mapbox Android Services contains directions, geocoding, and many more APIs to use inside your Android or Java application. This repository holds the source code for the project and is divided into several modules to make it easier for developers to only include the dependencies needed for their project.

Getting Started

If you are looking to include this inside your project, please take a look at the detailed instructions found in our docs. If you are interested in building from source, read the contributing guide inside this project.

Documentation

You'll find all of the documentation for this SDK on our Mapbox Services page. This includes information on installation, using the APIs, and links to the API reference.

Getting Help

  • Need help with your code?: Look for previous questions on the #mapbox tag — or ask a new question.
  • Have a bug to report? Open an issue. If possible, include the version of Mapbox Services, a full log, and a project that shows the issue.
  • Have a feature request? Open an issue. Tell us what the feature should do and why you want the feature.

Using Snapshots

If you want to test recent bugfixes or features that have not been packaged in an official release yet, you can use a -SNAPSHOT release of the current development version of Mapbox Services via Gradle, available on Sonatype. There are several different snapshots built nightly. Feel free to use any of the modules as needed.

repositories {
    mavenCentral()
    maven { url "http://oss.sonatype.org/content/repositories/snapshots/" }
}

dependencies {
    compile 'com.mapbox.mapboxsdk:mapbox-android-services:2.3.0-SNAPSHOT'
}

Sample code

Check the Android Test App for examples or download the Mapbox Demo App to see what's possible with Mapbox Android Services. You can also visit the Mapbox Android examples page for additional code examples.

Contributing

All libraries are contained within the mapbox folder. You can import the project using Android Studio or IntelliJ IDEA. Read the contribution guide to get setup properly.