Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jamesmontemagno/LaunchMapsPlugin
Launch External Maps Plugin for Xamarin and Windows
https://github.com/jamesmontemagno/LaunchMapsPlugin
uwp xamarin xamarin-android xamarin-forms xamarin-ios xamarin-plugin
Last synced: 3 months ago
JSON representation
Launch External Maps Plugin for Xamarin and Windows
- Host: GitHub
- URL: https://github.com/jamesmontemagno/LaunchMapsPlugin
- Owner: jamesmontemagno
- License: mit
- Archived: true
- Created: 2016-06-02T23:19:38.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-04-03T20:33:34.000Z (over 1 year ago)
- Last Synced: 2024-07-05T21:48:47.247Z (4 months ago)
- Topics: uwp, xamarin, xamarin-android, xamarin-forms, xamarin-ios, xamarin-plugin
- Language: C#
- Size: 433 KB
- Stars: 48
- Watchers: 4
- Forks: 13
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-xamarin-forms - Extended Maps ★50
README
## Launch Maps Plugin for Xamarin and Windows
Open external maps to a specific geolocation or address in your Xamarin.iOS, Xamarin.Android, Windows, and Xamarin.Forms projects.
### Migrate to: [Xamarin.Essentials](https://docs.microsoft.com/xamarin/essentials/index?WT.mc_id=friends-0000-jamont) or [.NET MAUI](https://learn.microsoft.com/dotnet/maui/platform-integration/?WT.mc_id=friends-0000-jamont)
I have been working on Plugins for Xamarin for a long time now. Through the years I have always wanted to create a single, optimized, and official package from the Xamarin team at Microsoft that could easily be consumed by any application. The time is now with [Xamarin.Essentials](https://docs.microsoft.com/xamarin/essentials/index?WT.mc_id=friends-0000-jamont), which offers over 50 cross-platform native APIs in a single optimized package. I worked on this new library with an amazing team of developers and I highly highly highly recommend you check it out.
Additionally, Xamarin.Essentials is now included in & [.NET MAUI](https://learn.microsoft.com/dotnet/maui/platform-integration/?WT.mc_id=friends-0000-jamont).
Due to the functionality being included "in the box" I have decided to officially archive this repo.
#### Setup
* Available on NuGet: https://www.nuget.org/packages/Xam.Plugin.ExternalMaps [](https://www.nuget.org/packages/Xam.Plugin.ExternalMaps/)
* Install into your PCL project and Client projects.
Build status: [](https://ci.appveyor.com/project/JamesMontemagno/launchmapsplugin)
**Platform Support**
|Platform|Version|
| ------------------- | :------------------: |
|Xamarin.iOS|iOS 7+|
|Xamarin.Android|API 10+|
|Windows 10 UWP|10+|
|Xamarin.Mac|Yes||
#### Usage
There are two methods that you can call to navigate either with the geolocation lat/long or with a full address to go to.
```csharp
///
/// Navigate to specific latitude and longitude.
///
/// Label to display
/// Lat
/// Long
/// Type of navigation
Task NavigateTo(string name, double latitude, double longitude, NavigationType navigationType = NavigationType.Default);
///
/// Navigate to an address
///
/// Label to display
/// Street
/// City
/// Sate
/// Zip
/// Country
/// Country Code if applicable
/// Navigation type
Task NavigateTo(string name, string street, string city, string state, string zip, string country, string countryCode, NavigationType navigationType = NavigationType.Default);
```
Examples:
```csharp
var success = await CrossExternalMaps.Current.NavigateTo("Xamarin", "394 pacific ave.", "San Francisco", "CA", "94111", "USA", "USA");
var success = await CrossExternalMaps.Current.NavigateTo("Space Needle", 47.6204, -122.3491);
```
**Platform Tweaks**
* NavigationType only works on iOS and macOS
* Android will try to launch Google Maps first. If it is not installed then it will ask to see if a map apps is installed. If that doesn't work then it will launch the browser.
#### Contributions
Contributions are welcome! If you find a bug please report it and if you want a feature please report it.
If you want to contribute code please file an issue and create a branch off of the current dev branch and file a pull request.
#### License
Under MIT, see LICENSE file.