[google_maps_flutter] Add onPointOfInterestTap support

packages/google_maps_flutter/google_maps_flutter/CHANGELOG.md

@@ -1,5 +1,9 @@
-## NEXT
+## 2.19.0
 
+* Adds support for tapping points of interest on the map.
+  On iOS, this requires `google_maps_flutter_ios_sdk9` or
+  `google_maps_flutter_ios_sdk10` (the default `google_maps_flutter_ios`
+  package does not receive new features).
 * Updates minimum supported SDK version to Flutter 3.41/Dart 3.11.
 
 ## 2.18.1

packages/google_maps_flutter/google_maps_flutter/example/lib/map_click.dart

@@ -35,6 +35,7 @@ class _MapClickBodyState extends State<_MapClickBody> {
   GoogleMapController? mapController;
   LatLng? _lastTap;
   LatLng? _lastLongPress;
+  String? _lastPointOfInterestPlaceId;
 
   @override
   Widget build(BuildContext context) {
@@ -51,6 +52,11 @@ class _MapClickBodyState extends State<_MapClickBody> {
           _lastLongPress = pos;
         });
       },
+      onPointOfInterestTap: (PointOfInterestId pointOfInterestId) {
+        setState(() {
+          _lastPointOfInterestPlaceId = pointOfInterestId.value;
+        });
+      },
     );
 
     final columnChildren = <Widget>[
@@ -73,6 +79,17 @@ class _MapClickBodyState extends State<_MapClickBody> {
           child: Text(_lastLongPress != null ? 'Long pressed' : '', textAlign: TextAlign.center),
         ),
       );
+      final lastPointOfInterestTap =
+          'Point of interest place ID:\n${_lastPointOfInterestPlaceId ?? ""}';
+      columnChildren.add(Center(child: Text(lastPointOfInterestTap, textAlign: TextAlign.center)));
+      columnChildren.add(
+        Center(
+          child: Text(
+            _lastPointOfInterestPlaceId != null ? 'Point of interest tapped' : '',
+            textAlign: TextAlign.center,
+          ),
+        ),
+      );
     }
     return Column(crossAxisAlignment: CrossAxisAlignment.stretch, children: columnChildren);
   }

packages/google_maps_flutter/google_maps_flutter/example/pubspec.yaml

@@ -18,8 +18,8 @@ dependencies:
     # The example app is bundled with the plugin so we use a path dependency on
     # the parent directory to use the current plugin's version.
     path: ../
-  google_maps_flutter_android: ^2.19.1
-  google_maps_flutter_platform_interface: ^2.16.0
+  google_maps_flutter_android: ^2.20.0
+  google_maps_flutter_platform_interface: ^2.17.0
 
 dev_dependencies:
   build_runner: ^2.1.10

packages/google_maps_flutter/google_maps_flutter/lib/google_maps_flutter.dart

@@ -54,6 +54,7 @@ export 'package:google_maps_flutter_platform_interface/google_maps_flutter_platf
         MinMaxZoomPreference,
         PatternItem,
         PinConfig,
+        PointOfInterestId,
         Polygon,
         PolygonId,
         Polyline,

packages/google_maps_flutter/google_maps_flutter/lib/src/controller.dart

@@ -111,6 +111,11 @@ class GoogleMapController {
           .onLongPress(mapId: mapId)
           .listen((MapLongPressEvent e) => _googleMapState.onLongPress(e.position)),
     );
