[google_maps_flutter_platform_interface] Convert PatternItem and Cap to typesafe structures.

packages/google_maps_flutter/google_maps_flutter_platform_interface/CHANGELOG.md

@@ -1,3 +1,8 @@
+## 2.9.3
+
+* Converts `PatternItem` to typesafe structure.
+* Converts `Cap` to typesafe structure.
+
 ## 2.9.2
 
 * Corrects JSON tag for `CameraUpdateNewLatLngBounds`.

packages/google_maps_flutter/google_maps_flutter_platform_interface/lib/src/types/cap.dart

@@ -6,27 +6,56 @@ import 'package:flutter/foundation.dart' show immutable;
 
 import 'types.dart';
 
+/// Enumeration of possible types of caps.
+enum CapType {
+  /// Cap that is squared off exactly at the start or end vertex of a [Polyline]
+  /// with solid stroke pattern, equivalent to having no additional cap beyond
+  /// the start or end vertex.
+  butt,
+
+  /// Cap that is a semicircle with radius equal to half the stroke width,
+  /// centered at the start or end vertex of a [Polyline] with solid stroke
+  /// pattern.
+  round,
+
+  /// Cap that is squared off after extending half the stroke width beyond the
+  /// start or end vertex of a [Polyline] with solid stroke pattern.
+  square,
+
+  /// CustomCap with a bitmap overlay centered at the start or
+  /// end vertex of a [Polyline], orientated according to the direction of the line's
+  /// first or last edge and scaled with respect to the line's stroke width.
+  custom,
+}
+
+String _capTypeToJson(CapType capType) => <CapType, String>{
+      CapType.butt: 'buttCap',
+      CapType.round: 'roundCap',
+      CapType.square: 'squareCap',
+      CapType.custom: 'customCap',
+    }[capType]!;
+
 /// Cap that can be applied at the start or end vertex of a [Polyline].
 @immutable
 class Cap {
-  const Cap._(this._json);
+  const Cap._(this.capType);
 
   /// Cap that is squared off exactly at the start or end vertex of a [Polyline]
   /// with solid stroke pattern, equivalent to having no additional cap beyond
   /// the start or end vertex.
   ///
   /// This is the default cap type at start and end vertices of Polylines with
   /// solid stroke pattern.
-  static const Cap buttCap = Cap._(<Object>['buttCap']);
+  static const Cap buttCap = Cap._(CapType.butt);
 
   /// Cap that is a semicircle with radius equal to half the stroke width,
   /// centered at the start or end vertex of a [Polyline] with solid stroke
   /// pattern.
-  static const Cap roundCap = Cap._(<Object>['roundCap']);
+  static const Cap roundCap = Cap._(CapType.round);
 
   /// Cap that is squared off after extending half the stroke width beyond the
   /// start or end vertex of a [Polyline] with solid stroke pattern.
-  static const Cap squareCap = Cap._(<Object>['squareCap']);
+  static const Cap squareCap = Cap._(CapType.square);
 
   /// Constructs a new CustomCap with a bitmap overlay centered at the start or
   /// end vertex of a [Polyline], orientated according to the direction of the line's
@@ -44,11 +73,36 @@ class Cap {
     double refWidth = 10,
   }) {
     assert(refWidth > 0.0);
-    return Cap._(<Object>['customCap', bitmapDescriptor.toJson(), refWidth]);
+    return CustomCap(bitmapDescriptor, refWidth: refWidth);
   }
 
-  final Object _json;
+  /// The type of rendering used for the cap at a start or end vertex of a
+  /// [Polyline].
+  final CapType capType;
 
   /// Converts this object to something serializable in JSON.
-  Object toJson() => _json;
+  Object toJson() => <Object>[_capTypeToJson(capType)];
+}
+
+/// CustomCap with a bitmap overlay centered at the start or
+/// end vertex of a [Polyline], orientated according to the direction of the line's
+/// first or last edge and scaled with respect to the line's stroke width.
+class CustomCap extends Cap {
+  /// [bitmapDescriptor] must not be null.
+  ///
+  /// [refWidth] is the reference stroke width (in pixels) - the stroke width for which
+  /// the cap bitmap at its native dimension is designed. Must be positive. Default value
+  /// is 10 pixels.
+  const CustomCap(this.bitmapDescriptor, {this.refWidth = 10})
+      : super._(CapType.custom);
+
+  /// Bitmap overlay centered at the start or end vertex of a [Polyline].
+  final BitmapDescriptor bitmapDescriptor;
+
+  /// Reference stroke width in pixels.
+  final double refWidth;
+
+  @override
+  Object toJson() =>
+      <Object>[_capTypeToJson(capType), bitmapDescriptor.toJson(), refWidth];
 }

