[google_maps_flutter] Add documentation

packages/google_maps_flutter/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.5.21+13
+
+* Add documentation.
+
 ## 0.5.21+12
 
 * Update driver tests in the example app to e2e tests.

packages/google_maps_flutter/lib/src/camera.dart

@@ -51,13 +51,19 @@ class CameraPosition {
   /// will be silently clamped to the supported range.
   final double zoom;
 
+  /// Serializes [CameraPosition].
+  ///
+  /// Mainly for internal use when calling [CameraUpdate.newCameraPosition].
   dynamic toMap() => <String, dynamic>{
         'bearing': bearing,
         'target': target._toJson(),
         'tilt': tilt,
         'zoom': zoom,
       };
 
+  /// Deserializes [CameraPosition] from a map.
+  ///
+  /// Mainly for internal use.
   static CameraPosition fromMap(dynamic json) {
     if (json == null) {
       return null;

packages/google_maps_flutter/lib/src/controller.dart

@@ -14,6 +14,10 @@ class GoogleMapController {
     channel.setMethodCallHandler(_handleMethodCall);
   }
 
+  /// Initialize control of a [GoogleMap] with [id].
+  ///
+  /// Mainly for internal use when instantiating a [GoogleMapController] passed
+  /// in [GoogleMap.onMapCreated] callback.
   static Future<GoogleMapController> init(
     int id,
     CameraPosition initialCameraPosition,

packages/google_maps_flutter/lib/src/google_map.dart

@@ -4,6 +4,10 @@
 
 part of google_maps_flutter;
 
+/// Callback method for when the map is ready to be used.
+///
+/// Pass to [GoogleMap.onMapCreated] to receive a [GoogleMapController] when the
+/// map is created.
 typedef void MapCreatedCallback(GoogleMapController controller);
 
 /// Callback that receives updates to the camera position.
@@ -14,6 +18,7 @@ typedef void MapCreatedCallback(GoogleMapController controller);
 /// This is used in [GoogleMap.onCameraMove].
 typedef void CameraPositionCallback(CameraPosition position);
 
+/// A widget which displays a map with data obtained from the Google Maps service.
 class GoogleMap extends StatefulWidget {
   const GoogleMap({
     Key key,
@@ -48,6 +53,9 @@ class GoogleMap extends StatefulWidget {
   })  : assert(initialCameraPosition != null),
         super(key: key);
 
+  /// Callback method for when the map is ready to be used.
+  ///
+  /// Used to receive a [GoogleMapController] for this [GoogleMap].
   final MapCreatedCallback onMapCreated;
 
   /// The initial position of the map's camera.
@@ -179,6 +187,7 @@ class GoogleMap extends StatefulWidget {
   /// were not claimed by any other gesture recognizer.
   final Set<Factory<OneSequenceGestureRecognizer>> gestureRecognizers;
 
+  /// Creates a [State] for this [GoogleMap].
   @override
   State createState() => _GoogleMapState();
 }

packages/google_maps_flutter/lib/src/location.dart

@@ -95,6 +95,7 @@ class LatLngBounds {
     }
   }
 
+  /// Converts a list to [LatLngBounds].
   @visibleForTesting
   static LatLngBounds fromList(dynamic json) {
     if (json == null) {

packages/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.
 author: Flutter Team <flutter-dev@googlegroups.com>
 homepage: https://github.com/flutter/plugins/tree/master/packages/google_maps_flutter
-version: 0.5.21+12
+version: 0.5.21+13
 
 dependencies:
   flutter: