Update PMTiles docs & bump NDK version (#4278)

Co-authored-by: Bart Louwers <bart@emeel.net>

platform/android/MapLibreAndroidTestApp/src/main/AndroidManifest.xml

@@ -769,6 +769,18 @@
             <meta-data
                 android:name="android.support.PARENT_ACTIVITY"
                 android:value=".activity.FeatureOverviewActivity" />
+        </activity>
+        <activity
+            android:name=".activity.sources.PMTilesActivity"
+            android:description="@string/description_pmtiles"
+            android:exported="true"
+            android:label="@string/activity_pmtiles">
+            <meta-data
+                android:name="@string/category"
+                android:value="@string/category_data" />
+            <meta-data
+                android:name="android.support.PARENT_ACTIVITY"
+                android:value=".activity.FeatureOverviewActivity" />
         </activity> <!-- Features -->
         <activity
             android:name=".activity.feature.QueryRenderedFeaturesPropertiesActivity"

platform/android/MapLibreAndroidTestApp/src/main/java/org/maplibre/android/testapp/activity/sources/PMTilesActivity.kt

@@ -0,0 +1,90 @@
+package org.maplibre.android.testapp.activity.sources
+
+import android.graphics.Color
+import android.os.Bundle
+import androidx.appcompat.app.AppCompatActivity
+import org.maplibre.android.camera.CameraPosition
+import org.maplibre.android.geometry.LatLng
+import org.maplibre.android.maps.MapView
+import org.maplibre.android.maps.Style
+import org.maplibre.android.style.layers.CircleLayer
+import org.maplibre.android.style.layers.PropertyFactory
+import org.maplibre.android.style.layers.RasterLayer
+import org.maplibre.android.style.sources.RasterSource
+import org.maplibre.android.style.sources.VectorSource
+import org.maplibre.android.testapp.R
+
+class PMTilesActivity : AppCompatActivity() {
+    private lateinit var mapView: MapView
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        setContentView(R.layout.activity_pmtiles)
+        mapView = findViewById(R.id.mapView)
+
+        mapView.getMapAsync { map ->
+            // --8<-- [start:loadStyle]
+            map.setStyle("https://demotiles.maplibre.org/pmtiles/raster/style-imagery.json") { style ->
+                map.cameraPosition = CameraPosition.Builder()
+                    .target(LatLng(47.5, 12.0))
+                    .zoom(9.0)
+                    .build()
+                // --8<-- [end:loadStyle]
+                addPlaces(style)
+            }
+        }
+    }
+
+    private fun addPlaces(style: Style) {
+        // --8<-- [start:addSource]
+        val overtureSource = VectorSource(
+            "overture-places",
+            "pmtiles://https://overturemaps-tiles-us-west-2-beta.s3.amazonaws.com/2026-01-21/places.pmtiles"
+        )
+        style.addSource(overtureSource)
+        val overtureLayer = CircleLayer("overture-layer", "overture-places")
+        overtureLayer.setSourceLayer("place")
+        overtureLayer.setProperties(
+            PropertyFactory.circleColor(Color.parseColor("#f5c800")),
+            PropertyFactory.circleRadius(4f),
+            PropertyFactory.circleOpacity(0.6f)
+        )
+        style.addLayer(overtureLayer)
+        // --8<-- [end:addSource]
+
+        val foursquareSource = VectorSource(
+            "foursquare-places",
+            "pmtiles://https://oliverwipfli.ch/data/foursquare-os-places-10M-2024-11-20.pmtiles"
+        )
+        style.addSource(foursquareSource)
+        val foursquareLayer = CircleLayer("foursquare-layer", "foursquare-places")
+        foursquareLayer.setSourceLayer("place")
+        foursquareLayer.setProperties(
+            PropertyFactory.circleColor(Color.parseColor("#2dd9fe")),
+            PropertyFactory.circleRadius(4f),
+            PropertyFactory.circleOpacity(0.6f)
+        )
+        style.addLayer(foursquareLayer)
+    }
+
+    @Suppress("unused")
+    private fun addLocalRasterSource(style: Style) {
+        // --8<-- [start:loadFromFile]
+        val path = getExternalFilesDir(null)?.absolutePath + "/watercolor.pmtiles"
+        val source = RasterSource(
+            "watercolor",
+            "pmtiles://file://$path",
+            256
+        )
+        style.addSource(source)
+        style.addLayer(RasterLayer("watercolor", "watercolor"))
+        // --8<-- [end:loadFromFile]
+    }
+
+    override fun onStart() { super.onStart(); mapView.onStart() }
+    override fun onResume() { super.onResume(); mapView.onResume() }
+    override fun onPause() { super.onPause(); mapView.onPause() }
+    override fun onStop() { super.onStop(); mapView.onStop() }
+    override fun onLowMemory() { super.onLowMemory(); mapView.onLowMemory() }
+    override fun onDestroy() { super.onDestroy(); mapView.onDestroy() }
+}

platform/android/MapLibreAndroidTestApp/src/main/res/layout/activity_pmtiles.xml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="utf-8"?>
+<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    xmlns:tools="http://schemas.android.com/tools"
+    android:id="@+id/main"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    tools:context=".activity.sources.PMTilesActivity">
+
+    <org.maplibre.android.maps.MapView
+        android:id="@id/mapView"
+        android:layout_width="match_parent"
+        android:layout_height="match_parent" />
+</RelativeLayout>

platform/android/MapLibreAndroidTestApp/src/main/res/values/descriptions.xml

@@ -85,6 +85,7 @@
     <string name="description_grid_source">Example Custom Geometry Source</string>
     <string name="description_no_style">Load a map without providing a style URI or JSON</string>
     <string name="description_vector_tile">Load MVT data</string>
+    <string name="description_pmtiles">Load PMTiles data</string>
     <string name="description_local_glyph">Suzhou using Droid Sans for Chinese glyphs</string>
     <string name="description_hillshade">Example raster-dem source and hillshade layer</string>
     <string name="description_heatmaplayer">Use HeatmapLayer to visualise earthquakes</string>

platform/android/MapLibreAndroidTestApp/src/main/res/values/titles.xml

@@ -81,6 +81,7 @@
     <string name="activity_grid_source">Grid Source</string>
     <string name="activity_no_style">No Style URI/JSON</string>
     <string name="activity_vector_tile">Vector Tile source</string>
+    <string name="activity_pmtiles">PMTiles</string>
     <string name="activity_local_glyph">Local CJK glyph generation</string>
     <string name="activity_hillshade">Hillshade</string>
     <string name="activity_heatmaplayer">Heatmap layer</string>