Mapbox Navigation Android SDK Examples

The repository is a collection of examples showing off the Mapbox Navigation Android SDK. In order to support minSdkVersion 21, Android Auto and preview features, there are three example apps.

1. app minSdkVersion of 21
2. app-preview minSdkVersion of 21
3. android-auto-app minSdkVersion of 23

Installation

Make sure you follow the steps under the Installation guide. Once you have your public and secret access tokens ready, do the following:

app

1. git clone [email protected]:mapbox/mapbox-navigation-android-examples.git
2. Go to app/src/main/res/values
3. Look for mapbox_access_token.xml
4. If the file already exists, swap YOUR_ACCESS_TOKEN_HERE with your public access token.
5. If the file doesn't exist then create one and add the following content to it

   <?xml version="1.0" encoding="utf-8"?>
   <resources xmlns:tools="http://schemas.android.com/tools">
       <string name="mapbox_access_token">YOUR_ACCESS_TOKEN_HERE</string>
   </resources>
   

6. Ensure that your secret token is added to build.gradle or to global gradle.properties as described in the installation guide.
7. Run the examples under app.

Previous versions

If you're looking for code examples from previous versions of the Navigation SDK, you can access them through the following links:

• Navigation SDK v2: https://github.com/mapbox/mapbox-navigation-android-examples/tree/main-v2
• Navigation SDK v1: https://github.com/mapbox/mapbox-navigation-android/tree/v1.6.0/examples/

Getting Help

• Have a bug to report? Open an issue. If possible, include the version of Mapbox Navigation SDK, and an example that shows the issue.
• Have an example request? Open an issue. Tell us what the example should do and why you want it.

Contributing

We welcome feedback and code contributions! Please see CONTRIBUTING.md for details.