Add tap gesture support to Marker components (#6786)

Adds tap (click) gesture support to Marker components across both iOS
and Android platforms, providing API parity and consistent user
interaction patterns. To keep the Markers feature simple I've only added
support for Tap (Click) )gestures, but it would be trivial to add other gesture
types if needed.

iOS Implementation:
- Add `onTapGesture` modifier to Marker component with callback support
- Update SwiftUI MarkersExample to demonstrate interactive markers with
color changes

Android Implementation:
- Add `onClick` parameter to Marker composable with optional callback
function
- Update MarkersActivity to showcase tap functionality with random color
transitions

GitOrigin-RevId: eadd595cdec6c886a7ceca08a688bfd48afb8768

Author: pjleonard37

CHANGELOG.md

@@ -19,6 +19,7 @@ Mapbox welcomes participation and contributions from everyone.
 
 ### Bug fixes 🐞
 * Fix incorrect color rendering for gradients and interpolations with zero alpha channel.
+* Add tap gesture support to `Marker` component with `onTapGesture` modifier
 
 ## 11.15.0 - 11 September, 2025
 

Sources/Examples/SwiftUI Examples/MarkersExample.swift

@@ -17,12 +17,18 @@ struct MarkersExample: View {
                 .color(markerColor)
                 .stroke(showStroke ? strokeColor : nil)
                 .text(showText ? markerText : nil)
+                .onTapGesture {
+                    markerColor = .random
+                }
 
             ForEvery(tappedPoints, id: \.latitude) { coord in
                 Marker(coordinate: coord)
                     .color(markerColor)
                     .stroke(showStroke ? strokeColor : nil)
                     .text(showText ? String(format: "%.3f, %.3f", coord.latitude, coord.longitude) : nil)
+                    .onTapGesture {
+                        markerColor = .random
+                    }
             }
 
             TapInteraction { tapContext in

Sources/MapboxMaps/Annotations/Marker.swift

@@ -1,6 +1,6 @@
 import SwiftUI
 
-/// Displays a simple map Marker at the specified coordinated.
+/// Displays a simple map Marker at the specified coordinate.
 ///
 /// `Marker` is a convenience struct which creates a simple `MapViewAnnotation` with limited customization options.
 /// Use `Marker` to quickly add a pin annotation at the specific coordinates when using SwiftUI.
@@ -19,6 +19,7 @@ import SwiftUI
 /// - Note: `Marker`s  are great for displaying unique interactive features. However, they may be suboptimal for large amounts of data and don't support clustering.
 /// Each marker creates a SwiftUI view, so for scenarios with 100+ markers, consider using ``PointAnnotation``,
 /// Additionally, `Marker`s appear above all content of MapView (e.g. layers, annotations, puck). If you need to display annotation between layers or below a puck, use ``PointAnnotation``.
+@_documentation(visibility: public)
 @_spi(Experimental)
 public struct Marker {
 
@@ -42,6 +43,9 @@ public struct Marker {
     /// The color of optional strokes
     var strokeColor: Color? = Color(red: 58/255, green: 89/255, blue: 250/255, opacity: 1.0)
 
+    /// The tap action to perform when marker is tapped
+    var tapAction: (() -> Void)?
+
     /// The outer image of the Marker
     private let outerImage = Image("default_marker_outer", bundle: .mapboxMaps)
 
@@ -74,6 +78,11 @@ public struct Marker {
         with(self, setter(\.strokeColor, color))
     }
 
+    /// Set a tap action for the Marker
+    public func onTapGesture(perform action: @escaping () -> Void) -> Self {
+        with(self, setter(\.tapAction, action))
+    }
+
     /// Build a `MapViewAnnotation` with the current Marker properties
     private func build() -> MapViewAnnotation {
         MapViewAnnotation(coordinate: coordinate) {
@@ -83,6 +92,9 @@ public struct Marker {
                     markerText(text)
                 }
             }
+            .onTapGesture {
+                tapAction?()
+            }
         }
         .allowOverlap(true)
     }

Sources/MapboxMaps/Documentation.docc/Documentation.md

@@ -32,6 +32,7 @@ The Mapbox Maps SDK for iOS is a public library for displaying interactive, thor
 
 
 ### Annotations
+- ``Marker``
 - <doc:Layer-Annotations>
 - <doc:View-Annotations>
 

Tests/MapboxMapsTests/Annotations/ViewAnnotationTests.swift

@@ -239,6 +239,23 @@ final class ViewAnnotationTests: XCTestCase {
         XCTAssertEqual(marker.strokeColor, Color(red: 58/255, green: 89/255, blue: 250/255, opacity: 1.0))
         XCTAssertEqual(marker.coordinate, CLLocationCoordinate2D.testConstantValue())
         XCTAssertEqual(marker.text, nil)
+        XCTAssertNil(marker.tapAction)
+    }
+
+    func testMarkerTapGesture() {
+        var tapped = false
+        let marker = Marker(coordinate: .testConstantValue())
+            .text("Test Marker")
+            .onTapGesture {
+                tapped = true
+            }
+
+        XCTAssertNotNil(marker.tapAction)
+        XCTAssertFalse(tapped)
+
+        // Execute the tap action
+        marker.tapAction?()
+        XCTAssertTrue(tapped)
     }
 }
 

scripts/api-compatibility-check/breakage_allowlist.txt

@@ -2193,3 +2193,6 @@ Constructor MapSnapshotOptions.init(size:pixelRatio:glyphsRasterizationOptions:s
 
 // Add scale bar nautical units
 Constructor ScaleBarViewOptions.init(position:margins:visibility:useMetricUnits:) has been removed
+
+// Documentation for Marker
+Struct Marker is now with @_documentation