Update MAUI Map docs for Windows Azure Maps support by Copilot · Pull Request #3357 · dotnet/docs-maui

Copilot · 2026-05-24T12:57:10Z

.NET MAUI Maps now has a native Windows implementation using WinUI 3 MapControl backed by Azure Maps. The docs still described Windows as unsupported and pointed users to the Community Toolkit workaround.

Versioned Windows guidance
- Keeps the unsupported Windows note for <=net-maui-9.0.
- Adds >=net-maui-10.0 guidance for Azure Maps-backed Windows support.
Windows setup
- Adds Azure Maps subscription key configuration with ConfigureEssentials:

builder
    .UseMauiApp<App>()
    .UseMauiMaps();

builder.ConfigureEssentials(essentials =>
{
    essentials.UseMapServiceToken("YOUR_AZURE_MAPS_SUBSCRIPTION_KEY");
});

Windows capability notes
- Documents supported Windows features: MoveToRegion, map types, traffic, scrolling/zooming, and pins.
- Calls out current no-op limitations: user location display, map elements/shapes, pin info windows, and background map clicks.

Internal previews

📄 File	🔗 Preview link
docs/user-interface/controls/map.md	docs/user-interface/controls/map

learn-build-service-prod · 2026-05-24T12:58:32Z

Learn Build status updates of commit 6b17e22:

✅ Validation status: passed

For more details, please refer to the build report.

Agent-Logs-Url: https://github.com/dotnet/docs-maui/sessions/2571c4f5-9b29-42a0-97e2-099d42bd022a Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>

learn-build-service-prod · 2026-05-24T13:00:10Z

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

Agent-Logs-Url: https://github.com/dotnet/docs-maui/sessions/2571c4f5-9b29-42a0-97e2-099d42bd022a Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>

learn-build-service-prod · 2026-05-24T13:00:39Z

Learn Build status updates of commit 3fe4cb5:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/user-interface/controls/map.md	✅Succeeded	View (>=net-maui-8.0)

For more details, please refer to the build report.

Agent-Logs-Url: https://github.com/dotnet/docs-maui/sessions/2571c4f5-9b29-42a0-97e2-099d42bd022a Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>

learn-build-service-prod · 2026-05-24T13:01:43Z

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2026-05-24T13:02:30Z

Learn Build status updates of commit de03a6f:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/user-interface/controls/map.md	✅Succeeded	View (>=net-maui-8.0)

For more details, please refer to the build report.

learn-build-service-prod · 2026-05-24T13:02:58Z

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2026-05-24T13:04:45Z

Learn Build status updates of commit 928951c:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/user-interface/controls/map.md	✅Succeeded	View (>=net-maui-8.0)

For more details, please refer to the build report.

learn-build-service-prod · 2026-06-12T12:57:41Z

PoliCheck Scan Report

The following report lists PoliCheck issues in PR files. Before you merge the PR, you must fix all severity-1 and severity-2 issues. The AI Review Details column lists suggestions for either removing or replacing the terms. If you find a false positive result, mention it in a PR comment and include this text: #policheck-false-positive. This feedback helps reduce false positives in future scans.

✅ No issues found

More information about PoliCheck

Information: PoliCheck | Severity Guidance | Term
For any questions: Try searching the learn.microsoft.com contributor guides or post your question in the Learn support channel.

learn-build-service-prod · 2026-06-12T12:58:29Z

Learn Build status updates of commit 782515a:

✅ Validation status: passed

File	Status	Preview URL	Details
docs/user-interface/controls/map.md	✅Succeeded	View (>=net-maui-8.0)

For more details, please refer to the build report.

Copilot

Pull request overview

Updates the .NET MAUI Map control documentation to reflect new Windows behavior by introducing versioned guidance and adding Windows setup instructions for the Azure Maps-backed WinUI MapControl.

Changes:

