[google_maps_flutter] Add Advanced Markers support

packages/google_maps_flutter/google_maps_flutter/README.md

@@ -116,6 +116,24 @@ the `GoogleMap`'s `onMapCreated` callback.
 The `GoogleMap` widget should be used within a widget with a bounded size. Using it
 in an unbounded widget will cause the application to throw a Flutter exception.
 
+### Advanced Markers
+
+[Advanced Markers](https://developers.google.com/maps/documentation/javascript/advanced-markers/overview) 
+are map markers that offer extra customization options. 
+[Map ID](https://developers.google.com/maps/documentation/get-map-id) is 
+required in order to use Advanced Markers:
+
+<?code-excerpt "readme_sample_advanced_markers.dart (AdvancedMarkersSample)"?>
+```dart
+body: GoogleMap(
+  // Set your Map ID.
+  mapId: 'my-map-id',
+  // Enable support for Advanced Markers.
+  markerType: GoogleMapMarkerType.advancedMarker,
+  initialCameraPosition: _kGooglePlex,
+),
+```
+
 ### Sample Usage
 
 <?code-excerpt "readme_sample.dart (MapSample)"?>

packages/google_maps_flutter/google_maps_flutter/example/integration_test/src/maps_controller.dart

@@ -562,7 +562,7 @@ void runTests() {
           onMapCreated: (GoogleMapController controller) {
             mapIdCompleter.complete(controller.mapId);
           },
-          cloudMapId: kCloudMapId,
+          cloudMapId: kMapId,
         ),
       );
       await tester.pumpAndSettle();

packages/google_maps_flutter/google_maps_flutter/example/integration_test/src/shared.dart

@@ -20,7 +20,7 @@ const CameraPosition kInitialCameraPosition =
     CameraPosition(target: kInitialMapCenter, zoom: kInitialZoomLevel);
 
 // Dummy map ID
-const String kCloudMapId = '000000000000000'; // Dummy map ID.
+const String kMapId = '000000000000000'; // Dummy map ID.
 
 /// True if the test is running in an iOS device
 final bool isIOS = defaultTargetPlatform == TargetPlatform.iOS;

packages/google_maps_flutter/google_maps_flutter/example/lib/advanced_marker_icons.dart

@@ -0,0 +1,162 @@
+// Copyright 2013 The Flutter Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+import 'package:flutter/material.dart';
+import 'package:google_maps_flutter/google_maps_flutter.dart';
+import 'package:google_maps_flutter_platform_interface/google_maps_flutter_platform_interface.dart';
+
+import 'page.dart';
+import 'place_advanced_marker.dart';
+
+/// Page that demonstrates how to use custom [AdvanceMarker] icons.
+class AdvancedMarkerIconsPage extends GoogleMapExampleAppPage {
+  /// Default constructor.
+  const AdvancedMarkerIconsPage({
+    Key? key,
+    required this.mapId,
+  }) : super(
+          key: key,
+          const Icon(Icons.image_outlined),
+          'Advanced marker icons',
+        );
+
+  /// Map ID to use for the GoogleMap.
+  final String? mapId;
+
+  @override
+  Widget build(BuildContext context) {
+    return _AdvancedMarkerIconsBody(mapId: mapId);
+  }
+}
+
+const LatLng _kMapCenter = LatLng(52.4478, -3.5402);
+
+class _AdvancedMarkerIconsBody extends StatefulWidget {
+  const _AdvancedMarkerIconsBody({required this.mapId});
+
+  /// Map ID to use for the GoogleMap.
+  final String? mapId;
+
+  @override
+  State<_AdvancedMarkerIconsBody> createState() =>
+      _AdvancedMarkerIconsBodyState();
+}
+
+class _AdvancedMarkerIconsBodyState extends State<_AdvancedMarkerIconsBody> {
+  final Set<AdvancedMarker> _markers = <AdvancedMarker>{};
+
+  GoogleMapController? controller;
+
+  @override
+  Widget build(BuildContext context) {
+    return Column(
+      children: <Widget>[
+        AdvancedMarkersCapabilityStatus(controller: controller),
+        Expanded(
+          child: GoogleMap(
+            mapId: widget.mapId,
+            markerType: GoogleMapMarkerType.advancedMarker,
+            initialCameraPosition: const CameraPosition(
+              target: _kMapCenter,
+              zoom: 7.0,
+            ),
+            markers: _markers,
+            onMapCreated: (GoogleMapController controller) {
+              setState(() {
+                this.controller = controller;
+              });
+            },
+          ),
+        ),
+        Padding(
+          padding: const EdgeInsets.all(16),
+          child: TextButton(
+            onPressed: _markers.isNotEmpty
+                ? null
+                : () async {
+                    final AssetMapBitmap asset = await BitmapDescriptor.asset(
+                      const ImageConfiguration(
+                        size: Size(12, 12),
+                      ),
+                      'assets/red_square.png',
+                    );
+                    final AssetMapBitmap largeAsset =
+                        await BitmapDescriptor.asset(
+                      const ImageConfiguration(
+                        size: Size(36, 36),
+                      ),
+                      'assets/red_square.png',
+                    );
+
+                    setState(() {
+                      _markers.addAll(<AdvancedMarker>[
+                        // Default icon
+                        AdvancedMarker(
+                          markerId: const MarkerId('1'),
+                          position: LatLng(
+                            _kMapCenter.latitude + 1,
+                            _kMapCenter.longitude + 1,
+                          ),
+                        ),
+                        // Custom pin colors
+                        AdvancedMarker(
+                          markerId: const MarkerId('2'),
+                          position: LatLng(
+                            _kMapCenter.latitude - 1,
+                            _kMapCenter.longitude - 1,
+                          ),
+                          icon: BitmapDescriptor.pinConfig(
+                            borderColor: Colors.red,
+                            backgroundColor: Colors.black,
+                            glyph: const CircleGlyph(color: Colors.red),
+                          ),
+                        ),
+                        // Pin with text
+                        AdvancedMarker(
+                          markerId: const MarkerId('3'),
+                          position: LatLng(
+                            _kMapCenter.latitude - 1,
+                            _kMapCenter.longitude + 1,
+                          ),
+                          icon: BitmapDescriptor.pinConfig(
+                            borderColor: Colors.blue,
+                            backgroundColor: Colors.white,
+                            glyph: const TextGlyph(
+                              text: 'Hi!',
+                              textColor: Colors.blue,
+                            ),
+                          ),
+                        ),
+                        // Pin with bitmap
+                        AdvancedMarker(
+                          markerId: const MarkerId('4'),
+                          position: LatLng(
+                            _kMapCenter.latitude + 1,
+                            _kMapCenter.longitude - 1,
+                          ),
+                          icon: BitmapDescriptor.pinConfig(
+                            borderColor: Colors.red,
+                            backgroundColor: Colors.white,
+                            glyph: BitmapGlyph(bitmap: asset),
+                          ),
+                        ),
+                        // Custom marker icon
+                        AdvancedMarker(
+                          markerId: const MarkerId('5'),
+                          position: LatLng(
+                            _kMapCenter.latitude,
+                            _kMapCenter.longitude,
+                          ),
+                          icon: largeAsset,
+                        ),
+                      ]);
+                    });
+                  },
+            child: const Text('Add advanced markers'),
+          ),
+        ),
+      ],
+    );
+  }
+}