Mapbox Plugins build on top of the Maps SDK providing extra features in lightweight dependencies. Whether you're looking to include traffic on top of your map or show the user location as a layer, plugins offer customizable APIs with a few lines of code to get started. Separating features into different plugins also allows for a more aggressive updating timeline.
Mapbox Plugins for Android are a collection of libraries that extend our Maps, Navigation, and Java SDKs for Android to help you integrate powerful mapping features into your applications. Use plugins to show a user's location, display traffic or building overlays, or search for places. With these plugins, you can pick the features that your app needs without losing the ability to customize; all bundled into lightweight dependencies.
By using a plugin, you also include the Maps SDK for Android which means that you'll need to setup your project to use the Maps SDK if you haven't already. Head over to the Maps SDK Getting Started documentation to learn more. The example below shows how to install the Traffic Plugin, but the process is identical for other plugins.
The plugins we offer are extensive and cover many of our SDKs for Android. They can be used together or separately depending on your needs. A brief summary of each plugin and its purpose is provided below:
- Building: Add 3D buildings to your map style with as few as two lines of code. Take this further by allowing users to toggle the layer visibility.
- Location Layer: A popular, often critical feature is showing the user's current location as an annotation to give a reference point on the map.
- Traffic: Place realtime traffic data within your map style as a layer.
- Places: Add UI components such as a Place Picker or Autocomplete search built on top of the Mapbox Geocoding API. Each component includes an intentBuilder which starts an activity for results and returns a Carmen Feature.
- Offline: Download map tiles and easily view already-downloaded regions for offline mapping.
- Marker cluster: Add map marker clusters to show large sets of data with a clean UI experience.
- Localization: Change the map's language based on the device's default language settings or other runtime variables.
Before using any of the Mapbox Plugins for Android, you will need:
- The latest version of Android Studio.
- JDK version 7.0 or higher.
- A recent version of the Android SDK.
- Android API Level 15 or higher (Android 4.0.3 and above).
- A Mapbox access token.
- Guides. Each plugin has an associated guide which contains both technical descriptions about the plugin and its features, as well as, conceptual explanations of the different components and how they work together.
- Examples See the code in action inside of our demo app and use the source code as a good starting point for your project.
- If you are looking for support using this SDK, either reach out through Stack Overflow or through our contact page.
- If you find a bug and can provide steps to reliably reproduce it, open an issue in the /mapbox-plugins-android repository on GitHub and apply the bug label.
- If you have a feature request, open an issue in the /mapbox-plugins-android repository on GitHub, and apply the enhancement label.
- If you want to contribute, look over our contribution guidelines and open a pull request with your changes.