[maps-android] utilize duration when OverviewViewportStateOptions.animationDurationMs is set (#9505)

GitOrigin-RevId: b8c3e1e69c3ecf03fd9b9e8790a67e2e24082d0c

Author: natiginfo

CHANGELOG.md

@@ -13,6 +13,7 @@ Mapbox welcomes participation and contributions from everyone.
 
 ## Bug fixes 🐞
 * Fix rare scenario where map render surface size was wrong.
+* Respect `animationDurationMs` when custom `OverviewViewportStateOptions.animationDurationMs` is set.
 
 
 # 11.18.0 January 15, 2026

compose-app/src/main/java/com/mapbox/maps/compose/testapp/examples/animation/MapViewportAnimationsActivity.kt

@@ -104,6 +104,7 @@ public class MapViewportAnimationsActivity : ComponentActivity() {
                           )
                         )
                       )
+                      .animationDurationMs(600L)
                       .padding(EdgeInsets(100.0, 100.0, 100.0, 100.0))
                       .build(),
                     defaultTransitionOptions = DefaultViewportTransitionOptions.Builder()

plugin-viewport/src/main/kotlin/com/mapbox/maps/plugin/viewport/transition/DefaultViewportTransitionImpl.kt

@@ -15,7 +15,9 @@ import com.mapbox.maps.plugin.animation.animator.CameraAnimator
 import com.mapbox.maps.plugin.animation.camera
 import com.mapbox.maps.plugin.delegates.MapDelegateProvider
 import com.mapbox.maps.plugin.viewport.CompletionListener
+import com.mapbox.maps.plugin.viewport.DEFAULT_STATE_ANIMATION_DURATION_MS
 import com.mapbox.maps.plugin.viewport.data.DefaultViewportTransitionOptions
+import com.mapbox.maps.plugin.viewport.state.OverviewViewportState
 import com.mapbox.maps.plugin.viewport.state.ViewportState
 import com.mapbox.maps.threading.AnimationThreadController
 import com.mapbox.maps.util.MathUtils
@@ -68,7 +70,7 @@ internal class DefaultViewportTransitionImpl(
         startCamera,
         cameraOptions
       ) ?: kotlin.run {
-        val initialAnimatorSet = createAnimatorSet(cameraOptions, options.maxDurationMs)
+        val initialAnimatorSet = createAnimatorSet(to, cameraOptions, options.maxDurationMs)
           .apply {
             addListener(
               object : Animator.AnimatorListener {
@@ -133,7 +135,25 @@ internal class DefaultViewportTransitionImpl(
     }
   }
 
-  private fun createAnimatorSet(cameraOptions: CameraOptions, maxDurationMs: Long): AnimatorSet {
+  private fun createAnimatorSet(
+    targetState: ViewportState,
+    cameraOptions: CameraOptions,
+    maxDurationMs: Long
+  ): AnimatorSet {
+    // If transitioning to OverviewViewportState and user has explicitly customized animationDurationMs,
+    // animate using that value. Otherwise, use default animation logic.
+    if (targetState is OverviewViewportState) {
+      val overviewDuration = targetState.options.animationDurationMs
+
+      // Only use linear animation if user explicitly set a different duration from default.
+      // If user did not customize duration, then we will fallback to default animation logic
+      if (overviewDuration != DEFAULT_STATE_ANIMATION_DURATION_MS) {
+        // Use the state's animation duration, but still respect maxDurationMs as an upper bound
+        val effectiveDuration = minOf(overviewDuration, maxDurationMs)
+        return transitionFactory.transitionLinear(cameraOptions, effectiveDuration)
+      }
+    }
+
     val currentZoom = cameraDelegate.cameraState.zoom
     return with(transitionFactory) {
       if (currentZoom < (cameraOptions.zoom ?: currentZoom)) {

sdk-base/src/main/java/com/mapbox/maps/plugin/viewport/data/OverviewViewportStateOptions.kt

@@ -58,6 +58,11 @@ class OverviewViewportStateOptions private constructor(
    * The length of the animation performed in milliseconds by [OverviewViewportState] when it starts
    * updating the camera and anytime [OverviewViewportState.options] is set.
    *
+   * When set to a custom value, transitions will use fixed-duration linear animations that take
+   * exactly the specified duration regardless of distance. This provides predictable timing but
+   * may result in very fast camera movement for large distances. Consider using longer durations
+   * or keeping the default value if animating over large geographic areas.
+   *
    * @see [OverviewViewportState.options] for details.
    *
    * Defaults to [DEFAULT_STATE_ANIMATION_DURATION_MS] milliseconds
@@ -177,6 +182,11 @@ class OverviewViewportStateOptions private constructor(
      * The length of the animation performed by [OverviewViewportState] when it starts updating the
      * camera and anytime [OverviewViewportState.options] is set.
      *
+     * When set to a custom value, transitions will use fixed-duration linear animations that take
+     * exactly the specified duration regardless of distance. This provides predictable timing but
+     * may result in very fast camera movement for large distances. Consider using longer durations
+     * or keeping the default value if animating over large geographic areas.
+     *
      * @see [OverviewViewportState.options] for details.
      *
      * Defaults to [DEFAULT_STATE_ANIMATION_DURATION_MS] milliseconds