Biss.Maps.Maui 10.4.6

Biss.Maps.Maui

(C) 2026 FOTEC Forschungs- und Technologietransfer GmbH | https://www.fotec.at

What can this NuGet package do?

Biss.Maps.Maui provides the MAUI-specific UI layer for BISS map functionality. It integrates the shared map domain from Biss.Maps.Common with a native .NET MAUI map control, including map rendering, map-item synchronization, map interaction handling, and user-location integration.

The package is intended for .NET MAUI apps that use BISS architecture and want to work with a central BissMapService in ViewModels.

Core features

• BISS map control for MAUI via BissMapMaui
• DI setup extension via AddBissMauiMaps on MauiAppBuilder
• Automatic synchronization between BissMapService and native MAUI map
• Support for map elements: point/pin, polyline, polygon, circle, and route
• Map interaction events (map click and map item click) through BissMapService
• Programmatic center and zoom changes with optional animation
• User location support via MAUI Geolocation and permission handling
• Platform-specific handlers for Android, iOS, MacCatalyst, and Windows
• Windows Bing Maps key integration through custom map handler setup
• Configurable default pin image using BissMapOptions

Target frameworks

• net10.0-android
• net10.0-ios
• net10.0-maccatalyst
• net10.0-windows10.0.19041.0 (when building on Windows)

Quick start

1. Register BISS MAUI maps in MauiProgram:

using Biss.Maps.Common.MapElements;
using Biss.Maps.Maui.Extensions;
builder.AddBissMauiMaps(options =>
{
	options.DefaultPinImage = new BmPinImage(defaultPinImageBytes);
}, bingMapsKey: AppSettings.Current().BingMapsKey);

2. Add the map control in XAML and bind your map service:

<ContentPage
	xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
	xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
	xmlns:controls="clr-namespace:Biss.Maps.Maui.Controls;assembly=Biss.Maps.Maui">
	<controls:BissMapMaui MapService="{Binding MapService}" />
</ContentPage>

3. Update map state and items from your ViewModel:

MapService.SetCenterAndZoom(position, zoomLevel);
MapService.AddMapItems(items);

Dependencies

BISS packages

NuGet packages

Notes

• For location-related features, each target platform must declare and grant location permissions.
• For Windows map rendering, provide a valid Bing Maps key when calling AddBissMauiMaps.