+    _streamSubscriptions.add(
+      GoogleMapsFlutterPlatform.instance
+          .onPointOfInterestTap(mapId: mapId)
+          .listen((PointOfInterestTapEvent e) => _googleMapState.onPointOfInterestTap(e.value)),
+    );
     _streamSubscriptions.add(
       GoogleMapsFlutterPlatform.instance
           .onClusterTap(mapId: mapId)

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

@@ -136,6 +136,7 @@ class GoogleMap extends StatefulWidget {
     this.onCameraIdle,
     this.onTap,
     this.onLongPress,
+    this.onPointOfInterestTap,
     this.markerType = GoogleMapMarkerType.marker,
     this.colorScheme,
     String? mapId,
@@ -300,6 +301,14 @@ class GoogleMap extends StatefulWidget {
   /// Called every time a [GoogleMap] is long pressed.
   final ArgumentCallback<LatLng>? onLongPress;
 
+  /// Called when a point of interest on the map is tapped.
+  ///
+  /// Supported on Android and web, and on iOS when using
+  /// `google_maps_flutter_ios_sdk9` or `google_maps_flutter_ios_sdk10`.
+  /// The default `google_maps_flutter_ios` package does not receive new
+  /// features, so this callback is not delivered there.
+  final ArgumentCallback<PointOfInterestId>? onPointOfInterestTap;
+
   /// True if a "My Location" layer should be shown on the map.
   ///
   /// This layer includes a location indicator at the current device location,
@@ -717,6 +726,13 @@ class _GoogleMapState extends State<GoogleMap> {
     }
   }
 
+  void onPointOfInterestTap(PointOfInterestId pointOfInterestId) {
+    final ArgumentCallback<PointOfInterestId>? onPointOfInterestTap = widget.onPointOfInterestTap;
+    if (onPointOfInterestTap != null) {
+      onPointOfInterestTap(pointOfInterestId);
+    }
+  }
+
   void onClusterTap(Cluster cluster) {
     final ClusterManager? clusterManager = _clusterManagers[cluster.clusterManagerId];
     if (clusterManager == null) {

packages/google_maps_flutter/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.
 repository: https://github.com/flutter/packages/tree/main/packages/google_maps_flutter/google_maps_flutter
 issue_tracker: https://github.com/flutter/flutter/issues?q=is%3Aissue+is%3Aopen+label%3A%22p%3A+maps%22
-version: 2.18.1
+version: 2.19.0
 
 environment:
   sdk: ^3.11.0
@@ -21,10 +21,10 @@ flutter:
 dependencies:
   flutter:
     sdk: flutter
-  google_maps_flutter_android: ^2.19.1
+  google_maps_flutter_android: ^2.20.0
   google_maps_flutter_ios: ^2.18.0
-  google_maps_flutter_platform_interface: ^2.16.0
-  google_maps_flutter_web: ^0.6.3
+  google_maps_flutter_platform_interface: ^2.17.0
+  google_maps_flutter_web: ^0.6.4
 
 dev_dependencies:
   flutter_test:

packages/google_maps_flutter/google_maps_flutter/test/fake_google_maps_flutter_platform.dart

@@ -227,6 +227,11 @@ class FakeGoogleMapsFlutterPlatform extends GoogleMapsFlutterPlatform {
     return mapEventStreamController.stream.whereType<CircleTapEvent>();
   }
 
+  @override
+  Stream<PointOfInterestTapEvent> onPointOfInterestTap({required int mapId}) {
+    return mapEventStreamController.stream.whereType<PointOfInterestTapEvent>();
+  }
+
   @override
   Stream<MapTapEvent> onTap({required int mapId}) {
     return mapEventStreamController.stream.whereType<MapTapEvent>();

packages/google_maps_flutter/google_maps_flutter/test/google_maps_flutter_export_test.dart

@@ -50,6 +50,7 @@ void main() {
       main_file.MinMaxZoomPreference;
       main_file.PatternItem;
       main_file.PinConfig;
+      main_file.PointOfInterestId;
       main_file.Polygon;
       main_file.PolygonId;
       main_file.Polyline;

packages/google_maps_flutter/google_maps_flutter/test/point_of_interest_tap_test.dart

@@ -0,0 +1,51 @@
+// Copyright 2013 The Flutter Authors
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+import 'package:flutter/widgets.dart';
+import 'package:flutter_test/flutter_test.dart';
+import 'package:google_maps_flutter/google_maps_flutter.dart';
+import 'package:google_maps_flutter_platform_interface/google_maps_flutter_platform_interface.dart';
+
+import 'fake_google_maps_flutter_platform.dart';
+
+void main() {
+  TestWidgetsFlutterBinding.ensureInitialized();
+  late FakeGoogleMapsFlutterPlatform platform;
+
+  setUp(() {
+    platform = FakeGoogleMapsFlutterPlatform();
+    GoogleMapsFlutterPlatform.instance = platform;
+  });
+
+  testWidgets('onPointOfInterestTap callback receives place ID from platform event', (
+    WidgetTester tester,
+  ) async {
+    PointOfInterestId? tappedPointOfInterestId;
+
+    await tester.pumpWidget(
+      Directionality(
+        textDirection: TextDirection.ltr,
+        child: GoogleMap(
+          initialCameraPosition: const CameraPosition(target: LatLng(0.0, 0.0)),
+          onPointOfInterestTap: (PointOfInterestId pointOfInterestId) {
+            tappedPointOfInterestId = pointOfInterestId;
+          },
+        ),
+      ),
+    );
+
+    await tester.pump();
+
+    expect(platform.createdIds, isNotEmpty);
+    final int mapId = platform.createdIds.first;
+
+    platform.mapEventStreamController.add(
+      PointOfInterestTapEvent(mapId, const PointOfInterestId('place-123')),
+    );
+
+    await tester.pump();
+
+    expect(tappedPointOfInterestId, const PointOfInterestId('place-123'));
+  });
+}