fix: fallback to moveCamera in lite mode for CameraPositionState animate

* Detect Lite Mode configuration from GoogleMapOptions to properly initialize the state
* Fallback to map.moveCamera() instantaneously when animate is called in Lite Mode, which avoids suspending the coroutine indefinitely since animation callbacks are not fired
* Add LiteModeActivity to the sample app to showcase the functionality and test the fallback

Author: kikoso

maps-app/src/main/AndroidManifest.xml

@@ -64,6 +64,9 @@
         <activity
             android:name=".MapsInLazyColumnActivity"
             android:exported="true" />
+        <activity
+            android:name=".LiteModeActivity"
+            android:exported="true" />
         <activity
             android:name=".markerexamples.MarkerClusteringActivity"
             android:exported="true" />

maps-app/src/main/java/com/google/maps/android/compose/Demo.kt

@@ -75,6 +75,11 @@ sealed class ActivityGroup(
                 R.string.basic_map_activity_description,
                 BasicMapActivity::class
             ),
+            Activity(
+                R.string.lite_mode_activity,
+                R.string.lite_mode_activity_description,
+                LiteModeActivity::class
+            ),
             Activity(
                 R.string.street_view_activity,
                 R.string.street_view_activity_description,

maps-app/src/main/java/com/google/maps/android/compose/LiteModeActivity.kt

@@ -0,0 +1,79 @@
+package com.google.maps.android.compose
+
+import android.os.Bundle
+import androidx.activity.ComponentActivity
+import androidx.activity.compose.setContent
+import androidx.activity.enableEdgeToEdge
+import androidx.compose.foundation.layout.Box
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.layout.systemBarsPadding
+import androidx.compose.material3.Button
+import androidx.compose.material3.Text
+import androidx.compose.runtime.getValue
+import androidx.compose.runtime.mutableStateOf
+import androidx.compose.runtime.remember
+import androidx.compose.runtime.rememberCoroutineScope
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.unit.dp
+import com.google.android.gms.maps.CameraUpdateFactory
+import com.google.android.gms.maps.GoogleMapOptions
+import com.google.android.gms.maps.model.CameraPosition
+import com.google.android.gms.maps.model.LatLng
+import com.google.maps.android.compose.theme.MapsComposeSampleTheme
+import kotlinx.coroutines.launch
+
+class LiteModeActivity : ComponentActivity() {
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        enableEdgeToEdge()
+        setContent {
+            MapsComposeSampleTheme {
+                val singapore = remember { LatLng(1.35, 103.87) }
+                val tokyo = remember { LatLng(1.35, 103.87) } // wait let me fix coords below
+                val coroutineScope = rememberCoroutineScope()
+                val cameraPositionState = rememberCameraPositionState {
+                    position = CameraPosition.fromLatLngZoom(singapore, 11f)
+                }
+                val mapProperties by remember {
+                    mutableStateOf(MapProperties(mapType = MapType.NORMAL))
+                }
+
+                Column(
+                    modifier = Modifier.fillMaxSize().systemBarsPadding()
+                ) {
+                    Button(
+                        onClick = {
+                            coroutineScope.launch {
+                                // This would previously hang indefinitely in Lite Mode!
+                                // Now it falls back to instantaneous movement and completes the coroutine.
+                                val newTarget = if (cameraPositionState.position.target == singapore) {
+                                    LatLng(35.6895, 139.6917) // Tokyo
+                                } else {
+                                    singapore
+                                }
+                                cameraPositionState.animate(CameraUpdateFactory.newLatLng(newTarget))
+                            }
+                        },
+                        modifier = Modifier.padding(16.dp)
+                    ) {
+                        Text("Animate Camera (Tests Fix)")
+                    }
+
+                    Box(
+                        modifier = Modifier.weight(1f),
+                    ) {
+                        GoogleMap(
+                            modifier = Modifier.matchParentSize(),
+                            googleMapOptionsFactory = { GoogleMapOptions().liteMode(true) },
+                            cameraPositionState = cameraPositionState,
+                            properties = mapProperties,
+                        )
+                    }
+                }
+            }
+        }
+    }
+}

maps-app/src/main/res/values/strings.xml

@@ -21,6 +21,9 @@
   <string name="basic_map_activity">Basic Map</string>
   <string name="basic_map_activity_description">A simple map showing the default configuration.</string>
 
+  <string name="lite_mode_activity">Lite Mode Map</string>
+  <string name="lite_mode_activity_description">A map showcasing the Lite Mode configuration.</string>
+
   <string name="street_view_activity">Street View</string>
   <string name="street_view_activity_description">A simple Street View.</string>
 

maps-compose/src/main/java/com/google/maps/android/compose/CameraPositionState.kt

@@ -87,6 +87,8 @@ public inline fun rememberCameraPositionState(
 public class CameraPositionState private constructor(
     position: CameraPosition = CameraPosition(LatLng(0.0, 0.0), 0f, 0f, 0f)
 ) {
+    internal var isLiteMode: Boolean = false
+
     /**
      * Whether the camera is currently moving or not. This includes any kind of movement:
      * panning, zooming, or rotation.
@@ -281,6 +283,12 @@ public class CameraPositionState private constructor(
         durationMs: Int,
         continuation: CancellableContinuation<Unit>
     ) {
+        if (isLiteMode) {
+            map.moveCamera(update)
+            continuation.resume(Unit)
+            return
+        }
+
         val cancelableCallback = object : GoogleMap.CancelableCallback {
             override fun onCancel() {
                 continuation.resumeWithException(CancellationException("Animation cancelled"))

maps-compose/src/main/java/com/google/maps/android/compose/GoogleMap.kt

@@ -154,7 +154,9 @@ public fun GoogleMap(
         AndroidView(
             modifier = modifier,
             factory = { context ->
-                mapViewFactory(context, googleMapOptionsFactory()).also { mapView ->
+                val options = googleMapOptionsFactory()
+                cameraPositionState.isLiteMode = options.liteMode == true
+                mapViewFactory(context, options).also { mapView ->
                     val componentCallbacks = object : ComponentCallbacks2 {
                         override fun onConfigurationChanged(newConfig: Configuration) {}