Biss.Maps.Maui
10.4.2
dotnet add package Biss.Maps.Maui --version 10.4.2
NuGet\Install-Package Biss.Maps.Maui -Version 10.4.2
<PackageReference Include="Biss.Maps.Maui" Version="10.4.2" />
<PackageVersion Include="Biss.Maps.Maui" Version="10.4.2" />
<PackageReference Include="Biss.Maps.Maui" />
paket add Biss.Maps.Maui --version 10.4.2
#r "nuget: Biss.Maps.Maui, 10.4.2"
#:package Biss.Maps.Maui@10.4.2
#addin nuget:?package=Biss.Maps.Maui&version=10.4.2
#tool nuget:?package=Biss.Maps.Maui&version=10.4.2
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
- 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);
- 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>
- Update map state and items from your ViewModel:
MapService.SetCenterAndZoom(position, zoomLevel);
MapService.AddMapItems(items);
Dependencies
BISS packages
| Package | Version | Purpose |
|---|---|---|
| Biss.Maps.Common | Latest | Shared map domain models, options, map service, and abstractions |
NuGet packages
| Package | Version | Purpose |
|---|---|---|
| CommunityToolkit.Maui.Core | 14.0.0+ | Base MAUI toolkit integration |
| CommunityToolkit.Maui.Maps | 4.0.0+ | Cross-platform map support and platform map wiring |
| Microsoft.Maui.Controls | MauiVersion | MAUI controls runtime |
| Microsoft.Maui.Controls.Maps | MauiVersion | MAUI map control primitives |
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.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0-android36.0 is compatible. net10.0-ios26.0 is compatible. net10.0-maccatalyst26.0 is compatible. net10.0-windows10.0.19041 is compatible. |
-
net10.0-android36.0
- Biss.Maps.Common (>= 10.4.2)
- CommunityToolkit.Maui.Core (>= 14.0.0)
- CommunityToolkit.Maui.Maps (>= 4.0.0)
- Microsoft.Maui.Controls (>= 10.0.20)
- Microsoft.Maui.Controls.Maps (>= 10.0.20)
-
net10.0-ios26.0
- Biss.Maps.Common (>= 10.4.2)
- CommunityToolkit.Maui.Core (>= 14.0.0)
- CommunityToolkit.Maui.Maps (>= 4.0.0)
- Microsoft.Maui.Controls (>= 10.0.20)
- Microsoft.Maui.Controls.Maps (>= 10.0.20)
-
net10.0-maccatalyst26.0
- Biss.Maps.Common (>= 10.4.2)
- CommunityToolkit.Maui.Core (>= 14.0.0)
- CommunityToolkit.Maui.Maps (>= 4.0.0)
- Microsoft.Maui.Controls (>= 10.0.20)
- Microsoft.Maui.Controls.Maps (>= 10.0.20)
-
net10.0-windows10.0.19041
- Biss.Maps.Common (>= 10.4.2)
- CommunityToolkit.Maui.Core (>= 14.0.0)
- CommunityToolkit.Maui.Maps (>= 4.0.0)
- Microsoft.Maui.Controls (>= 10.0.20)
- Microsoft.Maui.Controls.Maps (>= 10.0.20)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 10.4.2 | 35 | 3/18/2026 |
Changelog.md