カスタムマーカーに対応した Xamarin.Forms.GoogleMaps v1.4.0 をリリースしました
Xamarin.Forms.GoogleMaps v1.4.0 をリリースしました。
待望？のカスタムマーカーに対応しました。
カスタムマーカーの使い方
Pin.Icon に BitmapDescriptorFactory により生成される BitmapDescriptor を設定します。
BitmapDescriptorFactory の３つのファクトリメソッドにより、
「デフォルトマーカーの色を変える」「プラットフォーム毎の画像リソースを使用する」「共通の画像リソースを使用する」
の３つが使用できます。
デフォルトマーカーの色を変える
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 iOS と Google Maps Android API を直接使用した時もこうなるので、両者の仕様というかプラットフォーム自体の仕様なのかも知れません。
特に BitmapDescriptorFactory.FromStream を使用した時には使い勝手が悪いのですが、「ネイティブの Google Maps SDK の機能を共通APIでラップする」のが第一目標なので、とりあえず画像を何も加工しない実装でリリースしました。
何か原因などについてヒントがある方は
に書いてもらえると助かります（日本語で大丈夫です）。
サンプルプログラム
XFGoogleMapSample の CustomPinsPage.xaml.cs でこれらの機能を使用しています。
是非使ってみてください。よければ Github リポジトリ に Star ください。