Skip to content

Update MAUI Map docs for Windows Azure Maps support#3357

Open
Copilot wants to merge 5 commits into
mainfrom
copilot/update-docs-azure-maps-maui
Open

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

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented May 24, 2026

.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 Update MAUI Map docs for Windows Azure Maps support 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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update docs to reflect the addition of Azure Maps in MAUI

2 participants