Split out Android examples to separate documentation site (#2978)

platform/android/docs/camera/animation-types.md

@@ -0,0 +1,13 @@
+# Animation Types
+
+This example showcases the different animation types.
+
+- **Move**: available via the `MapLibreMap.moveCamera` method.
+- **Ease**: available via the `MapLibreMap.easeCamera` method.
+- **Animate**: available via the `MapLibreMap.animateCamera` method.
+
+It also shows how to pass callbacks that are called when an animation is cancelled.
+
+```kotlin title="CameraAnimationTypeActivity.kt"
+--8<-- "MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/camera/CameraAnimationTypeActivity.kt"
+```

platform/android/docs/camera/animator-animation.md

@@ -0,0 +1,7 @@
+# Animator Animation
+
+This example showcases how to use the Animator API to schedule a sequence of map animations.
+
+```kotlin title="CameraAnimatorActivity.kt"
+--8<-- "MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/camera/CameraAnimatorActivity.kt"
+```

platform/android/docs/camera/cameraposition.md

@@ -0,0 +1,7 @@
+# CameraPosition Capabilities
+
+This example showcases how to listen to camera change events.
+
+```kotlin title="CameraPositionActivity.kt"
+--8<-- "MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/camera/CameraPositionActivity.kt"
+```

platform/android/docs/camera/gesture-detector.md

@@ -0,0 +1,28 @@
+# Gesture Detector
+
+The gesture detector of MapLibre Android is encapsulated in the [`maplibre-gestures-android`](https://github.com/maplibre/maplibre-gestures-android) package.
+
+#### Gesture Listeners
+
+You can add listeners for move, rotate, scale and shove gestures. For example, adding a move gesture listener with `MapLibreMap.addOnRotateListener`:
+
+```kotlin
+--8<-- "MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/camera/GestureDetectorActivity.kt:addOnMoveListener"
+```
+
+Refer to the full example below for examples of listeners for the other gesture types.
+
+#### Settings
+
+You can access an `UISettings` object via `MapLibreMap.uiSettings`. Available settings include:
+
+- **Toggle Quick Zoom**. You can double tap on the map to use quick zoom. You can toggle this behavior on and off (`UiSettings.isQuickZoomGesturesEnabled`).
+- **Toggle Velocity Animations**. By default flicking causes the map to continue panning (while decelerating). You can turn this off with `UiSettings.isScaleVelocityAnimationEnabled`.
+- **Toggle Rotate Enabled**. Use `uiSettings.isRotateGesturesEnabled`.
+- **Toggle Zoom Enabled**. Use `uiSettings.isZoomGesturesEnabled`.
+
+## Full Example Activity
+
+```kotlin title="GestureDetectorActivity.kt"
+--8<-- "MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/camera/GestureDetectorActivity.kt"
+```

platform/android/docs/camera/lat-lng-bounds.md

@@ -0,0 +1,26 @@
+# LatLngBounds API
+
+
+!!! note
+
+    You can find the full source code of this example in [`LatLngBoundsActivity.kt`](https://github.com/maplibre/maplibre-native/blob/main/platform/android/testapp/activity/camera/LatLngBoundsActivity.kt) of the MapLibreAndroidTestApp.
+
+This example demonstrates setting the camera to some bounds defined by some features. It sets these bounds when the map is initialized and when the [bottom sheet](https://m2.material.io/components/sheets-bottom) is opened or closed.
+
+<figure markdown="span">
+<video controls width="250">
+  <source src="https://github.com/user-attachments/assets/46a89dfb-3abc-448a-be53-8abe39b2919b" />
+</video>
+</figure>
+
+Here you can see how the feature collection is loaded and how `MapLibreMap.getCameraForLatLngBounds` is used to set the bounds during map initialization:
+
+```kotlin
+--8<-- "MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/camera/LatLngBoundsActivity.kt:featureCollection"
+```
+
+The `createBounds` function uses the `LatLngBounds` API to include all points within the bounds:
+
+```kotlin
+--8<-- "MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/camera/LatLngBoundsActivity.kt:createBounds"
+```