Xamarin.Forms.GoogleMaps v1.4.0 をリリースしました。

待望?のカスタムマーカーに対応しました。

カスタムマーカーの使い方

Pin.IconBitmapDescriptorFactory により生成される BitmapDescriptor を設定します。

BitmapDescriptorFactory の3つのファクトリメソッドにより、
「デフォルトマーカーの色を変える」「プラットフォーム毎の画像リソースを使用する」「共通の画像リソースを使用する」
の3つが使用できます。

デフォルトマーカーの色を変える

iOS:GMSMarker.markerImageWithColor, Android:BitmapDescriptorFactory.defaultMarker に対応する、既定のマーカー形状の色のみを変える機能です。

以下のように、 BitmapDescriptorFactory.DefaultMarker(Color) メソッドを使用します。

pin.Icon = BitmapDescriptorFactory.DefaultMarker(Color.Pink);

プラットフォーム毎の画像リソースを使用する

iOS:UIImage.imageNamed, Android:BitmapDescriptorFactory.fromAsset に対応する、プラットフォーム固有の画像リソースを、マーカー画像として使用する機能です。

以下のように、 BitmapDescriptorFactory.FromBundle(string) メソッドを使用します。

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

引数の bundleName は、 同じ名称で 、プラットフォーム毎に次のように用意されている必要があります。

Android の場合

Android側のプロジェクトの Assets ディレクトリ内に image01.png を追加し、 Build Action を ”Android Asset” に設定します。

iOS の場合

iOS側のプロジェクト image01.png を追加し、 Build Action を ”BundleResource” に設定します。

共通の画像リソースを使用する

画像を Stream を直接指定できる、機能です。

以下のように、 BitmapDescriptorFactory.DefaultMarker(Color) メソッドを使用します。

// PCLプロジェクトに EmbeddedResouece として追加した "marker01.png" を読み込んで Stream 化
var assembly = typeof(CustomPinsPage).GetTypeInfo().Assembly;
var stream = assembly.GetManifestResourceStream($"XFGoogleMapSample.marker01.png");

// Stream をマーカーに設定
pin.Icon = BitmapDescriptorFactory.FromStream(stream);

【注意】プラットフォーム毎のマーカーサイズの違い

「プラットフォーム毎の画像リソースを使用する」「共通の画像リソースを使用する」で見られる現象なのですが、iOS と Android では 同じサイズの画像を指定しているのに iOS の方が大きく描画されます

なぜこうなるのか分かりませんが、 Google Maps SDK for iOSGoogle Maps Android API を直接使用した時もこうなるので、両者の仕様というかプラットフォーム自体の仕様なのかも知れません。

特に BitmapDescriptorFactory.FromStream を使用した時には使い勝手が悪いのですが、「ネイティブの Google Maps SDK の機能を共通APIでラップする」のが第一目標なので、とりあえず画像を何も加工しない実装でリリースしました。

何か原因などについてヒントがある方は

に書いてもらえると助かります(日本語で大丈夫です)。

サンプルプログラム

XFGoogleMapSampleCustomPinsPage.xaml.cs でこれらの機能を使用しています。

是非使ってみてください。よければ Github リポジトリ に Star ください。

Xamarin
Xamarin.Forms
Android
iOS
GoogleMapsAPI
ReleaseNotes
Xamarin.Forms.GoogleMaps

published

Ads

Read more!

amay077

Microsoft MVP(Xamarin). フルリモートワーカー. Geospatial Mobile app developer. Love C#.

amay077 amay077