[google_maps_flutter_platform_interface] Add iOS warning for PinConfig (#11100)

Add iOS warning for PinConfig usage in BitmapDescriptor

iOS implementation for Advanced Markers: #10508
Related issue: flutter/flutter#155526

## Pre-Review Checklist

**Note**: The Flutter team is currently trialing the use of [Gemini Code Assist for GitHub](https://developers.google.com/gemini-code-assist/docs/review-github-code). Comments from the `gemini-code-assist` bot should not be taken as authoritative feedback from the Flutter team. If you find its comments useful you can update your code accordingly, but if you are unsure or disagree with the feedback, please feel free to wait for a Flutter team member's review for guidance on which automated comments should be addressed.

[^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: jokerttu

packages/google_maps_flutter/google_maps_flutter_platform_interface/CHANGELOG.md

@@ -1,5 +1,6 @@
-## NEXT
+## 2.14.2
 
+* Adds documentation about iOS rendering issue with `PinConfig`.
 * Updates minimum supported SDK version to Flutter 3.35/Dart 3.9.
 
 ## 2.14.1

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

@@ -363,6 +363,11 @@ abstract class BitmapDescriptor {
   ///
   /// See [PinConfig] for more information on the parameters.
   ///
+  /// WARNING: On iOS, using a PinConfig may result in the marker not showing.
+  /// For details and updates, see https://issuetracker.google.com/issues/370536110.
+  /// If this issue has not been fixed in the version of the Google Maps SDK you
+  /// are using, consider using an asset or bitmap for customization on iOS.
+  ///
   /// Returns a new [PinConfig] instance.
   static BitmapDescriptor pinConfig({
     Color? backgroundColor,
@@ -1058,6 +1063,10 @@ class BytesMapBitmap extends MapBitmap {
 /// )
 /// ```
 ///
+/// WARNING: On iOS, using a PinConfig may result in the marker not showing.
+/// For details and updates, see https://issuetracker.google.com/issues/370536110.
+/// If this issue has not been fixed in the version of the Google Maps SDK you
+/// are using, consider using an asset or bitmap for customization on iOS.
 class PinConfig extends BitmapDescriptor {
   /// Constructs a [PinConfig] that is created from a pin configuration.
   ///
@@ -1068,6 +1077,11 @@ class PinConfig extends BitmapDescriptor {
   /// pin marker.
   ///
   /// At least one of the parameters must not be null.
+  ///
+  /// WARNING: On iOS, using a PinConfig may result in the marker not showing.
+  /// For details and updates, see https://issuetracker.google.com/issues/370536110.
+  /// If this issue has not been fixed in the version of the Google Maps SDK you
+  /// are using, consider using an asset or bitmap for customization on iOS.
   const PinConfig({this.backgroundColor, this.borderColor, this.glyph})
     : assert(
         backgroundColor != null || borderColor != null || glyph != null,

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.14.1
+version: 2.14.2
 
 environment:
   sdk: ^3.9.0