Add Circle, Polygon, and Polyline click events for Map control

[kubaflo]

Note

Are you waiting for the changes in this PR to be merged?
It would be very helpful if you could test the resulting artifacts from this PR and let us know in a comment if this change resolves your issue. Thank you!

Description of Change

This PR adds support for detecting click interactions on Circle, Polygon, and Polyline elements within the .NET MAUI Map control.

Enhancements over original proposal:

• Added PolylineClicked event (in addition to Circle and Polygon)
• Rebased onto net11.0 branch
• Added proper PublicAPI.Unshipped.txt entries
• Added sample gallery page (MapElementClickGallery)
• Added unit tests for click events

Platforms Affected

• Android: Uses IOnCircleClickListener, IOnPolygonClickListener, IOnPolylineClickListener
• iOS/MacCatalyst: Uses hit testing in tap gesture recognizer

Public API Changes

// Circle
circle.CircleClicked += (s, e) =>
{
    DisplayAlert("Circle Clicked", "You clicked the circle!", "OK");
};

// Polygon
polygon.PolygonClicked += (s, e) =>
{
    DisplayAlert("Polygon Clicked", "You clicked the polygon!", "OK");
};

// Polyline (NEW)
polyline.PolylineClicked += (s, e) =>
{
    DisplayAlert("Polyline Clicked", "You clicked the polyline!", "OK");
};

Issues Fixed

Fixes #28825

---

Original Proposal

This PR proposes support for detecting click interactions on Polygon, and Circle elements within the .NET MAUI Map control.

Demo

Android	iOS
Screen.Recording.2025-04-21.at.14.52.42.mov	Screen.Recording.2025-04-21.at.14.51.33.mov

Co-authored-by: Jakub Florkowski kubaflo123@gmail.com

[dotnet-policy-service]

Hey there @@kubaflo! Thank you so much for your PR! Someone from the team will get assigned to your PR shortly and we'll get it reviewed.

[Copilot]

Pull request overview

This PR adds click/tap event support for Circle, Polygon, and Polyline map elements in the .NET MAUI Map control, addressing issue #28825. The implementation is cross-platform (Android, iOS/MacCatalyst) with proper unit tests and a sample gallery page demonstrating the functionality.

Changes:

• Added IMapElement.Clicked() interface method to enable click event handling across all map elements
• Implemented platform-specific click detection using native listeners on Android and hit testing on iOS/MacCatalyst
• Added three new public events: CircleClicked, PolygonClicked, and PolylineClicked with corresponding EventHandler signatures

Reviewed changes

Copilot reviewed 25 out of 25 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
src/Core/maps/src/Core/IMapElement.cs	Added Clicked() method to interface for click event propagation
src/Core/maps/src/Handlers/Map/MapHandler.Android.cs	Implemented Android click listeners and registered them with GoogleMap
src/Core/maps/src/Platform/iOS/MauiMKMapView.cs	Added iOS/MacCatalyst hit testing logic for circles, polygons, and polylines
src/Controls/Maps/src/Circle.cs	Added CircleClicked event and implementation of IMapElement.Clicked()
src/Controls/Maps/src/Polygon.cs	Added PolygonClicked event and implementation of IMapElement.Clicked()
src/Controls/Maps/src/Polyline.cs	Added PolylineClicked event and implementation of IMapElement.Clicked()
src/Controls/Maps/src/HandlerImpl/MapElement.Impl.cs	Added stub implementation throwing NotImplementedException
src/Controls/tests/Core.UnitTests/MapTests.cs	Added 6 unit tests verifying click events fire correctly and sender is correct
src/Controls/samples/Controls.Sample/Pages/Controls/MapsGalleries/MapElementClickGallery.xaml	Added sample page XAML with map and status label
src/Controls/samples/Controls.Sample/Pages/Controls/MapsGalleries/MapElementClickGallery.xaml.cs	Added sample page implementation demonstrating all three click events
src/Controls/samples/Controls.Sample/Pages/Controls/MapsGalleries/MapsGallery.cs	Added navigation button to new gallery page
PublicAPI.Unshipped.txt files (multiple)	Added API entries for IMapElement.Clicked() and event properties

[rmarinho]

/rebase