Mile15.Maui.Controls.Maps 0.0.1-alpha.388

Mile15.Maui.Controls.Maps

A rich, cross-platform map control for .NET MAUI applications targeting Android, iOS, and macOS (Mac Catalyst). It wraps the native Google Maps SDK (Android) and MapKit (iOS / macOS) and exposes a unified MAUI-friendly API of bindable map objects, commands, and programmatic camera controls.

Table of Contents

• Requirements
• Installation
• Handler Registration
• Quick Start
• Map Control Properties
• Map Object Types
  • AnnotationMapObject
  • PolygonMapObject
  • PolylineMapObject
  • ImageMapObject
  • TileOverlayMapObject
• Commands
• Programmatic Camera Control
• Extents
• License

Requirements

.NET SDK: .NET 10 or later with the maui workload installed.

Installation

dotnet add package Mile15.Maui.Controls.Maps

Or via the NuGet Package Manager in Visual Studio: search for Mile15.Maui.Controls.Maps.

Handler Registration

Register the MapHandler inside your MauiProgram.cs before calling Build():

using Mile15.Maui.Controls.Maps.Handlers.Map;
using Mile15.Maui.Controls.Maps.Controls;

public static class MauiProgram
{
 public static MauiApp CreateMauiApp()
 {
 var builder = MauiApp.CreateBuilder();

 builder
 .UseMauiApp<App>()
 .ConfigureMauiHandlers(handlers =>
 {
 handlers.AddHandler<Map, MapHandler>();
 });

 return builder.Build();
 }
}

Android

Add your Google Maps API key to AndroidManifest.xml:

<meta-data android:name="com.google.android.maps.v2.API_KEY"
 android:value="YOUR_API_KEY_HERE" />

iOS / macOS

No additional manifest changes are required. Ensure your app's entitlements include location permissions if IsShowingUser is enabled.

Quick Start

XAML

<ContentPage
 xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
 xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
 xmlns:maps="clr-namespace:Mile15.Maui.Controls.Maps.Controls;assembly=Mile15.Maui.Controls.Maps">

 <maps:Map
 MapType="Street"
 IsShowingUser="True"
 IsScrollEnabled="True"
 IsZoomEnabled="True"
 MapObjects="{Binding MapObjects}" />

</ContentPage>

Code-behind / ViewModel

using Mile15.Maui.Controls.Maps.Collections;
using Mile15.Maui.Controls.Maps.Map.Maps;
using Microsoft.Maui.Maps;

// Create a collection of map objects
var mapObjects = new ObservableNotifiableCollection<IMapObject>
{
 new AnnotationMapObject
 {
 Name = "Mile15 HQ",
 Description = "Our headquarters",
 Point = new Point(35.9940, -86.8318),
 ImageSource = "pin.png"
 },
 new PolygonMapObject
 {
 Name = "Service Area",
 FillColor = Colors.Blue.WithAlpha(0.3f),
 StrokeColor = Colors.Blue,
 StrokeWidth = 2,
 Points = new List<Point>
 {
 new(36.00, -86.84),
 new(36.00, -86.82),
 new(35.98, -86.82),
 new(35.98, -86.84)
 }
 }
};

MyMap.MapObjects = mapObjects;

Map Control Properties

Map Object Types

All map objects inherit from MapObject, which provides the following shared bindable properties:

AnnotationMapObject

A point marker placed at a geographic coordinate, optionally decorated with custom imagery.

new AnnotationMapObject
{
 Point = new Point(latitude, longitude),
 ImageSource = "custom_pin.png", // resource name or URI
 ImageWidth = 24,
 ImageHeight = 24,
 ImageColor = Colors.Red,
 ImageSourceRotation = 45, // degrees
 ImageSourceBackImage = "pin_background.png",
 ImageSourceSuperImage = "pin_overlay.png",
}

PolygonMapObject

A closed geographic shape with an optional fill and configurable stroke.

new PolygonMapObject
{
 FillColor = Colors.Green.WithAlpha(0.25f),
 StrokeColor = Colors.Green,
 StrokeWidth = 3,
 ZIndex = 2,
 Points = new List<Point> { /* lat/lng pairs */ }
}

PolylineMapObject

An open geographic path. Shares all stroke and Points properties from GeoMapObject.

new PolylineMapObject
{
 StrokeColor = Colors.Orange,
 StrokeWidth = 4,
 Points = new List<Point> { /* lat/lng pairs */ }
}

ImageMapObject

Stretches an image over a geographic bounding box.

new ImageMapObject
{
 ImageSource = "field_overlay.png",
 TopLeft = new Point(36.001, -86.841),
 BottomRight = new Point(35.990, -86.820)
}

TileOverlayMapObject

Renders a slippy-map tile layer from a custom URL template. The URL should contain {x}, {y}, and {z} placeholders.

new TileOverlayMapObject
{
 CustomTileUrl = "https://tiles.example.com/{z}/{x}/{y}.png"
}

Commands

Bind these ICommand properties on the Map control to react to user interactions in your ViewModel.

Programmatic Camera Control

All methods are available on the Map control instance and can also be invoked from a ViewModel via the IMap interface.

// Pan and zoom to a specific region
map.MoveToRegion(new MapSpan(new Location(35.994, -86.832), 0.05, 0.05));

// Fit the camera to all IsZoomAllContributor objects
map.ZoomToExtents(animate: true);

// Fit the camera to a single map object's extents
map.ZoomToMapObject(myPolygon, animate: true);

// Pan to center on a map object without changing zoom
map.CenterOnMapObject(myAnnotation, animate: true);

// Programmatically deselect an annotation
map.DeselectAnnotation(myAnnotation);

Extents

Extents is a lightweight bounding-box value type used throughout the library.

var extents = new Extents(
 topLeft: new Location(36.001, -86.841),
 bottomRight: new Location(35.990, -86.820)
);

Location center = extents.GetCenterLocation();

The Map.Extents property automatically recomputes its value whenever MapObjects changes, giving you a live bounding box of all contributing objects.

License

This package is distributed under the .
Copyright © 2026 Mile15, LLC. All rights reserved.