search

unoplatform / uno

Open-source platform for building cross-platform native Mobile, Web, Desktop and Embedded apps quickly. Create rich, C#/XAML, single-codebase apps from any IDE. Hot Reload included! 90m+ NuGet Downloads!!
https://platform.uno
Apache License 2.0
8.93k stars 725 forks source link

[Docs] `MapControl` documentation is outdated #17904

Open morning4coffe-dev opened 2 months ago

morning4coffe-dev commented 2 months ago

On which page?

https://platform.uno/docs/articles/controls/map-control-support.html

What's wrong?

When trying to setup MapControl with the current Uno.Sdk version 5.3 and single project structure, I wasn't able to setup the MapControl when following the docs steps.

Any feedback?

What to check: Are there any Single Project specifics? Uno.UI and Uno.WinUI might be confusing Windows seems to be deprecated soon https://learn.microsoft.com/en-us/uwp/api/windows.ui.xaml.controls.maps.mapcontrol?view=winrt-26100#remarks? - replace with Microsoft.UI.Xaml.Controls.MapControl? We could mention MapsUI as more feature rich alternative?

trydalch commented 2 months ago

While Mapsui is certainly feature rich, it isn't very easy to consume and the documentation there is lacking. There are many samples where the source is available, which helps, but isn't enough imo.

Overall, I much prefer the API of https://github.com/react-native-maps/react-native-maps. If whatever solution gets implemented followed that pattern, (particularly with regards to being able to put any user control on a pin), that would be far superior from an API consumer perspective.

trydalch commented 2 months ago

Unfortunately, it sounds like the Microsoft.UI.Xaml.Controls.MapControl will soon not work once Bing Enterprise Maps is officially retired.

image