[google_maps_flutter_platform_interface] Add Advanced markers support

packages/google_maps_flutter/google_maps_flutter_platform_interface/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 2.13.0
+
+* Adds Advanced marker support.
+
 ## 2.12.1
 
 * Fixes the `zIndex` issue in the `copyWith` method.

packages/google_maps_flutter/google_maps_flutter_platform_interface/lib/src/platform_interface/google_maps_flutter_platform.dart

@@ -430,6 +430,11 @@ abstract class GoogleMapsFlutterPlatform extends PlatformInterface {
     return null;
   }
 
+  /// Returns true if [AdvancedMarker]s can be used with this map.
+  Future<bool> isAdvancedMarkersAvailable({required int mapId}) async {
+    return false;
+  }
+
   /// Returns a widget displaying the map view.
   @Deprecated('Use buildViewWithConfiguration instead.')
   Widget buildView(

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

@@ -0,0 +1,176 @@
+// 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 'dart:ui' show Offset;
+import 'package:flutter/foundation.dart';
+
+import '../../google_maps_flutter_platform_interface.dart';
+
+/// Marks a geographical location on the map.
+///
+/// Extends [Marker] and provides additional features.
+@immutable
+class AdvancedMarker extends Marker {
+  /// Creates a set of marker configuration options.
+  ///
+  /// Specifies a marker with a given [collisionBehavior]. Default is
+  /// [MarkerCollisionBehavior.required].
+  AdvancedMarker({
+    required super.markerId,
+    super.alpha,
+    super.anchor,
+    super.consumeTapEvents,
+    super.draggable,
+    super.flat,
+    super.icon,
+    super.infoWindow,
+    super.position,
+    super.rotation,
+    super.visible,
+    super.clusterManagerId,
+    super.onTap,
+    super.onDrag,
+    super.onDragStart,
+    super.onDragEnd,
+    int zIndex = 0,
+    this.collisionBehavior = MarkerCollisionBehavior.requiredDisplay,
+  }) : super(zIndex: zIndex.toDouble());
+
+  /// Indicates how the marker behaves when it collides with other markers.
+  final MarkerCollisionBehavior collisionBehavior;
+
+  /// Creates a new [AdvancedMarker] object whose values are the same as this
+  /// instance, unless overwritten by the specified parameters.
+  @override
+  AdvancedMarker copyWith({
+    double? alphaParam,
+    Offset? anchorParam,
+    bool? consumeTapEventsParam,
+    bool? draggableParam,
+    bool? flatParam,
+    BitmapDescriptor? iconParam,
+    InfoWindow? infoWindowParam,
+    LatLng? positionParam,
+    double? rotationParam,
+    bool? visibleParam,
+    @Deprecated(
+      'Use zIndexIntParam instead. '
+      'On some platforms zIndex is truncated to an int, which can lead to incorrect/unstable ordering.',
+    )
+    double? zIndexParam,
+    int? zIndexIntParam,
+    VoidCallback? onTapParam,
+    ValueChanged<LatLng>? onDragStartParam,
+    ValueChanged<LatLng>? onDragParam,
+    ValueChanged<LatLng>? onDragEndParam,
+    ClusterManagerId? clusterManagerIdParam,
+    MarkerCollisionBehavior? collisionBehaviorParam,
+    double? altitudeParam,
+  }) {
+    return AdvancedMarker(
+      markerId: markerId,
+      alpha: alphaParam ?? alpha,
+      anchor: anchorParam ?? anchor,
+      consumeTapEvents: consumeTapEventsParam ?? consumeTapEvents,
+      draggable: draggableParam ?? draggable,
+      flat: flatParam ?? flat,
+      icon: iconParam ?? icon,
+      infoWindow: infoWindowParam ?? infoWindow,
+      position: positionParam ?? position,
+      rotation: rotationParam ?? rotation,
+      visible: visibleParam ?? visible,
+      zIndex: (zIndexIntParam ?? zIndexParam ?? zIndex).toInt(),
+      onTap: onTapParam ?? onTap,
+      onDragStart: onDragStartParam ?? onDragStart,
+      onDrag: onDragParam ?? onDrag,
+      onDragEnd: onDragEndParam ?? onDragEnd,
+      clusterManagerId: clusterManagerIdParam ?? clusterManagerId,
+      collisionBehavior: collisionBehaviorParam ?? collisionBehavior,
+    );
+  }
+
+  /// Converts this object to something serializable in JSON.
+  @override
+  Object toJson() {
+    final String? clusterManagerIdValue = clusterManagerId?.value;
+
+    return <String, Object>{
+      'markerId': markerId.value,
+      'alpha': alpha,
+      'consumeTapEvents': consumeTapEvents,
+      'draggable': draggable,
+      'flat': flat,
+      'icon': icon.toJson(),
+      'infoWindow': infoWindow.toJson(),
+      'position': position.toJson(),
+      'rotation': rotation,
+      'visible': visible,
+      'zIndex': zIndex,
+      'collisionBehavior': collisionBehavior.index,
+      'anchor': _offsetToJson(anchor),
+      if (clusterManagerIdValue != null)
+        'clusterManagerId': clusterManagerIdValue,
+    };
+  }
+
+  @override
+  bool operator ==(Object other) {
+    if (identical(this, other)) {
+      return true;
+    }
+    if (other.runtimeType != runtimeType) {
+      return false;
+    }
+    return other is AdvancedMarker &&
+        markerId == other.markerId &&
+        alpha == other.alpha &&
+        anchor == other.anchor &&
+        consumeTapEvents == other.consumeTapEvents &&
+        draggable == other.draggable &&
+        flat == other.flat &&
+        icon == other.icon &&
+        infoWindow == other.infoWindow &&
+        position == other.position &&
+        rotation == other.rotation &&
+        visible == other.visible &&
+        zIndex == other.zIndex &&
+        clusterManagerId == other.clusterManagerId &&
+        collisionBehavior == other.collisionBehavior;
+  }
+
+  @override
+  int get hashCode => markerId.hashCode;
+
+  @override
+  String toString() {
+    return 'AdvancedMarker{markerId: $markerId, alpha: $alpha, anchor: $anchor, '
+        'consumeTapEvents: $consumeTapEvents, draggable: $draggable, flat: $flat, '
+        'icon: $icon, infoWindow: $infoWindow, position: $position, rotation: $rotation, '
+        'visible: $visible, zIndex: $zIndex, onTap: $onTap, onDragStart: $onDragStart, '
+        'onDrag: $onDrag, onDragEnd: $onDragEnd, clusterManagerId: $clusterManagerId, '
+        'collisionBehavior: $collisionBehavior}';
+  }
+}
+
+/// Indicates how the marker behaves when it collides with other markers.
+enum MarkerCollisionBehavior {
+  /// (default) Always display the marker regardless of collision.
+  requiredDisplay,
+
+  /// Display the marker only if it does not overlap with other markers.
+  /// If two markers of this type would overlap, the one with the higher zIndex
+  /// is shown. If they have the same zIndex, the one with the lower vertical
+  /// screen position is shown.
+  optionalAndHidesLowerPriority,
+
+  /// Always display the marker regardless of collision, and hide any
+  /// [optionalAndHidesLowerPriority] markers or labels that would overlap with
+  /// the marker.
+  requiredAndHidesOptional,
+}
+
+/// Convert [Offset] to JSON object.
+Object _offsetToJson(Offset offset) {
+  return <Object>[offset.dx, offset.dy];
+}