Tutorial: adding annotations from a JSON API for Android

[louwers]

Create a pull requests that includes a tutorial of how to add annotations to the map on Android. This issue has an associated bounty for the documentation bounty direction.

Deliverables

• The tutorial should cover adding multiple annotations, with a popup on click.
• Pull the data from a free and public API.
  • For example:
  • https://dev.socrata.com/consumers/getting-started.html
  • https://data.cityofchicago.org/resource/f7f2-ggz5.json
• Code samples should use Kotlin
• Include at least two screenshots in your tutorial.
• 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):

[louwers]

@fynngodau mentioned that

Are you aware that maplibre-plugin-annotations itself contains a different sample app that makes use of its own functionality? Therefore it may not make sense to rewrite the MapLibre SDK sample app – instead we could mark deprecated features as deprecated inside the app, and add a note that developers should also look at the plugin sample app.

So the code is mostly already written. Please make use of the Annotations plugin in maplibre-plugins-android and not of the deprecated Annotations functionality in the SDK in the tutorial.

[wipfli]

@louwers can you add a link to the bounty direction in maplibre/maplibre? I guess this one goes into the documentation one.

[louwers]

@wipfli It's already there! 🙂

[typebrook]

Hi @louwers, Can I work on this?

[typebrook]

@louwers By the way, this issue is only about adding tutorial in docs/mdbook/src/android/ (like what is done in #939). Any I right here?

[louwers]

@typebrook Yes. It's all yours!

[typebrook]

@louwers #1135 is made, let's have further discussion there.

[louwers]

This bounty can be paid out.

We're still figuring out how to best store the examples and if we should make the annotations available via the plugins or via the core SDK. But the acceptance criteria of this bounty have been fulfilled.

[typebrook]

Invoice link: https://opencollective.com/maplibre/expenses/139735