More documentation about the plugin can be found here.
Please be aware that Android views are the less performant and less customizable option for adding icons to a map. The Mapbox Maps SDK's SymbolLayer is the recommended way to add icons. View the Mapbox Annotation Plugin for Android for more information about using a SymbolLayer.
To use the MarkerView plugin, you include its dependency in your build.gradle file.
// In the root build.gradle file
repositories {
mavenCentral()
}
...
// In the app build.gradle file
dependencies {
implementation 'com.mapbox.mapboxsdk:mapbox-android-plugin-markerview-v9:0.4.0'
}
The MarkerView plugin is published to Maven Central and nightly SNAPSHOTs are available on Sonatype:
// In the root build.gradle file
repositories {
mavenCentral()
maven { url "http://oss.sonatype.org/content/repositories/snapshots/" }
}
...
// In the app build.gradle file
dependencies {
implementation 'com.mapbox.mapboxsdk:mapbox-android-plugin-markerview-v9:0.5.0-SNAPSHOT'
}
This repository includes an app that shows how to use each plugin in this repository. Check out its code for ready-to-use snippets.
We'd love to hear your feedback as we build more plugins and learn how you use them.
Splitting specific functionality into plugins makes our Map SDK lighter and nimble for you to use, and it also lets us iterate faster. We can release plugins more often than the SDK, which requires a slower pace due to its larger codebase.
The Mapbox Android team creates plugins but this plugins repository is an open-source project similar to the various Mapbox SDKs for Android. Plugins' lightweight nature makes them much easier for you and anyone else to contribute rather than trying to add the same feature to the more robust Map SDK. The Mapbox team can also more easily accept contributed plugins and keep the plugin list growing.
We welcome contributions to this plugin repository!
If you're interested in building and sharing your own plugin, please read the contribution guide to learn how to get started.