[geofencing] Remove experimental from Geofencing APIs. (#8323)

Fixes https://mapbox.atlassian.net/browse/MAPSSDK-914

This PR promotes the Geofencing API to stable by removing the
`experimental` attribute across several layers.

## Core Changes
* IDL Updates: The [Experimental] attribute is removed from all
Geofencing API Interface Definition Languages (IDLs).
* Maps SDKs: The MapboxExperimental attribution is removed from both the
Android and iOS Maps SDKs.

## ⚠️ Potential Breaking Changes (C++)
Action Required for C++ Consumers: The removal of the experimental flag
includes the removal of the experimental C++ namespace. Consumers
integrating the Geofencing C++ API must update their code to reflect the
new, stable namespace to avoid compilation errors.

cc @mapbox/core-sdk

cc @mapbox/maps-android

cc @mapbox/sdk-ci

cc @mapbox/maps-ios

---------

Co-authored-by: Changelog autocreator bot <[email protected]>
Co-authored-by: Mai Mai <[email protected]>
GitOrigin-RevId: 1cebb6718082ef08870e8a416f9cc452c954cbb3

Author: 3 people

CHANGELOG.md

@@ -5,10 +5,13 @@ Mapbox welcomes participation and contributions from everyone.
 > **16 KB Page Size Support:** Starting with version 11.7.0 and 10.19.0, **NDK 27 is supported** with dedicated artifacts that include [support for 16 KB page sizes](https://developer.android.com/guide/practices/page-sizes). If your app does not require 16 KB page size support, you can keep using our default artifacts without `-ndk27` suffix. For more information about our NDK support, see https://docs.mapbox.com/android/maps/guides/#ndk-support
 
 # main
-
 ## Breaking changes ⚠️
 * Remove line-cutout-width and change line-cutout-opacity default to 1.0
 
+# 11.17.0
+## Features ✨ and improvements 🏁
+* Promote Geofencing APIs to stable, remove `MapboxExperimental` annotations from Geofencing APIs.
+
 # 11.17.0-rc.1 November 20, 2025
 
 # 11.17.0-rc.1

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

@@ -38,7 +38,6 @@ import com.mapbox.maps.CameraOptions
 import com.mapbox.maps.ClickInteraction
 import com.mapbox.maps.EdgeInsets
 import com.mapbox.maps.InteractionContext
-import com.mapbox.maps.MapboxExperimental
 import com.mapbox.maps.MapboxMap
 import com.mapbox.maps.Style
 import com.mapbox.maps.extension.style.layers.generated.fillLayer
@@ -73,8 +72,6 @@ import java.util.Date
  * even when GeofenceActivity or the whole app is closed.
  * [MapboxApplication.ENABLE_BACKGROUND_GEOFENCING] flag turns ON/OFF showcase of background behavior of the geofence engine.
  */
-
-@com.mapbox.annotation.MapboxExperimental
 class ExtendedGeofencingActivity : AppCompatActivity() {
 
   private var requestNotificationPermissionLauncher: ActivityResultLauncher<String> =
@@ -213,7 +210,6 @@ class ExtendedGeofencingActivity : AppCompatActivity() {
   }
 
   @SuppressLint("SetTextI18n")
-  @OptIn(MapboxExperimental::class)
   override fun onCreate(savedInstanceState: Bundle?) {
     super.onCreate(savedInstanceState)
 

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

@@ -6,7 +6,6 @@ import android.view.View
 import androidx.appcompat.app.AppCompatActivity
 import androidx.lifecycle.lifecycleScope
 import com.google.gson.JsonObject
-import com.mapbox.annotation.MapboxExperimental
 import com.mapbox.bindgen.Expected
 import com.mapbox.common.geofencing.GeofencingError
 import com.mapbox.common.geofencing.GeofencingEvent
@@ -46,7 +45,6 @@ import java.lang.ref.WeakReference
  * Geofence callbacks are called when device location enters, dwells, or leaves loaded geofence zone.
  * Each aforementioned event is accompanied by rendering received feature (Blue, Green, Red colors ).
  */
-@MapboxExperimental
 class SimpleGeofencingActivity : AppCompatActivity() {
 
   private lateinit var locationPermissionHelper: LocationPermissionHelper

extension-compose/api/Release/metalava.txt

@@ -1178,7 +1178,7 @@ package com.mapbox.maps.extension.compose.ornaments.attribution {
 
   @androidx.compose.runtime.Immutable @com.mapbox.maps.extension.compose.MapboxMapScopeMarker public final class MapAttributionScope {
     method @androidx.compose.runtime.Composable public void Attribution(androidx.compose.ui.Modifier modifier = Modifier, androidx.compose.foundation.layout.PaddingValues contentPadding = PaddingValues(92.dp, 4.dp, 4.dp, 4.dp), androidx.compose.ui.Alignment alignment = androidx.compose.ui.Alignment.Companion.BottomStart, long iconColor = Color(4280192171), kotlin.jvm.functions.Function3<? super java.util.List<com.mapbox.maps.plugin.attribution.Attribution>,? super kotlin.jvm.functions.Function0<kotlin.Unit>,? super kotlin.jvm.functions.Function1<? super com.mapbox.maps.plugin.attribution.Attribution,kotlin.Unit>,kotlin.Unit> attributionDialog = { attributions, onDismissRequest, onAttributionClick -> AttributionDialog(attributions, onDismissRequest, onAttributionClick) }, kotlin.jvm.functions.Function4<? super kotlin.jvm.functions.Function0<kotlin.Unit>,? super kotlin.jvm.functions.Function0<kotlin.Unit>,? super kotlin.jvm.functions.Function0<kotlin.Unit>,? super kotlin.jvm.functions.Function0<kotlin.Unit>,kotlin.Unit> telemetryDialog = { onDismissRequest, onMoreInfo, onDisagree, onAgree -> TelemetryDialog(onDismissRequest, onMoreInfo, onDisagree, onAgree) });
-    method @androidx.compose.runtime.Composable @com.mapbox.annotation.MapboxExperimental @com.mapbox.maps.MapboxExperimental public void Attribution(androidx.compose.ui.Modifier modifier = Modifier, androidx.compose.foundation.layout.PaddingValues contentPadding = PaddingValues(92.dp, 4.dp, 4.dp, 4.dp), androidx.compose.ui.Alignment alignment = androidx.compose.ui.Alignment.Companion.BottomStart, long iconColor = Color(4280192171), kotlin.jvm.functions.Function3<? super java.util.List<com.mapbox.maps.plugin.attribution.Attribution>,? super kotlin.jvm.functions.Function0<kotlin.Unit>,? super kotlin.jvm.functions.Function1<? super com.mapbox.maps.plugin.attribution.Attribution,kotlin.Unit>,kotlin.Unit> attributionDialog = { attributions, onDismissRequest, onAttributionClick -> AttributionDialog(attributions, onDismissRequest, onAttributionClick) }, kotlin.jvm.functions.Function4<? super kotlin.jvm.functions.Function0<kotlin.Unit>,? super kotlin.jvm.functions.Function0<kotlin.Unit>,? super kotlin.jvm.functions.Function0<kotlin.Unit>,? super kotlin.jvm.functions.Function0<kotlin.Unit>,kotlin.Unit> telemetryDialog = { onDismissRequest, onMoreInfo, onDisagree, onAgree -> TelemetryDialog(onDismissRequest, onMoreInfo, onDisagree, onAgree) }, kotlin.jvm.functions.Function4<? super kotlin.jvm.functions.Function0<kotlin.Unit>,? super kotlin.jvm.functions.Function0<kotlin.Unit>,? super kotlin.jvm.functions.Function0<kotlin.Unit>,? super java.lang.Boolean,kotlin.Unit> geofencingConsentDialog = { onDismissRequest, onDisagree, onAgree, currentUserConsent -> GeofencingConsentDialog(onDismissRequest, onDisagree, onAgree, currentUserConsent) });
+    method @androidx.compose.runtime.Composable public void Attribution(androidx.compose.ui.Modifier modifier = Modifier, androidx.compose.foundation.layout.PaddingValues contentPadding = PaddingValues(92.dp, 4.dp, 4.dp, 4.dp), androidx.compose.ui.Alignment alignment = androidx.compose.ui.Alignment.Companion.BottomStart, long iconColor = Color(4280192171), kotlin.jvm.functions.Function3<? super java.util.List<com.mapbox.maps.plugin.attribution.Attribution>,? super kotlin.jvm.functions.Function0<kotlin.Unit>,? super kotlin.jvm.functions.Function1<? super com.mapbox.maps.plugin.attribution.Attribution,kotlin.Unit>,kotlin.Unit> attributionDialog = { attributions, onDismissRequest, onAttributionClick -> AttributionDialog(attributions, onDismissRequest, onAttributionClick) }, kotlin.jvm.functions.Function4<? super kotlin.jvm.functions.Function0<kotlin.Unit>,? super kotlin.jvm.functions.Function0<kotlin.Unit>,? super kotlin.jvm.functions.Function0<kotlin.Unit>,? super kotlin.jvm.functions.Function0<kotlin.Unit>,kotlin.Unit> telemetryDialog = { onDismissRequest, onMoreInfo, onDisagree, onAgree -> TelemetryDialog(onDismissRequest, onMoreInfo, onDisagree, onAgree) }, kotlin.jvm.functions.Function4<? super kotlin.jvm.functions.Function0<kotlin.Unit>,? super kotlin.jvm.functions.Function0<kotlin.Unit>,? super kotlin.jvm.functions.Function0<kotlin.Unit>,? super java.lang.Boolean,kotlin.Unit> geofencingConsentDialog = { onDismissRequest, onDisagree, onAgree, currentUserConsent -> GeofencingConsentDialog(onDismissRequest, onDisagree, onAgree, currentUserConsent) });
     method @androidx.compose.runtime.Composable public void AttributionDialog(java.util.List<com.mapbox.maps.plugin.attribution.Attribution> attributions, kotlin.jvm.functions.Function0<kotlin.Unit> onDismissRequest, kotlin.jvm.functions.Function1<? super com.mapbox.maps.plugin.attribution.Attribution,kotlin.Unit> onAttributionClick);
     method @androidx.compose.runtime.Composable public void GeofencingConsentDialog(kotlin.jvm.functions.Function0<kotlin.Unit> onDismissRequest, kotlin.jvm.functions.Function0<kotlin.Unit> onDisagree, kotlin.jvm.functions.Function0<kotlin.Unit> onAgree, boolean currentUserConsent);
     method @androidx.compose.runtime.Composable public void TelemetryDialog(kotlin.jvm.functions.Function0<kotlin.Unit> onDismissRequest, kotlin.jvm.functions.Function0<kotlin.Unit> onMoreInfo, kotlin.jvm.functions.Function0<kotlin.Unit> onDisagree, kotlin.jvm.functions.Function0<kotlin.Unit> onAgree);

extension-compose/src/main/java/com/mapbox/maps/extension/compose/ornaments/attribution/MapAttributionScope.kt

@@ -46,7 +46,6 @@ import androidx.compose.ui.unit.sp
 import androidx.compose.ui.window.DialogProperties
 import com.mapbox.common.geofencing.GeofencingError
 import com.mapbox.maps.MapView
-import com.mapbox.maps.MapboxExperimental
 import com.mapbox.maps.extension.compose.MapboxMapScopeMarker
 import com.mapbox.maps.extension.compose.R
 import com.mapbox.maps.extension.compose.ornaments.attribution.internal.AttributionComposePlugin
@@ -142,8 +141,6 @@ public class MapAttributionScope internal constructor(
    * @param telemetryDialog Defines TelemetryDialog when the Mapbox telemetry is clicked.
    * @param geofencingConsentDialog Defines GeofencingConsentDialog when the Mapbox Geofencing is clicked.
    */
-  @com.mapbox.annotation.MapboxExperimental
-  @MapboxExperimental
   @Composable
   public fun Attribution(
     modifier: Modifier = Modifier,

plugin-attribution/src/main/java/com/mapbox/maps/plugin/attribution/AttributionDialogManagerImpl.kt

@@ -18,7 +18,6 @@ import androidx.appcompat.app.AlertDialog
 import androidx.appcompat.view.ContextThemeWrapper
 import androidx.core.content.ContextCompat
 import com.mapbox.common.geofencing.GeofencingUtilsUserConsentResponseCallback
-import com.mapbox.maps.MapboxExperimental
 import com.mapbox.maps.geofencing.MapGeofencingConsent
 import com.mapbox.maps.logW
 import com.mapbox.maps.module.MapTelemetry
@@ -45,12 +44,10 @@ class AttributionDialogManagerImpl(
   internal var geofencingDialog: AlertDialog? = null
   private var mapAttributionDelegate: MapAttributionDelegate? = null
   private var telemetry: MapTelemetry? = null
-  @OptIn(MapboxExperimental::class)
   private var geofencingConsent: MapGeofencingConsent? = null
   /**
    * Invoked when the map attribution should be shown to the end user
    */
-  @OptIn(MapboxExperimental::class)
   override fun showAttribution(mapAttributionDelegate: MapAttributionDelegate) {
     this.mapAttributionDelegate = mapAttributionDelegate
     this.telemetry = mapAttributionDelegate.telemetry()
@@ -140,7 +137,6 @@ class AttributionDialogManagerImpl(
     telemetryDialog = builder.show()
   }
 
-  @OptIn(MapboxExperimental::class, com.mapbox.annotation.MapboxExperimental::class)
   private fun showGeofencingConsentDialog() {
     val builder = prepareDialogBuilder()
     builder.setTitle(R.string.mapbox_attributionGeofencingTitle)

sdk-base/api/Release/metalava.txt

@@ -763,10 +763,10 @@ package com.mapbox.maps.extension.style {
 
 package com.mapbox.maps.geofencing {
 
-  @com.mapbox.annotation.MapboxExperimental @com.mapbox.maps.MapboxExperimental public interface MapGeofencingConsent {
-    method @com.mapbox.maps.MapboxExperimental public boolean getUserConsent();
-    method @com.mapbox.maps.MapboxExperimental public void setUserConsent(boolean isConsentGiven, com.mapbox.common.geofencing.GeofencingUtilsUserConsentResponseCallback callback);
-    method @com.mapbox.maps.MapboxExperimental public boolean shouldShowConsent();
+  public interface MapGeofencingConsent {
+    method public boolean getUserConsent();
+    method public void setUserConsent(boolean isConsentGiven, com.mapbox.common.geofencing.GeofencingUtilsUserConsentResponseCallback callback);
+    method public boolean shouldShowConsent();
   }
 
 }
@@ -1797,7 +1797,7 @@ package com.mapbox.maps.plugin.attribution {
   }
 
   public final class AttributionParserConfig {
-    ctor public AttributionParserConfig(boolean withImproveMap = true, boolean withCopyrightSign = true, boolean withTelemetryAttribution = true, boolean withMapboxAttribution = true, boolean withMapboxPrivacyPolicy = true, @com.mapbox.maps.MapboxExperimental boolean withMapboxGeofencingConsent = true);
+    ctor public AttributionParserConfig(boolean withImproveMap = true, boolean withCopyrightSign = true, boolean withTelemetryAttribution = true, boolean withMapboxAttribution = true, boolean withMapboxPrivacyPolicy = true, boolean withMapboxGeofencingConsent = true);
     ctor public AttributionParserConfig(boolean withImproveMap = true, boolean withCopyrightSign = true, boolean withTelemetryAttribution = true, boolean withMapboxAttribution = true, boolean withMapboxPrivacyPolicy = true);
     ctor public AttributionParserConfig(boolean withImproveMap = true, boolean withCopyrightSign = true, boolean withTelemetryAttribution = true, boolean withMapboxAttribution = true);
     ctor public AttributionParserConfig(boolean withImproveMap = true, boolean withCopyrightSign = true, boolean withTelemetryAttribution = true);

sdk-base/src/main/java/com/mapbox/maps/geofencing/MapGeofencingConsent.kt

@@ -1,13 +1,10 @@
 package com.mapbox.maps.geofencing
 
 import com.mapbox.common.geofencing.GeofencingUtilsUserConsentResponseCallback
-import com.mapbox.maps.MapboxExperimental
 
 /**
  * Definition of map Geofencing consent utilities
  */
-@com.mapbox.annotation.MapboxExperimental
-@MapboxExperimental
 interface MapGeofencingConsent {
 
   /**
@@ -16,22 +13,19 @@ interface MapGeofencingConsent {
    * @param isConsentGiven true if user consents Geofencing, false if not (this will disable Geofencing).
    * @param callback Callback called when state is updated.
    */
-  @MapboxExperimental
   fun setUserConsent(isConsentGiven: Boolean, callback: GeofencingUtilsUserConsentResponseCallback)
 
   /**
    * Get the Geofencing user consent state.
    *
    * @return `true` if end-user has given consent of Geofencing, `false` otherwise. `true` by default.
    */
-  @MapboxExperimental
   fun getUserConsent(): Boolean
 
   /**
    * Checks if the Geofencing user consent dialog should be shown.
    *
    * @return `true` to show the option to opt-out Geofencing. That is, Geofencing is active or the user revoked the consent.
    */
-  @MapboxExperimental
   fun shouldShowConsent(): Boolean
 }

sdk-base/src/main/java/com/mapbox/maps/plugin/attribution/AttributionParserConfig.kt

@@ -1,7 +1,5 @@
 package com.mapbox.maps.plugin.attribution
 
-import com.mapbox.maps.MapboxExperimental
-
 /**
  * Config class for Attribution
  */
@@ -31,6 +29,5 @@ class AttributionParserConfig @JvmOverloads constructor(
    * Note that the entry will be shown only if the Geofencing is currently active or the user has
    * previously opted out.
    */
-  @MapboxExperimental
   var withMapboxGeofencingConsent: Boolean = true,
 )