Example: using LocationComponent to show the user's current location

[louwers]

Create a pull requests that includes a tutorial of how to show the user's current location. This issue has an associated bounty for the documentation bounty direction.

Deliverables

• The example should cover showing the user's current location with the LocationComponent.
• It should be added as an activity to MapboxGLAndroidSDKTestApp (you can use an existing one if it makes sense).
• Docs should be added to MdBook in docs/mdbook. Use an 'anchor comment' and regular expressions to include the Kotlin source code in the docs. Explained here: https://rust-lang.github.io/mdBook/format/mdbook.html#including-portions-of-a-file
• Explain that you can configure the LocationComponent with LocationComponentActivationOptions.Builder.
• The example should cover how to change the color of the puck.
• Code samples should use Kotlin
• Include at least two screenshots in your tutorial (you may want to provide a fake location to not expose your location). Drag and drop them to GitHub so we don't need to store them in the git tree.
• Please don't re-use any guides or tutorials that do not have a permissive license. This might be helpful, which does have a permissive license (so can be used).

[typebrook]

Hi @louwers
May I also work on this?

[louwers]

You may, but I want to set up a separate repository for the Android examples first. And let's get the other issue merged & finished first.

https://github.com/maplibre/maplibre-native-android-examples

I also want to set up CI to ensure all the examples continue to compile. Source code in Markdown files is too brittle.

If this is something you are comfortable setting up, maybe we can have a chat about it first so we can define the scope and how much work you think it would be. I also asked @fynngodau

[typebrook]

https://github.com/maplibre/maplibre-native-android-examples

That would be great! Just curious, is this repo only used for build test, or it will become a demo app for many showcases (maybe publish on Google Play Store)? Like https://github.com/mapbox/mapbox-android-demo

[louwers]

We are probably going to use https://github.com/maplibre/maplibre-native/tree/main/platform/android/MapboxGLAndroidSDKTestApp because all the infrastructure to build and test it is already in place.

[typebrook]

Does that means #1135 should continue #741, update all Activities in com/mapbox/mapboxsdk/testapp/activity/annotation/ ? (Also, add JsonApiActivity.kt for demo in docs)

[louwers]

@typebrook I modified the acceptance criteria for this bounty.

If you still would like to work on this, let me know and I can assign you!

[typebrook]

Yes, I'll take this.

[typebrook]

@louwers #1169 is made. Let's have further discussion there

[louwers]

This bounty can be paid out.

[typebrook]

Invoice link: https://opencollective.com/maplibre/expenses/138358
Invoice link: https://opencollective.com/maplibre/expenses/143821

[fynngodau]

@typebrook Probably you have linked the wrong invoice, the correct one appears to be: https://opencollective.com/maplibre/expenses/143821

[typebrook]

@fynngodau Thanks!