[google_maps_flutter] Replace deprecated APIs (flutter#10474)

This fixes two sets of API deprecations:
- Within the package, cloudMapId was deprecated in the platform interface, and replaced with mapId. This updates everything that's not client-facing to use the mapId name instead (except for local variables in native code, where it ensure there's no potential confusion with the plugin-level map ID that tracks map instances in the plugin).
- `Color.value` is deprecated. Rather than just replace it with `toARGB()`, this adds structured data to the Pigeon interface, so that it's not relying on magic knowledge on both sides of the interface that the ints are ARGB:
  - On Android, where the native SDK color representation is just a 32-bit ARGB, this adds a wrapper class to make that explicit in the Pigeon API surface.
  - On iOS, where `UIColor` uses four doubles, this passes the underlying `Color` doubles directly via the wrapper class, so that it's not lossy.
  - For legacy JSON representation still used for heatmaps, it just continues to use the equivalent `toARGB()`. That will change once heatmaps are converted to Pigeon.

This also annotates a couple of intentional internal uses of the deprecated `legacy` renderer type so that it won't show up in future repository deprecation audits.

Also pays down some tech debt by renaming the now-very-poorly-named FLTGoogleMapJSONConversions.* file to FGMConversionUtils, since it is now mostly Pigeon type conversions. It also renames the legacy FLTGoogleMapJSONConversions bag-of-class-methods class to reflect that it is now only used for heatmaps, the last type that still uses JSON serialization in the Pigeon interface
(flutter/flutter#117907).

Part of flutter/flutter#159739

## 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.

Author: stuartmorgan-g

packages/google_maps_flutter/google_maps_flutter/CHANGELOG.md

@@ -1,5 +1,6 @@
-## NEXT
+## 2.14.1
 
+* Replaces internal use of deprecated methods.
 * Updates minimum supported SDK version to Flutter 3.32/Dart 3.8.
 
 ## 2.14.0

packages/google_maps_flutter/google_maps_flutter/example/lib/map_map_id.dart

@@ -54,6 +54,7 @@ class MapIdBodyState extends State<MapIdBody> {
     switch (_initializedRenderer) {
       case AndroidMapRenderer.latest:
         return 'latest';
+      // ignore: deprecated_member_use
       case AndroidMapRenderer.legacy:
         return 'legacy';
       case AndroidMapRenderer.platformDefault:

packages/google_maps_flutter/google_maps_flutter/lib/src/google_map.dart

@@ -723,7 +723,7 @@ MapConfiguration _configurationFromMapWidget(GoogleMap map) {
     indoorViewEnabled: map.indoorViewEnabled,
     trafficEnabled: map.trafficEnabled,
     buildingsEnabled: map.buildingsEnabled,
-    cloudMapId: map.cloudMapId,
+    mapId: map.cloudMapId,
     // A null style in the widget means no style, which is expressed as '' in
     // the configuration to distinguish from no change (null).
     style: map.style ?? '',

packages/google_maps_flutter/google_maps_flutter/pubspec.yaml

@@ -2,7 +2,7 @@ name: google_maps_flutter
 description: A Flutter plugin for integrating Google Maps in iOS and Android applications.
 repository: https://github.com/flutter/packages/tree/main/packages/google_maps_flutter/google_maps_flutter
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+maps%22
-version: 2.14.0
+version: 2.14.1
 
 environment:
   sdk: ^3.8.0

packages/google_maps_flutter/google_maps_flutter_android/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 2.18.7
+
+* Replaces internal use of deprecated methods.
+
 ## 2.18.6
 
 * Bumps com.android.tools.build:gradle from 8.12.1 to 8.13.1.

packages/google_maps_flutter/google_maps_flutter_android/android/src/main/java/io/flutter/plugins/googlemaps/Convert.java

@@ -627,8 +627,8 @@ static String interpretPolygonOptions(Messages.PlatformPolygon polygon, PolygonO
     sink.setConsumeTapEvents(polygon.getConsumesTapEvents());
     sink.setGeodesic(polygon.getGeodesic());
     sink.setVisible(polygon.getVisible());
-    sink.setFillColor(polygon.getFillColor().intValue());
-    sink.setStrokeColor(polygon.getStrokeColor().intValue());
+    sink.setFillColor(polygon.getFillColor().getArgbValue().intValue());
+    sink.setStrokeColor(polygon.getStrokeColor().getArgbValue().intValue());
     sink.setStrokeWidth(polygon.getStrokeWidth());
     sink.setZIndex(polygon.getZIndex());
     sink.setPoints(pointsFromPigeon(polygon.getPoints()));
@@ -654,7 +654,7 @@ static String interpretPolylineOptions(
       AssetManager assetManager,
       float density) {
     sink.setConsumeTapEvents(polyline.getConsumesTapEvents());
-    sink.setColor(polyline.getColor().intValue());
+    sink.setColor(polyline.getColor().getArgbValue().intValue());
     sink.setEndCap(capFromPigeon(polyline.getEndCap(), assetManager, density));
     sink.setStartCap(capFromPigeon(polyline.getStartCap(), assetManager, density));
     sink.setGeodesic(polyline.getGeodesic());
@@ -669,8 +669,8 @@ static String interpretPolylineOptions(
 
   static String interpretCircleOptions(Messages.PlatformCircle circle, CircleOptionsSink sink) {
     sink.setConsumeTapEvents(circle.getConsumeTapEvents());
-    sink.setFillColor(circle.getFillColor().intValue());
-    sink.setStrokeColor(circle.getStrokeColor().intValue());
+    sink.setFillColor(circle.getFillColor().getArgbValue().intValue());
+    sink.setStrokeColor(circle.getStrokeColor().getArgbValue().intValue());
     sink.setStrokeWidth(circle.getStrokeWidth());
     sink.setZIndex(circle.getZIndex().floatValue());
     sink.setCenter(toLatLng(circle.getCenter().toList()));

packages/google_maps_flutter/google_maps_flutter_android/android/src/main/java/io/flutter/plugins/googlemaps/GoogleMapFactory.java

@@ -48,7 +48,7 @@ public PlatformView create(@NonNull Context context, int id, @Nullable Object ar
     builder.setInitialTileOverlays(params.getInitialTileOverlays());
     builder.setInitialGroundOverlays(params.getInitialGroundOverlays());
 
-    final String cloudMapId = mapConfig.getCloudMapId();
+    final String cloudMapId = mapConfig.getMapId();
     if (cloudMapId != null) {
       builder.setMapId(cloudMapId);
     }