Skip to content

Update MAUI Map docs for Windows Azure Maps support - #3357

Merged
jfversluis merged 7 commits into
mainfrom
copilot/update-docs-azure-maps-maui
Jun 15, 2026
Merged

Update MAUI Map docs for Windows Azure Maps support#3357
jfversluis merged 7 commits into
mainfrom
copilot/update-docs-azure-maps-maui

Conversation

Copilot AI commented May 24, 2026

Copy link
Copy Markdown
Contributor

.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

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 6b17e22:

✅ Validation status: passed

For more details, please refer to the build report.

Copilot AI and others added 2 commits May 24, 2026 12:59
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>
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

Copy link
Copy Markdown
Contributor

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

Copy link
Copy Markdown
Contributor

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>
Copilot AI changed the title [WIP] Update docs to reflect addition of Azure Maps in MAUI May 24, 2026
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

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.

Copilot AI requested a review from jfversluis May 24, 2026 13:01
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

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

Copy link
Copy Markdown
Contributor

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

Copy link
Copy Markdown
Contributor

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.

Copilot AI review requested due to automatic review settings June 12, 2026 12:56
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

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

Copy link
Copy Markdown
Contributor

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 AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.
Comment thread docs/user-interface/controls/map.md
Comment thread docs/user-interface/controls/map.md
Comment thread docs/user-interface/controls/map.md
Comment thread docs/user-interface/controls/map.md
Comment thread docs/user-interface/controls/map.md Outdated

@davidortinau davidortinau left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved once you validate those Copilot suggestions.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit e8cd8bb:

✅ 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

Copy link
Copy Markdown
Contributor

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.

@jfversluis
jfversluis merged commit 0e7e564 into main Jun 15, 2026
7 checks passed
@jfversluis
jfversluis deleted the copilot/update-docs-azure-maps-maui branch June 15, 2026 19:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

4 participants