packages/google_maps_flutter/google_maps_flutter_platform_interface/lib/src/types/pattern_item.dart

@@ -4,32 +4,58 @@
 
 import 'package:flutter/foundation.dart' show immutable;
 
+/// Enumeration of types of pattern items.
+enum PatternItemType {
+  /// A dot used in the stroke pattern for a [Polyline].
+  dot,
+
+  /// A dash used in the stroke pattern for a [Polyline].
+  dash,
+
+  /// A gap used in the stroke pattern for a [Polyline].
+  gap,
+}
+
+String _patternItemTypeToJson(PatternItemType itemType) =>
+    const <PatternItemType, String>{
+      PatternItemType.dot: 'dot',
+      PatternItemType.dash: 'dash',
+      PatternItemType.gap: 'gap',
+    }[itemType]!;
+
 /// Item used in the stroke pattern for a Polyline.
 @immutable
 class PatternItem {
-  const PatternItem._(this._json);
+  const PatternItem._(this.patternItemType, [this.length]);
 
   /// A dot used in the stroke pattern for a [Polyline].
-  static const PatternItem dot = PatternItem._(<Object>['dot']);
+  static const PatternItem dot = PatternItem._(PatternItemType.dot);
 
   /// A dash used in the stroke pattern for a [Polyline].
   ///
   /// [length] has to be non-negative.
   static PatternItem dash(double length) {
     assert(length >= 0.0);
-    return PatternItem._(<Object>['dash', length]);
+    return PatternItem._(PatternItemType.dash, length);
   }
 
   /// A gap used in the stroke pattern for a [Polyline].
   ///
   /// [length] has to be non-negative.
   static PatternItem gap(double length) {
     assert(length >= 0.0);
-    return PatternItem._(<Object>['gap', length]);
+    return PatternItem._(PatternItemType.gap, length);
   }
 
-  final Object _json;
+  /// The type of rendering used for an item in a pattern.
+  final PatternItemType patternItemType;
+
+  /// The length in pixels of a dash or gap.
+  final double? length;
 
   /// Converts this object to something serializable in JSON.
-  Object toJson() => _json;
+  Object toJson() => <Object>[
+        _patternItemTypeToJson(patternItemType),
+        if (length != null) length!
+      ];
 }

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.9.2
+version: 2.9.3
 
 environment:
   sdk: ^3.3.0

packages/google_maps_flutter/google_maps_flutter_platform_interface/test/types/cap_test.dart

@@ -0,0 +1,48 @@
+// 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_test/flutter_test.dart';
+import 'package:google_maps_flutter_platform_interface/google_maps_flutter_platform_interface.dart';
+
+void main() {
+  TestWidgetsFlutterBinding.ensureInitialized();
+
+  test('buttCap', () {
+    const Cap cap = Cap.buttCap;
+    expect(cap.toJson(), equals(<Object>['buttCap']));
+  });
+
+  test('roundCap', () {
+    const Cap cap = Cap.roundCap;
+    expect(cap.toJson(), equals(<Object>['roundCap']));
+  });
+
+  test('squareCap', () {
+    const Cap cap = Cap.squareCap;
+    expect(cap.toJson(), equals(<Object>['squareCap']));
+  });
+
+  test('customCap', () {
+    final Cap cap = Cap.customCapFromBitmap(BitmapDescriptor.defaultMarker);
+    expect(
+        cap.toJson(),
+        equals(<Object>[
+          'customCap',
+          <Object>['defaultMarker'],
+          10.0
+        ]));
+  });
+
+  test('customCapWithWidth', () {
+    final Cap cap =
+        Cap.customCapFromBitmap(BitmapDescriptor.defaultMarker, refWidth: 100);
+    expect(
+        cap.toJson(),
+        equals(<Object>[
+          'customCap',
+          <Object>['defaultMarker'],
+          100.0
+        ]));
+  });
+}

packages/google_maps_flutter/google_maps_flutter_platform_interface/test/types/pattern_item_test.dart

@@ -0,0 +1,25 @@
+// 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_test/flutter_test.dart';
+import 'package:google_maps_flutter_platform_interface/google_maps_flutter_platform_interface.dart';
+
+void main() {
+  TestWidgetsFlutterBinding.ensureInitialized();
+
+  test('dot', () {
+    const PatternItem item = PatternItem.dot;
+    expect(item.toJson(), equals(<Object>['dot']));
+  });
+
+  test('dash', () {
+    final PatternItem item = PatternItem.dash(10.0);
+    expect(item.toJson(), equals(<Object>['dash', 10.0]));
+  });
+
+  test('gap', () {
+    final PatternItem item = PatternItem.gap(20.0);
+    expect(item.toJson(), equals(<Object>['gap', 20.0]));
+  });
+}