Implement .NET MAUI Maps

[rmarinho]

Description of Change

Adding handlers for maps

Removed API:

• Position - Replaced by Microsoft.Maui.Devices.Sensors.Location
• Geocoder - Replaced by Microsoft.Maui.Devices.Sensors.Geocoding
• GeographyUtils
• Remove MoveToLastRegionOnLayoutChange on `Map
• On Map remove EditorBrowsable APIs

[EditorBrowsable(EditorBrowsableState.Never)]
public MapSpan LastMoveToRegion { get; private set; }

[EditorBrowsable(EditorBrowsableState.Never)]
public void SetVisibleRegion(MapSpan value) 

[EditorBrowsable(EditorBrowsableState.Never)]
public void SendMapClicked(Position position) 

Changed API:

• Change Microsoft.Maui.Controls.Maps.Position on Pin to Microsoft.Maui.Devices.Sensors.Location
• Change Microsoft.Maui.Controls.Maps.Position on MapClickedEventArgs to Microsoft.Maui.Devices.Sensors.Location
• Change Microsoft.Maui.Controls.Maps.Position Center on MapSpan to Microsoft.Maui.Devices.Sensors.Location
• Change Microsoft.Maui.Controls.Maps.Position Geopath on Polyline to Microsoft.Maui.Devices.Sensors.Location
• Change Microsoft.Maui.Controls.Maps.Position Geopath on Polygon to Microsoft.Maui.Devices.Sensors.Location
• Change Map property TrafficEnabled to HasTrafficEnabled
• Change Pin property Position to Location

New API:

• Interfaces

public interface IMap : IView
{
	MapSpan? VisibleRegion { get; set;  }
	MapType MapType { get; }
	bool IsShowingUser { get; }
	bool HasScrollEnabled { get; }
	bool HasZoomEnabled { get; }
	bool HasTrafficEnabled { get; }
	IList<IMapPin> Pins { get; }
	IList<IMapElement> Elements { get; }	
	void Clicked(Location position);
	void MoveToRegion(MapSpan region);
	bool MoveToLastRegionOnLayoutChange { get; }
}

public interface IMapPin : IElement
{
	string Address { get; }
	string Label { get; }
	Location Position { get; }
	object? MarkerId { get; set; }
	bool SendMarkerClick();
	bool SendInfoWindowClick();
}

public interface IMapElement : IElement, IStroke
{
	object? MapElementId { get; set; }
}

public interface IGeoPathMapElement : IMapElement
{
	IList<Location> Geopath { get; }
}

public interface IFilledMapElement : IMapElement
{
	Paint? Fill { get; }
}

public interface ICircleMapElement : IMapElement, IFilledMapElement
{
	Location Center { get; }
	Distance Radius { get; }
}

public interface IMapHandler : IViewHandler
{
	new IMap VirtualView { get; }
	new PlatformView PlatformView { get; }
#if MONOANDROID
	GoogleMap? Map { get; set; }
#endif

	void UpdateMapElement(IMapElement element);
}

public interface IMapElementHandler : IElementHandler
{
	new IMapElement VirtualView { get; }
	new PlatformView PlatformView { get; }
}

public interface IMapPinHandler : IElementHandler
{
	new IMapPin VirtualView { get; }
	new PlatformView PlatformView { get; }
}

• Handlers

public partial class MapHandler : IMapHandler
{
	public static IPropertyMapper<IMap, IMapHandler> Mapper = new PropertyMapper<IMap, IMapHandler>(ViewHandler.ViewMapper)
	{
		[nameof(IMap.MapType)] = MapMapType,
		[nameof(IMap.IsShowingUser)] = MapIsShowingUser,
		[nameof(IMap.HasScrollEnabled)] = MapHasScrollEnabled,
		[nameof(IMap.HasTrafficEnabled)] = MapHasTrafficEnabled,
		[nameof(IMap.HasZoomEnabled)] = MapHasZoomEnabled,
		[nameof(IMap.Pins)] = MapPins,
		[nameof(IMap.Elements)] = MapElements,
	};

	public static CommandMapper<IMap, IMapHandler> CommandMapper = new(ViewCommandMapper)
	{
		[nameof(IMap.MoveToRegion)] = MapMoveToRegion,
	};

	IMap IMapHandler.VirtualView => VirtualView;
	PlatformView IMapHandler.PlatformView => PlatformView;
}

public partial class MapHandler : ViewHandler<IMap, MKMapView>

public partial class MapHandler : ViewHandler<IMap, MapView>

public partial class MapElementHandler : IMapElementHandler
{
	public static IPropertyMapper<IMapElement, IMapElementHandler> Mapper = new PropertyMapper<IMapElement, IMapElementHandler>(ElementMapper)
	{
		[nameof(IMapElement.Stroke)] = MapStroke,
		[nameof(IMapElement.StrokeThickness)] = MapStrokeThickness,
		[nameof(IFilledMapElement.Fill)] = MapFill,
#if MONOANDROID
		[nameof(IGeoPathMapElement.Geopath)] = MapGeopath,
		[nameof(ICircleMapElement.Radius)] = MapRadius,
		[nameof(ICircleMapElement.Center)] = MapCenter,
#endif
	};

	IMapElement IMapElementHandler.VirtualView => VirtualView;
	PlatformView IMapElementHandler.PlatformView => PlatformView;
}

public partial class MapElementHandler : ElementHandler<IMapElement, MKOverlayRenderer>

public partial class MapElementHandler : ElementHandler<IMapElement, Java.Lang.Object>

public partial class MapPinHandler : IMapPinHandler
{
	public static IPropertyMapper<IMapPin, IMapPinHandler> Mapper = new PropertyMapper<IMapPin, IMapPinHandler>(ElementMapper)
	{
		[nameof(IMapPin.Position)] = MapPosition,
		[nameof(IMapPin.Label)] = MapLabel,
		[nameof(IMapPin.Address)] = MapAddress,
	};

	IMapPin IMapPinHandler.VirtualView => VirtualView;

	PlatformView IMapPinHandler.PlatformView => PlatformView;
}

public partial class MapPinHandler : ElementHandler<IMapPin, MarkerOptions>

public partial class MapPinHandler : ElementHandler<IMapPin, IMKAnnotation>

Issues Fixed

Fixes #3933

• We need to obsolete one Geocoding API: [Bug] Mark one of the Geocoding APIs as obsolete #2209

[davidbuckleyni]

Is this for the new apple maps just announced or just the old maps

[jfversluis]

Is this for the new apple maps just announced or just the old maps

This is porting over Xamarin.Forms Maps to .NET MAUI. Nothing new needs to be done for the new Apple Maps stuff.

[jsuarezruiz]

I have updated the gallery with multiple examples to test with ItemsSource, polygons, etc.

Test results.

✔️ - Works!
🕐 - Not yet verified.
❌ - Not working.

Maps	Android	iOS	Catalyst	Windows
HasScrollEnabled	✔️	✔️	✔️	🕐
HasZoomEnabled	✔️	✔️	✔️	🕐
IsShowingUser	❌	✔️	✔️	🕐
ItemsSource	✔️	✔️	✔️	🕐
ItemTemplate	✔️	✔️	✔️	🕐
MapType	✔️	✔️	✔️	🕐
TrafficEnabled	✔️	✔️	✔️	🕐
MapElements (Polygon)	❌	✔️	✔️	🕐
MapElements (Circle)	❌	✔️	✔️	🕐
MapElements (Polyline)	❌	✔️	✔️	🕐
VisibleRegion	✔️	✔️	✔️	🕐
MoveToRegion	❌	✔️	✔️	🕐

Feedback.

Android
Can use the polygon gallery to verify that they are not being rendered, nor is the MoveToRegion method working as expected.

iOS
All the properties are working as expe

cted.

[jsuarezruiz]

LastMoveToRegion have been removed?

[jsuarezruiz]

It's not essential, but could we move this to extension methods like in other Handlers? This way, someone extending the Handler could easily access this logic.

[Jun1119jun]

@sky41906