Comparison with Xamarin.Forms.Maps

Explain about comparison with Xamarin.Form.Maps. Unless otherwise noted, these are supported for Android and iOS onkly.

INDEX

• Adds

  • Polyline, Polygon, Circle supports(v1.1.0-)
  • Select or unselect pin to programmatically(v1.0.0-)
  • Pin selection event(v1.2.0-)
  • Custom marker support(v1.4.0-)
  • Custom tile support(v1.3.0-)

• Changes

  • Add bool animation parameter to Map.MoveToRegion method(from v1.1.0)（Support Android / iOS / UWP）

• Deletions

  • None

---

Added Features

Polyline, Polygon, Circle supports(v1.1.0-)

Can drawing Polyline, Polygon and Circle by common API.

For example, you can add a polyline as follows.

// map as Xamarin.Forms.GoogleMaps.Map

var polyline = new Polyline();
polyline.Positions.Add(new Position(40.77d, -73.93d));
polyline.Positions.Add(new Position(40.81d, -73.91d));
polyline.Positions.Add(new Position(40.83d, -73.87d));

polyline.StrokeColor = Color.Blue;
polyline.StrokeWidth = 5f;
polyline.Tag = "POLYLINE"; // Can set any object

polyline.IsClickable = true;
polyline.Clicked += (s, e) => 
{
    // handle click polyline
};

map.Polylines.Add(polyline);

You can delete a polyline as follows.

map.Polylines.Remove(polyline);

In polyline or polygon, if you set IsClickable to true then you can subscribe Clicked events.

Circle have not IsClickable property and Clicked events. Because Android native Google Maps API does not support circle clicking.

For more information, refer to ShapesPage.xaml.cs in SampleApp - XFGoogleMapSample.

Limitations

• In v1.1.0, Pin, Polyline, Polygon and Circle's each properties does not support binding.

Select or unselect pin to programmatically(v1.0.0-)

You can set pin to Map.SelectedPin, then show info-window and pin marks "selected". Set null to Map.SelectedPin, then close info-window and pin marks "unselected".

For more information, refer to PinsPage.xaml.cs in SampleApp - XFGoogleMapSample.

Pin selection event(v1.2.0-)

Raise Map.SelectedPinChanged event when pin selected.

This event occur when tap pin yourself or set Map.SelectedPin property. If unselected, SelectedPinChangedEventArgs.SelectedPin to be null.

map.SelectedPinChanged += (object sender, SelectedPinChangedEventArgs e) =>
{
    labelStatus.Text = $"SelectedPin changed - {e?.SelectedPin?.Label ?? "nothing"}";
}

Custom marker support(v1.4.0-)

You can customize marker icon.

For example, you can use platform bundle images as marker, as follows.

pin.Icon = BitmapDescriptorFactory.FromBundle("image01.png");

You should prepare image01.png in Android-"Android Asset" or iOS-"BundleResource".

In others, you can use BitmapDescriptorFactory.FromStream and BitmapDescriptorFactory.DefaultMarker.

For more information, refer to CustomPinsPage.xaml.cs in SampleApp - XFGoogleMapSample.

Notice

Custom pin icon in iOS bigger than Android. If you have any comments, please post here - issue #40 .

Custom tile support(v1.3.0-)

Add TileLayer object to Map.TileLayers, you can display original map tiles.

For example, you can display the GSI Maps as follows.

var tileLayer = TileLayer.FromTileUri((int x, int y, int zoom) => 
    new Uri($"https://cyberjapandata.gsi.go.jp/xyz/std/{zoom}/{x}/{y}.png")
);
map.TileLayers.Add(tileLayer);

If you want return image directory, you can use TileLayer.FromSyncImage or TileLayer.FromAsyncImage .

For more information, refer to TilesPage.xaml.cs in SampleApp - XFGoogleMapSample.

Changed Features

Add bool animation parameter to Map.MoveToRegion method(from v1.1.0)（Support Android / iOS / UWP）

Set animate parameter to true, then animation when map panning. set to false, then panning directly. This is optional parameter, default is true.

Deleted Features

• (-v1.3.0）