Skip to content
Mapbox telemetry and core libraries for Android.
Java Other
  1. Java 98.3%
  2. Other 1.7%
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Publish telemetry release with specific version of released libcore (#… Apr 18, 2019
.github/ISSUE_TEMPLATE Add release template (#405) Jun 3, 2019
app Revert okhttp to version 3.12.0 (#413) Jun 6, 2019
cloudformation Push mobile metrics to loading dock (#288) Nov 13, 2018
config/checkstyle cleanup gradle dependencies Oct 20, 2017
gradle Revert okhttp to version 3.12.0 (#413) Jun 6, 2019
libcore Telemetry metrics (#397) Jun 12, 2019
liblocation Aggregate instrumentation and unit test coverage (#343) Mar 21, 2019
libtelemetry Update changelog for release 4.6.0 (#422) Aug 9, 2019
scripts Fix binary size checker archive name (#304) Nov 29, 2018
.gitignore Fix CI config (#24) Dec 14, 2017 Update changelog for release 4.6.0 (#422) Aug 9, 2019 README upgrade (#103) Apr 4, 2018
LICENSE Updated license year to 2018 (#59) Jan 26, 2018
Makefile Fix maven release step (#389) Apr 16, 2019 Add snapshot ending (#411) Jun 6, 2019
build.gradle prepare the repository as Maps SDK vendor Jan 15, 2019 Location API refactor (#229) Oct 10, 2018 Aggregate instrumentation and unit test coverage (#343) Mar 21, 2019
codecov.yml Add codecov.yml (#285) Nov 9, 2018 add maven publish support Oct 11, 2017
gradlew add test app Oct 11, 2017
gradlew.bat add test app Oct 11, 2017
package.json Push mobile metrics to loading dock (#288) Nov 13, 2018
settings.gradle add location module Oct 11, 2017 Aggregate instrumentation and unit test coverage (#343) Mar 21, 2019

CircleCI codecov

Mapbox Mobile Events

This repository houses the Mapbox Telemetry and Core Libraries for Android.

About libtelemetry

The Mapbox Telemetry Library for Android is used to collect anonymous and aggregated information about Mapbox usage. We use telemetry from all Mapbox SDKs to improve our map, directions, travel times, and search. We collect anonymous data about how users interact with the map to help developers build better location based applications.

Visit for higher-level information about telemetry and data security at Mapbox

About libcore

The Mapbox Core Library for Android is a set of utilities that help you with permissions, device location, and connectivity within your Android project. You can:

  • Check for, request, and respond to any number of Android system permissions such as device location or camera.
  • Check for and respond to a change in the device's internet connectivity status.
  • Retrieve a device's real-time location.

Getting Started

If you are looking to include the Core Library inside of 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 of this project.

The snippet to add to your app-level build.gradle file to use is the following:

// Mapbox Core Library for Android

compile 'com.mapbox.mapboxsdk:mapbox-android-core:0.2.1'

To run the sample code on a device or emulator, include your developer access token in developer-config.xml found in the project.


You'll find all of the documentation for the Core Library on our Mapbox Core page. This includes information on installation, using the API, 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 Core that you're using, 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 bug fixes or features that have not been packaged in an official release yet, you can use a -SNAPSHOT release of the current development version of the Mapbox Core Library via Gradle, available on Sonatype.

repositories {
    maven { url "" }

dependencies {
    compile 'com.mapbox.mapboxsdk:mapbox-android-core:0.3.0-SNAPSHOT'

Sample code

This repo's test app can help you get started with the Core library and to inspire you.


We welcome feedback, translations, and code contributions! Please see for details.

You can’t perform that action at this time.