Add packaged README for Microsoft.Maui.Controls.Maps with quick start guidance

[Copilot]

• Update Circle sample to use Location/Distance objects instead of string Center and numeric Radius
• Validation (doc-only change; no automated tests run)

Original prompt

Take what you did for #32835 and apply it to the Maps NuGet as well. You can add the README in the root of the Maps project folder and link it from there. Make sure it gives a good description on how to get started with the Maps APIs. You can also find more information here: https://learn.microsoft.com/dotnet/maui/user-interface/controls/map?view=net-maui-10.0 make sure to also link there from this README. The README should be part of the NuGet package.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[jfversluis]

@copilot can you add a little bit more about different features like pins, polygons and what else is available?

[Copilot]

@copilot can you add a little bit more about different features like pins, polygons and what else is available?

Added a new feature summary section covering pins, polygons/polylines/circles, map interactions (MapClicked, camera/region control), and map display options in the README. Commit: 4f34777.

[jfversluis]

@copilot do not only add them at a glance, add some samples of that as well

[Copilot]

@copilot do not only add them at a glance, add some samples of that as well

Added concrete XAML samples for pins plus polygon, polyline, and circle (with MapClicked hook) in the README. Commit: 88a1db8.

[jfversluis]

@copilot lets remove this from the link to the docs ?view=net-maui-10.0 also add samples for interactions, different maps modes, and what else you can come up with that is important to know about working with maps. Leverage online sources to see what people are asking about maps and include that

[Copilot]

@copilot lets remove this from the link to the docs ?view=net-maui-10.0 also add samples for interactions, different maps modes, and what else you can come up with that is important to know about work...

Updated the README to use the version-agnostic docs link and added runnable samples for interactions (MapClicked drop pin + MoveToRegion), map mode toggle, and common runtime toggles like showing user location and traffic. Commit: 0f291c9.

[Copilot]

Pull request overview

This PR adds a packaged README file to the Microsoft.Maui.Controls.Maps NuGet package to help developers get started with the Maps API. The README includes setup instructions, platform-specific configuration guidance, XAML examples, and links to official documentation.

Key Changes

• Added NuGet package README with quick start guide and sample code
• Configured package metadata to include the README in the NuGet package
• Documented platform support (Android and iOS working, Windows not yet implemented)

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File	Description
src/Controls/Maps/src/Controls.Maps.csproj	Added PackageReadmeFile property and configured the README.md to be included in the NuGet package
src/Controls/Maps/README.md	New comprehensive README with setup instructions, XAML samples, code examples, and links to official documentation

[PureWeen]

@copilot

Can you evaluate this review and see if you agree with the suggestions?

PR Review: Maps README

Thanks for adding the README to the Maps NuGet package! The structure and content are great, but I found a few issues that need to be addressed before merging.

🔴 Critical: Non-existent LocationCollection class

The XAML samples use <maps:LocationCollection> which does not exist in the .NET MAUI codebase. This will cause XAML compilation failures for users following the README.

Current (incorrect):

<maps:Polygon.Geopath>
    <maps:LocationCollection>
        <essentials:Location Latitude="47.642" Longitude="-122.323" />
    </maps:LocationCollection>
</maps:Polygon.Geopath>

Should be (per official docs):

<maps:Polygon.Geopath>
    <sensors:Location>
        <x:Arguments>
            <x:Double>47.642</x:Double>
            <x:Double>-122.323</x:Double>
        </x:Arguments>
    </sensors:Location>
    <sensors:Location>
        <x:Arguments>
            <x:Double>47.643</x:Double>
            <x:Double>-122.326</x:Double>
        </x:Arguments>
    </sensors:Location>
</maps:Polygon.Geopath>

The Geopath property is IList<Location> - XAML should add Location elements directly to it.

🟡 Namespace declarations

The namespace declarations don't match the official documentation pattern:

Current:

xmlns:maps="clr-namespace:Microsoft.Maui.Controls.Maps"
xmlns:essentials="clr-namespace:Microsoft.Maui.Devices.Sensors;assembly=Microsoft.Maui"

Should be:

xmlns:maps="http://schemas.microsoft.com/dotnet/2021/maui/maps"
xmlns:sensors="clr-namespace:Microsoft.Maui.Devices.Sensors;assembly=Microsoft.Maui.Essentials"

🟢 Minor: Location property syntax

The README uses property syntax (Latitude="..." Longitude="..."), while official samples consistently use constructor syntax with x:Arguments. Both may work, but using constructor syntax would be more consistent with official documentation.

---

✅ What looks good

• csproj configuration is correct
• C# code samples are accurate
• Platform-specific guidance is complete
• Documentation links are valid
• Overall structure follows the pattern from PR Add comprehensive README to Microsoft.Maui.Controls NuGet package #32835

[PureWeen]

@copilot Copilot can you try again please

[PureWeen]

@copilot can you try again please

[PureWeen]

@copilot copilot can you try again please?

[PureWeen]

@copilot can you try again?

[PureWeen]

@copilot can you try again?