Adds monikered Windows support messaging (unsupported in older versions, Azure Maps-backed support in newer versions).
Updates the Platform configuration section to include Windows configuration details and an Azure Maps subscription key setup snippet.
Documents Windows feature support and current limitations.


 The .NET Multi-platform App UI (.NET MAUI) <xref:Microsoft.Maui.Controls.Maps.Map> control is a cross-platform view for displaying and annotating maps. The <xref:Microsoft.Maui.Controls.Maps.Map> control uses the native map control on each platform, and is provided by the [Microsoft.Maui.Controls.Maps NuGet package](https://www.nuget.org/packages/Microsoft.Maui.Controls.Maps/).

+::: moniker range="<=net-maui-9.0"



+::: moniker-end
+
+::: moniker range=">=net-maui-10.0"


 ### Platform configuration

-Additional configuration is required on Android before the map will display. In addition, on iOS, Android, and Mac Catalyst, accessing the user's location requires location permissions to have been granted to your app.
+Additional configuration is required on Android and Windows before the map will display. In addition, on iOS, Android, and Mac Catalyst, accessing the user's location requires location permissions to have been granted to your app.


+#### Windows
+
+::: moniker range=">=net-maui-10.0"
+


+- Displaying polygons, polylines, and circles from the `MapElements` collection.
+- Pin labels and info windows.
+- The `MapClicked` event for taps on the map background.


Initial plan

6b17e22

Copilot AI assigned Copilot and jfversluis May 24, 2026

Copilot started work on behalf of jfversluis May 24, 2026 12:57 View session

Copilot AI linked an issue May 24, 2026 that may be closed by this pull request

Update docs to reflect the addition of Azure Maps in MAUI #3356

Open

Copilot AI and others added 2 commits May 24, 2026 12:59

Update Windows Maps docs for Azure Maps

3fe4cb5

Agent-Logs-Url: https://github.com/dotnet/docs-maui/sessions/2571c4f5-9b29-42a0-97e2-099d42bd022a Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>

Clarify Windows Maps support details

de03a6f

Agent-Logs-Url: https://github.com/dotnet/docs-maui/sessions/2571c4f5-9b29-42a0-97e2-099d42bd022a Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>

Address Azure Maps docs review feedback

1622610

Agent-Logs-Url: https://github.com/dotnet/docs-maui/sessions/2571c4f5-9b29-42a0-97e2-099d42bd022a Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>

Refine Azure Maps key guidance

928951c

Agent-Logs-Url: https://github.com/dotnet/docs-maui/sessions/2571c4f5-9b29-42a0-97e2-099d42bd022a Co-authored-by: jfversluis <939291+jfversluis@users.noreply.github.com>

Copilot AI changed the title ~~[WIP] Update docs to reflect addition of Azure Maps in MAUI~~ Update MAUI Map docs for Windows Azure Maps support May 24, 2026

Copilot AI requested a review from jfversluis May 24, 2026 13:01

Copilot finished work on behalf of jfversluis May 24, 2026 13:01

jfversluis approved these changes May 24, 2026

View reviewed changes

jfversluis marked this pull request as ready for review May 24, 2026 13:34

jfversluis requested a review from a team as a code owner May 24, 2026 13:34

jfversluis requested review from PureWeen and davidortinau May 24, 2026 13:34

This was referenced Jun 11, 2026

[PR Review Queue] 2026-06-11 dotnet/maui#35871

Closed

[PR Review Queue] 2026-06-12 dotnet/maui#35888

Open

Merge branch 'main' into copilot/update-docs-azure-maps-maui

782515a

Copilot AI review requested due to automatic review settings June 12, 2026 12:56

Copilot started reviewing on behalf of jfversluis June 12, 2026 12:56 View session

Copilot AI reviewed Jun 12, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Update MAUI Map docs for Windows Azure Maps support#3357

Update MAUI Map docs for Windows Azure Maps support#3357
Copilot wants to merge 6 commits into
mainfrom
copilot/update-docs-azure-maps-maui

Copilot AI commented May 24, 2026 •

edited by github-actions Bot

Loading

Uh oh!

learn-build-service-prod Bot commented May 24, 2026

Uh oh!

learn-build-service-prod Bot commented May 24, 2026

Uh oh!

learn-build-service-prod Bot commented May 24, 2026

Uh oh!

learn-build-service-prod Bot commented May 24, 2026

Uh oh!

learn-build-service-prod Bot commented May 24, 2026

Uh oh!

learn-build-service-prod Bot commented May 24, 2026

Uh oh!

learn-build-service-prod Bot commented May 24, 2026

Uh oh!

learn-build-service-prod Bot commented Jun 12, 2026

Uh oh!

learn-build-service-prod Bot commented Jun 12, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants


		The .NET Multi-platform App UI (.NET MAUI) <xref:Microsoft.Maui.Controls.Maps.Map> control is a cross-platform view for displaying and annotating maps. The <xref:Microsoft.Maui.Controls.Maps.Map> control uses the native map control on each platform, and is provided by the [Microsoft.Maui.Controls.Maps NuGet package](https://www.nuget.org/packages/Microsoft.Maui.Controls.Maps/).

		::: moniker range="<=net-maui-9.0"

Conversation

Copilot AI commented May 24, 2026 • edited by github-actions Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Internal previews

Uh oh!

learn-build-service-prod Bot commented May 24, 2026

✅ Validation status: passed

Uh oh!

learn-build-service-prod Bot commented May 24, 2026

PoliCheck Scan Report

✅ No issues found

More information about PoliCheck

Uh oh!

learn-build-service-prod Bot commented May 24, 2026

✅ Validation status: passed

Uh oh!

learn-build-service-prod Bot commented May 24, 2026

PoliCheck Scan Report

✅ No issues found

More information about PoliCheck

Uh oh!

learn-build-service-prod Bot commented May 24, 2026

✅ Validation status: passed

Uh oh!

learn-build-service-prod Bot commented May 24, 2026

PoliCheck Scan Report

✅ No issues found

More information about PoliCheck

Uh oh!

learn-build-service-prod Bot commented May 24, 2026

✅ Validation status: passed

Uh oh!

learn-build-service-prod Bot commented Jun 12, 2026

PoliCheck Scan Report

✅ No issues found

More information about PoliCheck

Uh oh!

learn-build-service-prod Bot commented Jun 12, 2026

✅ Validation status: passed

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Copilot AI commented May 24, 2026 •

edited by github-actions Bot

Loading