C#
Latest commit b892cdb Feb 23, 2017 @amay077 committed on GitHub Merge pull request #245 from JKennedy24/patch-2
Amend UWP null check

README.md

Xamarin.Forms.GoogleMaps Build Status

日本語の README はこちら!

Yet another maps library for Xamarin.Forms that optimized for Google maps.

Usage is almost the same as Xamarin.Forms.Maps, Because this is forked from Xamarin.Forms.Maps - github

Try it on your device via DeployGate

screenshot

Motivation

The official Xamarin.Forms.Map has minumn functions only.

Especially, Bing Maps SDK is very old-fashioned because it has not vector-tile, marker's infowindow.

Android and iOS monopolize most the mobile apps market. Thus I think no need Bing maps support.

Furthermore, I am using Google Maps instead of MapKit because it is easy for define common API for Android and iOS.

Xamarin.Forms.GoogleMaps provides maximum Google maps features for Xamarin.Forms!!

Comparison with Xamarin.Forms.Maps

Feature X.F.Maps X.F.GoogleMaps
Map types Yes Yes
Traffic map - Yes
Map events - Yes
Panning with animation Yes Yes
Panning directly - Yes
Pins Yes Yes
Custom Pins - Yes
Pin drag & drop - Yes
Polygons - Yes
Lines - Yes
Circles - Yes
Custom map tiles - Yes

For more information, see Comparison with Xamarin.Forms.Maps.

Setup

Platform Support

Platform Supported
iOS Unified Yes
Android Yes
Windows 10 UWP Yes (Bing map)
Others No

Usage

Same as this

In iOS, get the API Key from Google Maps API for iOS then insert Init of AppDelegate.cs.

[Register("AppDelegate")]
public partial class AppDelegate : global::Xamarin.Forms.Platform.iOS.FormsApplicationDelegate
{
    public override bool FinishedLaunching(UIApplication app, NSDictionary options)
    {
        global::Xamarin.Forms.Forms.Init();
        Xamarin.FormsGoogleMaps.Init("your_api_key");
        LoadApplication(new App());

        return base.FinishedLaunching(app, options);
    }
}

Namespace is Xamarin.Forms.GoogleMaps instead of Xamarin.Forms.Maps.

Sample application is here.

Future plans

I will follow Xamarin.Forms.Maps API as possible. I will add new API only when I implement Google maps original feature.

If you have proposals then send to @amay077 or submit ISSUE or Pull-request!

Latest scheduled features as follows:

  • Pin.ShowInfoWindow/HideInfoWindow method(or IsVisibleInfoWindow property) add in v1.0.0
  • Moving pin by tap and hold add in v1.5.0
  • Adding Polygon, Polyline, Circle add in v1.1.0
  • and more enhancements!

You can use in Windows 10 UWP but this support is reluctant. Because this library has been determined to optimized for Google Maps, New features will not support in UWP.

Contribution

We really appreciate your contribution.

Please read the contribution guideline.

License

See LICENSE.