Fix comments

Author: aednlaxer

packages/google_maps_flutter/google_maps_flutter/README.md

@@ -124,10 +124,10 @@ in an unbounded widget will cause the application to throw a Flutter exception.
 <?code-excerpt "readme_sample_advanced_markers.dart (AdvancedMarkersSample)"?>
 ```dart
 body: GoogleMap(
-  // Set your Map Id
+  // Set your Map ID.
   mapId: 'my-map-id',
 
-  // Let map know that you're using Advanced Markers
+  // // Enable support for Advanced Markers.
   markerType: MarkerType.advancedMarker,
 ```
 

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

@@ -9,9 +9,9 @@ import 'main.dart' as main;
 import 'marker_icons.dart';
 import 'page.dart';
 
-/// Page that demonstrates how to use custom [AdvanceMarker] icons
+/// Page that demonstrates how to use custom [AdvanceMarker] icons.
 class AdvancedMarkerIconsPage extends GoogleMapExampleAppPage {
-  /// Default constructor
+  /// Default constructor.
   const AdvancedMarkerIconsPage({Key? key})
       : super(
           key: key,

packages/google_maps_flutter/google_maps_flutter/example/lib/clustering.dart

@@ -30,7 +30,7 @@ class ClusteringBody extends StatefulWidget {
   @override
   State<StatefulWidget> createState() => ClusteringBodyState();
 
-  /// Create a marker that is later added to a cluster
+  /// Creates a marker that is later added to a cluster
   Marker createMarker({
     required MarkerId markerId,
     required ClusterManagerId clusterManagerId,
@@ -47,7 +47,7 @@ class ClusteringBody extends StatefulWidget {
     );
   }
 
-  /// Return selected or unselected state of the given [marker]
+  /// Returns selected or unselected state of the given [marker].
   Marker getSelectedMarker(Marker marker, bool isSelected) {
     return marker.copyWith(
       iconParam: isSelected
@@ -56,7 +56,7 @@ class ClusteringBody extends StatefulWidget {
     );
   }
 
-  /// Return the mapId to use for the GoogleMap
+  /// Returns the mapId to use for the GoogleMap
   String? get mapId => null;
 }
 

packages/google_maps_flutter/google_maps_flutter/example/lib/main.dart

@@ -32,7 +32,7 @@ import 'scrolling_map.dart';
 import 'snapshot.dart';
 import 'tile_overlay.dart';
 
-/// Map Id is required for some examples to use advanced markers
+/// Map ID is required for some examples to use advanced markers.
 // ignore: unnecessary_nullable_for_final_variable_declarations, unreachable_from_main
 const String? mapId = null;
 

packages/google_maps_flutter/google_maps_flutter/example/lib/marker_icons.dart

@@ -31,10 +31,10 @@ class MarkerIconsBody extends StatefulWidget {
   @override
   State<StatefulWidget> createState() => MarkerIconsBodyState();
 
-  /// Return the mapId to use for the GoogleMap
+  /// Returns the mapId to use for the GoogleMap
   String? get mapId => null;
 
-  /// Create a marker to be displayed on the map
+  /// Creates a marker to be displayed on the map
   Marker createMarker(
     MarkerId markerId,
     LatLng position,

packages/google_maps_flutter/google_maps_flutter/example/lib/place_advanced_marker.dart

@@ -9,9 +9,9 @@ import 'main.dart' as main;
 import 'page.dart';
 import 'place_marker.dart';
 
-/// Page demonstrating how to use Advanced [Marker] class
+/// Page demonstrating how to use Advanced [Marker] class.
 class PlaceAdvancedMarkerPage extends GoogleMapExampleAppPage {
-  /// Default constructor
+  /// Default constructor.
   const PlaceAdvancedMarkerPage({Key? key})
       : super(const Icon(Icons.place_outlined), 'Place advanced marker',
             key: key);
@@ -69,7 +69,7 @@ class _PlaceAdvancedMarkerBodyState extends PlaceMarkerBodyState {
   }
 
   /// Whether map supports advanced markers. Null indicates capability check
-  /// is in progress
+  /// is in progress.
   bool? _isAdvancedMarkersAvailable;
 
   @override
@@ -82,7 +82,7 @@ class _PlaceAdvancedMarkerBodyState extends PlaceMarkerBodyState {
           true =>
             'Map capabilities check result:\nthis map supports advanced markers',
           false =>
-            "Map capabilities check result:\nthis map doesn't support advanced markers. Please check that map Id is provided and correct map renderer is used",
+            "Map capabilities check result:\nthis map doesn't support advanced markers. Please check that map ID is provided and correct map renderer is used",
         },
         textAlign: TextAlign.center,
         style: Theme.of(context).textTheme.bodyLarge?.copyWith(
@@ -98,7 +98,7 @@ class _PlaceAdvancedMarkerBodyState extends PlaceMarkerBodyState {
 
   @override
   Widget build(BuildContext context) {
-    // Check if map is capable of showing advanced markers
+    // Check if map is capable of showing advanced markers.
     if (controller != null) {
       GoogleMapsFlutterPlatform.instance
           .isAdvancedMarkersAvailable(mapId: controller!.mapId)

packages/google_maps_flutter/google_maps_flutter/example/lib/place_marker.dart

@@ -270,10 +270,10 @@ class PlaceMarkerBodyState extends State<PlaceMarkerBody> {
     return BytesMapBitmap(bytes.buffer.asUint8List());
   }
 
-  /// Return the mapId to use for the GoogleMap
+  /// Returns the mapId to use for the GoogleMap
   String? get mapId => null;
 
-  /// Create a marker with given parameters
+  /// Creates a marker with given parameters
   Marker createMarker({
     required MarkerId markerId,
     required LatLng position,
@@ -292,7 +292,7 @@ class PlaceMarkerBodyState extends State<PlaceMarkerBody> {
     );
   }
 
-  /// Perform customizations of the [marker] to mark it as selected or not
+  /// Performs customizations of the [marker] to mark it as selected or not.
   Marker getSelectedMarker(Marker marker, bool isSelected) {
     return marker.copyWith(
       iconParam: isSelected
@@ -301,7 +301,7 @@ class PlaceMarkerBodyState extends State<PlaceMarkerBody> {
     );
   }
 
-  /// Optional header to be displayed above the map
+  /// Returns a header to be displayed above the map.
   Widget getHeader() => const SizedBox.shrink();
 
   @override

packages/google_maps_flutter/google_maps_flutter/example/lib/readme_sample_advanced_markers.dart

@@ -35,10 +35,10 @@ class AdvancedMarkersSample extends StatelessWidget {
     return const Scaffold(
 // #docregion AdvancedMarkersSample
       body: GoogleMap(
-        // Set your Map Id
+        // Set your Map ID.
         mapId: 'my-map-id',
 
-        // Let map know that you're using Advanced Markers
+        // Enable support for Advanced Markers.
         markerType: MarkerType.advancedMarker,
 // #enddocregion AdvancedMarkersSample
         initialCameraPosition: _kGooglePlex,

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

@@ -129,7 +129,7 @@ class GoogleMap extends StatefulWidget {
     this.onLongPress,
     this.mapId,
     this.markerType = MarkerType.marker,
-    @Deprecated('cloudMapId is deprecated. Use mapId instead') this.cloudMapId,
+    @Deprecated('cloudMapId is deprecated. Use mapId instead.') this.cloudMapId,
   });
 
   /// Callback method for when the map is ready to be used.
@@ -361,7 +361,7 @@ class GoogleMap extends StatefulWidget {
   ///
   /// See https://developers.google.com/maps/documentation/get-map-id
   /// for more details.
-  @Deprecated('cloudMapId is deprecated. Use mapId instead')
+  @Deprecated('cloudMapId is deprecated. Use mapId instead.')
   final String? cloudMapId;
 
   /// Indicates whether map should use [AdvancedMarker]s or [Marker]s.

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

@@ -107,8 +107,8 @@ void addClusterManager(String clusterManagerId) {
   }
 
   /**
-   * Initialize cluster renderer if it hasn't been initialized before. ClusterManager uses default
-   * renderer which should be changed to (legacy) renderer or advanced renderer
+   * Initializes cluster renderer if it hasn't been initialized before. ClusterManager uses default
+   * renderer which should be changed to (legacy) renderer or advanced renderer.
    */
   private void initializeRenderer(ClusterManager<MarkerBuilder> clusterManager) {
     final ClusterRenderer<MarkerBuilder> renderer = clusterManager.getRenderer();
@@ -256,7 +256,7 @@ protected void onClusterItemRendered(@NonNull T item, @NonNull Marker marker) {
     }
   }
 
-  /** AdvancedMarkerClusterRenderer is a ClusterRenderer that supports AdvancedMarkers */
+  /** AdvancedMarkerClusterRenderer is a ClusterRenderer that supports AdvancedMarkers. */
   @VisibleForTesting
   static class AdvancedMarkerClusterRenderer<T extends MarkerBuilder>
       extends DefaultAdvancedMarkersClusterRenderer<T> {