Remove RestrictTo annotation for camera changed coalesced APIs (#3874)

Remove `RestrictTo` annotation for camera changed coalesced APIs.

This is a follow-up to:
- #3598
- #3562

This PR also updates the example app to use the new coalesced event.

More details: https://mapbox.atlassian.net/browse/MAPSAND-2142

cc @mapbox/sdk-ci

GitOrigin-RevId: 3239cda70e9977a553a532893b13f936d33a6bb7

Author: jush

CHANGELOG.md

@@ -13,6 +13,8 @@ Mapbox welcomes participation and contributions from everyone.
   * Add common `MapInteraction` APIs to `StandardStyleInteractionsState`: `.onFeaturesetClicked`, `.onLayerClicked`, `.onFeaturesetLongClicked`, `.onLayerLongClicked`, `.onMapClicked`, `.onMapLongClicked`.
   * Add `StyleInteractionsState` to `MapboxStandardSatelliteStyle` so interactions can be used with the satellite style.
 * [compose] Rename experimental `ExperimentalStandardStyleState` to `StandardStyleState`, rename experimental `MapboxStandardStyleExperimental` to `MapboxStandardStyle(styleImportsContent, topSlot, middleSlot, bottomSlot, standardStyleState)`, and deprecate previous `MapboxStandardStyle` composable functions.
+* Expose new experimental camera event `MapboxMap.subscribeCameraChangedCoalesced`, `MapboxMap.cameraChangedCoalescedEvents`.
+* [compose] Expose new camera event `MapState.cameraChangedCoalescedEvents`
 
 # 11.11.1 May 16, 2025
 ## Bug fixes 🐞

app/src/main/java/com/mapbox/maps/testapp/examples/InsetMapActivity.kt

@@ -6,11 +6,12 @@ import androidx.appcompat.app.AppCompatActivity
 import androidx.lifecycle.Lifecycle
 import androidx.lifecycle.lifecycleScope
 import androidx.lifecycle.repeatOnLifecycle
+import com.mapbox.annotation.MapboxExperimental
 import com.mapbox.geojson.Feature
 import com.mapbox.geojson.LineString
 import com.mapbox.geojson.Point
 import com.mapbox.maps.*
-import com.mapbox.maps.coroutine.cameraChangedEvents
+import com.mapbox.maps.coroutine.cameraChangedCoalescedEvents
 import com.mapbox.maps.dsl.cameraOptions
 import com.mapbox.maps.extension.style.layers.addLayer
 import com.mapbox.maps.extension.style.layers.generated.lineLayer
@@ -41,6 +42,7 @@ class InsetMapActivity : AppCompatActivity() {
   private lateinit var mainMapboxMap: MapboxMap
   private var insetMapboxMap: MapboxMap? = null
 
+  @OptIn(MapboxExperimental::class)
   override fun onCreate(savedInstanceState: Bundle?) {
     super.onCreate(savedInstanceState)
     val binding = ActivityInsetMapBinding.inflate(layoutInflater)
@@ -55,8 +57,8 @@ class InsetMapActivity : AppCompatActivity() {
       // repeatOnLifecycle launches the block in a new coroutine every time the
       // lifecycle is in the STARTED state (or above) and cancels it when it's STOPPED.
       repeatOnLifecycle(Lifecycle.State.STARTED) {
-        mainMapboxMap.cameraChangedEvents.collect {
-          updateInsetMapCamera(it.cameraState)
+        mainMapboxMap.cameraChangedCoalescedEvents.collect { cameraEvent ->
+          updateInsetMapCamera(cameraEvent.cameraState)
         }
       }
     }

app/src/main/java/com/mapbox/maps/testapp/examples/coroutines/featurestate/FeatureStateActivity.kt

@@ -11,6 +11,7 @@ import androidx.core.view.doOnLayout
 import androidx.lifecycle.Lifecycle
 import androidx.lifecycle.lifecycleScope
 import androidx.lifecycle.repeatOnLifecycle
+import com.mapbox.annotation.MapboxExperimental
 import com.mapbox.bindgen.Value
 import com.mapbox.geojson.Point
 import com.mapbox.maps.MapboxMap
@@ -20,7 +21,7 @@ import com.mapbox.maps.RenderedQueryOptions
 import com.mapbox.maps.ScreenBox
 import com.mapbox.maps.ScreenCoordinate
 import com.mapbox.maps.Style
-import com.mapbox.maps.coroutine.cameraChangedEvents
+import com.mapbox.maps.coroutine.cameraChangedCoalescedEvents
 import com.mapbox.maps.coroutine.getFeatureState
 import com.mapbox.maps.coroutine.queryRenderedFeatures
 import com.mapbox.maps.coroutine.setFeatureState
@@ -95,11 +96,12 @@ class FeatureStateActivity : AppCompatActivity() {
     }
   }
 
+  @OptIn(MapboxExperimental::class)
   private suspend fun highlightFeatureOnHover() {
     val crosshairScreenBox = getCrosshairScreenBox()
 
     // Observe camera changes and query the rendered features under the crosshair.
-    mapboxMap.cameraChangedEvents
+    mapboxMap.cameraChangedCoalescedEvents
       .map { _ ->
         mapboxMap
           .queryRenderedFeatures(

app/src/main/java/com/mapbox/maps/testapp/examples/markersandcallouts/viewannotation/DynamicViewAnnotationActivity.kt

@@ -16,6 +16,7 @@ import androidx.core.content.ContextCompat.getColor
 import androidx.core.content.ContextCompat.getDrawable
 import androidx.core.graphics.drawable.toDrawable
 import androidx.lifecycle.lifecycleScope
+import com.mapbox.annotation.MapboxExperimental
 import com.mapbox.geojson.Feature
 import com.mapbox.geojson.FeatureCollection
 import com.mapbox.geojson.GeometryCollection
@@ -284,10 +285,11 @@ class DynamicViewAnnotationActivity : AppCompatActivity() {
   /**
    * Renders the padding on top of the MapView.
    */
+  @OptIn(MapboxExperimental::class)
   private fun MapView.showPaddingZone() {
     val paddingView = PaddingView(context)
     addView(paddingView)
-    mapboxMap.subscribeCameraChanged {
+    mapboxMap.subscribeCameraChangedCoalesced {
       it.cameraState.padding.let { padding ->
         paddingView.updateRect(
           Rect(