[google_maps_flutter] Add color scheme support to platform interface (#11278)

stuartmorgan-g · web-flow · commit 2fbf78d1099c · 2026-03-18T13:55:36.000Z
Platform interface portion of #10471 Part of flutter/flutter#176445 ## Pre-Review Checklist [^1]: Regular contributors who have demonstrated familiarity with the repository guidelines only need to comment if the PR is not auto-exempted by repo tooling.
diff --git a/packages/google_maps_flutter/google_maps_flutter_platform_interface/CHANGELOG.md b/packages/google_maps_flutter/google_maps_flutter_platform_interface/CHANGELOG.md
@@ -1,3 +1,7 @@
+## 2.15.0
+
+* Adds support for `colorScheme` for cloud-based maps styling brightness in web.
+
 ## 2.14.2
 
 * Adds documentation about iOS rendering issue with `PinConfig`.
diff --git a/packages/google_maps_flutter/google_maps_flutter_platform_interface/lib/src/types/map_color_scheme.dart b/packages/google_maps_flutter/google_maps_flutter_platform_interface/lib/src/types/map_color_scheme.dart
@@ -0,0 +1,15 @@
+// Copyright 2013 The Flutter Authors
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+/// The color scheme of the map to be used with cloud styles.
+enum MapColorScheme {
+  /// The light color scheme for the map.
+  light,
+
+  /// The dark color scheme for the map.
+  dark,
+
+  /// The system default color scheme for the map.
+  followSystem,
+}
diff --git a/packages/google_maps_flutter/google_maps_flutter_platform_interface/lib/src/types/map_configuration.dart b/packages/google_maps_flutter/google_maps_flutter_platform_interface/lib/src/types/map_configuration.dart
@@ -42,6 +42,7 @@ class MapConfiguration {
     String? cloudMapId,
     this.style,
     this.markerType,
+    this.colorScheme,
   }) : mapId = mapId ?? cloudMapId;
 
   /// This setting controls how the API handles gestures on the map. Web only.
@@ -143,6 +144,11 @@ class MapConfiguration {
   /// used.
   final MarkerType? markerType;
 
+  /// Preferred color scheme for the cloud-styled map. Web only.
+  ///
+  /// See https://developers.google.com/maps/documentation/javascript/mapcolorscheme for more details.
+  final MapColorScheme? colorScheme;
+
   /// Identifier that's associated with a specific cloud-based map style.
   ///
   /// See https://developers.google.com/maps/documentation/get-map-id
@@ -227,6 +233,7 @@ class MapConfiguration {
       mapId: mapId != other.mapId ? mapId : null,
       style: style != other.style ? style : null,
       markerType: markerType != other.markerType ? markerType : null,
+      colorScheme: colorScheme != other.colorScheme ? colorScheme : null,
     );
   }
 
@@ -265,6 +272,7 @@ class MapConfiguration {
       mapId: diff.mapId ?? mapId,
       style: diff.style ?? style,
       markerType: diff.markerType ?? markerType,
+      colorScheme: diff.colorScheme ?? colorScheme,
     );
   }
 
@@ -294,7 +302,8 @@ class MapConfiguration {
       buildingsEnabled == null &&
       mapId == null &&
       style == null &&
-      markerType == null;
+      markerType == null &&
+      colorScheme == null;
 
   @override
   bool operator ==(Object other) {
@@ -329,7 +338,8 @@ class MapConfiguration {
         buildingsEnabled == other.buildingsEnabled &&
         mapId == other.mapId &&
         style == other.style &&
-        markerType == other.markerType;
+        markerType == other.markerType &&
+        colorScheme == other.colorScheme;
   }
 
   @override
@@ -359,6 +369,7 @@ class MapConfiguration {
     mapId,
     style,
     markerType,
+    colorScheme,
   ]);
 }
 
diff --git a/packages/google_maps_flutter/google_maps_flutter_platform_interface/lib/src/types/types.dart b/packages/google_maps_flutter/google_maps_flutter_platform_interface/lib/src/types/types.dart
@@ -19,6 +19,7 @@ export 'heatmap.dart';
 export 'heatmap_updates.dart';
 export 'joint_type.dart';
 export 'location.dart';
+export 'map_color_scheme.dart';
 export 'map_configuration.dart';
 export 'map_objects.dart';
 export 'map_widget_configuration.dart';
diff --git a/packages/google_maps_flutter/google_maps_flutter_platform_interface/pubspec.yaml b/packages/google_maps_flutter/google_maps_flutter_platform_interface/pubspec.yaml
@@ -4,7 +4,7 @@ repository: https://github.com/flutter/packages/tree/main/packages/google_maps_f
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+maps%22
 # NOTE: We strongly prefer non-breaking changes, even at the expense of a
 # less-clean API. See https://flutter.dev/go/platform-interface-breaking-changes
-version: 2.14.2
+version: 2.15.0
 
 environment:
   sdk: ^3.9.0
diff --git a/packages/google_maps_flutter/google_maps_flutter_platform_interface/test/types/map_configuration_test.dart b/packages/google_maps_flutter/google_maps_flutter_platform_interface/test/types/map_configuration_test.dart
@@ -485,6 +485,22 @@ void main() {
       // The hash code should change.
       expect(empty.hashCode, isNot(diff.hashCode));
     });
+
+    test('handle colorScheme', () async {
+      const diff = MapConfiguration(colorScheme: MapColorScheme.followSystem);
+
+      const empty = MapConfiguration();
+      final MapConfiguration updated = diffBase.applyDiff(diff);
+
+      // A diff applied to empty options should be the diff itself.
+      expect(empty.applyDiff(diff), diff);
+      // The diff from empty options should be the diff itself.
+      expect(diff.diffFrom(empty), diff);
+      // A diff applied to non-empty options should update that field.
+      expect(updated.colorScheme, MapColorScheme.followSystem);
+      // The hash code should change.
+      expect(empty.hashCode, isNot(diff.hashCode));
+    });
   });
 
   group('isEmpty', () {
@@ -641,5 +657,11 @@ void main() {
 
       expect(diff.isEmpty, false);
     });
+
+    test('is false with colorScheme', () async {
+      const diff = MapConfiguration(colorScheme: MapColorScheme.followSystem);
+
+      expect(diff.isEmpty, false);
+    });
   });
 }
