[Xamarin.Forms] 地図にピンを表示する(Xamarin.Forms.Maps編)

Xamarin.Forms.MapsのMapクラスには、Pinsというピン専用のプロパティがあり、Addメソッドを使用してピンを立てることができます。

AddメソッドにはPinクラスのインスタンスを渡します。

このPinクラスには、以下表に示す設定を行うことができます。

Type ピンの種類。Generic, Place, SavedPin, SearchResultのいずれかを指定します。
Position 地図上のピンの表示位置を指定します。
Label ピンに表示するラベルの文字列を指定します。
Address ピンに表示する住所を表す文字を指定します

以下に、2つのピンを表示するコード例を示します。

// 以下追加
using Xamarin.Forms;
using Xamarin.Forms.Maps;
namespace MapSample
{
    public class MapPage : ContentPage
    {
        public MapPage()
        {
            var map = new Map(
                MapSpan.FromCenterAndRadius(
                    new Position(35.6329, 139.8803),
                    Distance.FromKilometers(1.0))) {
                IsShowingUser = true,
                VerticalOptions = LayoutOptions.FillAndExpand,
                HasScrollEnabled = true,
                HasZoomEnabled = false
                    
                                               
            };

            // 1つ目のピンを作成
			var pin1 = new Pin
			{
				Type = PinType.Place,
				Position = new Position(35.6329, 139.8803), 
				Label = "ねずみ〜らんど",
				Address = "夢と魔法の国"
			};
            // Mapに1つ目のピン追加
			map.Pins.Add(pin1);

            // 2つ目のピンを作成
			var pin2 = new Pin
			{
				Type = PinType.Place,
				Position = new Position(35.6267, 139.8850),
				Label = "ねずみ〜し〜",
				Address = "俺の国建設予定地"
			};
            // Mapに2つ目のピンを追加
			map.Pins.Add(pin2);
           
			Content = new StackLayout
            {
                Children = { map }
            };
        }
    }
}

22〜31行目で1つ目のピンを、33〜42行目で2つ目のピンを追加しています。

[Xamarin.Forms] 地図の初期化を理解する(Xamarin.Forms.Maps編)

前回の記事で、地図の表示を行いました。

今回は、地図表示時の初期化コードを掘り下げて見ていきます。

はじめに前回のコードをおさらいしましょう。

using System;

// 以下追加
using Xamarin.Forms;
using Xamarin.Forms.Maps;
namespace MapSample
{
    public class MapPage : ContentPage
    {
        public MapPage()
        {
            var map = new Map(
                MapSpan.FromCenterAndRadius(
                    new Position(35.6329, 139.8803),
                    Distance.FromMiles(0.0))) {
                IsShowingUser = true,
                VerticalOptions = LayoutOptions.FillAndExpand
            };
            Content = new StackLayout
            {
                Children = { map }
            };
        }
    }
}

12行目〜18行目の部分に注目してみましょう。

12行目のnew Mapは、Xamarin.Froms.Map を使用するための初期化コードです。正確にはMapのインスタンスを作成している部分です。

引数に渡しているMapSpan.FromCenterAndRadius(13行目)は、マップ表示時に画面の中央の位置をどこにするかと、表示する半径の距離を設定するものです。

14行目のnew Position()が画面中央の緯度と経度を表します。緯度と経度ともに10進法で指定する必要があります。60進法の指定ではないので注意して下さい。第1引数に緯度を第2引数に経度を指定します。なお、英語で緯度は「Latitude」、経度は「longitude」と言うので、覚えておくと海外サイトの記事も読みやすくなります。

続く15行目のDistance.FromMilesは、画面の中心から半径何マイルを表示するかを設定するものです。FromMilesとなっているので、単位はマイルになります。日本人になじみがあるのはKmなので、 FromKilometersを使用するとよいでしょう。

16行目のIsShowIngUserは、デバイスの現在位置を地図上に表示するかを指定するものです。trueを指定すると、地図上にデバイスの位置を表すマークが表示されるようになります。

17行目のVerticalOptionsは垂直方向の表示オプションです。FillAndExpandを指定しているので、画面いっぱいに表示されます。

これ以外にも指定可能なオプションがあるので紹介します。

HasScrollEnabledは、スクロールを許可するかどうかを指定します。falseを指定するとマップをスクロールして表示することができません。既定値はtrueです。

HasZoomEnabledは、マップの拡大縮小を許可するかどうかを指定します。falseを指定すると、拡大縮小ができなくなります。既定値はtrueです。

以上のオプションを使用して、好みに合った地図が表示されるようにしましょう。

 

[Xamarin.Forms] 地図を表示する(Xamarin.Forms.Maps編)

今回は、Xamarin.Formsで地図を表示する方法を見ていきたいと思います。

使用した環境は Visual Studio for Mac Preview版で、参考にしたサイトは http://www.buildinsider.net/mobile/xamarintips/0039 です。

はじめにプロジェクトの作成をします。

VS for Macでは、[Multiplatform]-[アプリ]を選択し、一覧から「Blank Forms App」を選択します。

続いてApp NameとOrganization Identifierを入力します。

App Nameにはアプリケーション名を、Organization Identifierは、一般的にドメインを逆に入力した文字列を入力します。私の場合は hiros-dot.net というドメインを持っているので「net.hiros-dot」と入力しています。

続いて、プロジェクト名、ソリューション名、ファイル一式を格納する場所を入力します。

とりあえず以上でプロジェクトの作成は完了です。

次にXamrin.Formsで使用可能な地図表示ライブラリ(Xamarin.Forms.Maps)をNuGetから取得します。

メニューの[プロジェクト]-[NuGetパッケージの追加]を選択します。

「パッケージを追加」というダイアログが表示されるので、右上の検索窓で「Xamarin.Forms.Maps」と入力して[Enter]キーを押します。

一覧で「Xamarin.Forms.Maps」にチェックを付けて、右下の[パッケージを追加]ボタンをクリックします。

パッケージの追加が完了したら、参照フォルダを展開してみて下さい。

追加した、Xamarin.Forms.Mapsが追加されていることを確認できます。

さて、いよいよ本題へと移ります。

画面に表示するページを作成します。

「iOS」も「Droid」も付いていないプロジェクトの下にMapPageという名前の新規クラスファイル(MapPage.cs)を作成します。

このMapPageはContentPageクラスを継承して作成します。

using System;

// 以下追加
using Xamarin.Forms;
using Xamarin.Forms.Maps;
namespace MapSample
{
    public class MapPage : ContentPage
    {
        public MapPage()
        {
            var map = new Map(
                MapSpan.FromCenterAndRadius(
                    new Position(35.6329, 139.8803),
                    Distance.FromMiles(0.0))) {
                IsShowingUser = true,
                VerticalOptions = LayoutOptions.FillAndExpand
            };
	    Content = new StackLayout
            {
                Children = { map }
            };
        }
    }
}

参考にしたサイトのコードをそのまま拝借し、new Position と記載している箇所の引数の値を変更しています。この例ではディズニーランドを指しています。

続いて、App.xaml.cs ファイルを以下のように編集します。

using Xamarin.Forms;

namespace MapSample
{
    public partial class App : Application
    {
        public App()
        {
            InitializeComponent();

            MainPage = new MapPage(); 
        }

        protected override void OnStart()
        {
            // Handle when your app starts
        }

        protected override void OnSleep()
        {
            // Handle when your app sleeps
        }

        protected override void OnResume()
        {
            // Handle when your app resumes
        }
    }
}

App() コンストラクタ内では、先ほど作成したMapPageのインスタンスをMainPageに代入するようにしています。

以上で実行すると、以下のように地図が表示されます。

[Xamarin][CrossPlatform][Deviceクラス] Device.Stylesを使用して組み込みスタイルを使用する

Device.Stylesを使用すると、あらかじめ決められた組み込みスタイルを使用することができます。

以下に例を示します。

はじめに書くスタイルをかくにんできるようにLabelを6つ配置しておきます。

<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:local="clr-namespace:DevuceClassSapmle3"
             x:Class="DevuceClassSapmle3.MainPage">

  <StackLayout Padding="10, 30, 10, 10">
      <Label x:Name="label1" Text="Welcome Xamarin Forms!"
           VerticalOptions="Center" HorizontalOptions="Center" />
      <Label x:Name="label2" Text="Welcome Xamarin Forms!"
           VerticalOptions="Center" HorizontalOptions="Center" />
      <Label x:Name="label3" Text="Welcome Xamarin Forms!"
           VerticalOptions="Center" HorizontalOptions="Center" />
      <Label x:Name="label4" Text="Welcome Xamarin Forms!"
           VerticalOptions="Center" HorizontalOptions="Center" />
      <Label x:Name="label5" Text="Welcome Xamarin Forms!"
           VerticalOptions="Center" HorizontalOptions="Center" />
      <Label x:Name="label6" Text="Welcome Xamarin Forms!"
           VerticalOptions="Center" HorizontalOptions="Center" />
  </StackLayout>

</ContentPage>

つづいて、各LabelのStyleプロパティに組み込みスタイルの値を設定します。

public MainPage()
{
    InitializeComponent();

    label1.Style = Device.Styles.BodyStyle;
    label2.Style = Device.Styles.CaptionStyle;
    label3.Style = Device.Styles.ListItemDetailTextStyle;
    label4.Style = Device.Styles.ListItemTextStyle;
    label5.Style = Device.Styles.TitleStyle;
    label6.Style = Device.Styles.SubtitleStyle;
}

上記例のように、組み込みスタイルを使用すると、各プラットフォームで適切なスタイルが設定されるようになります。

実行例を以下に示します。

[Xamarin][CrossPlatform][Deviceクラス] Device.OnPlatformを使用してプラットフォーム毎にXAMLを記述する

XAML内でDevice.OnPlatformを使用すると、プラットフォーム毎に固有の値を記述することができます。

以下はDevice.OnPlatfomrを使用して、プラットフォーム別にLableのテキストカラーを設定する例を以下に示します。

<OnPlatform>のx:TypeArgumentには、コントロールのどの属性を設定するのかを指定します。ここではColotとしているので、テキストカラーをプラットフォーム別に設定することを意味します。

また、iOSやAndroidというプラットフォーム別のプロパティに各値を設定します。

<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:local="clr-namespace:DevuceClassSapmle3"
             x:Class="DevuceClassSapmle3.MainPage">

  <Label Text="Welcome to Xamarin Forms!"
           VerticalOptions="Center"
           HorizontalOptions="Center" >
    <Label.TextColor>
      <OnPlatform x:TypeArguments="Color"
        iOS="Red"
        Android="Blue"
      />
    </Label.TextColor>
  </Label>

</ContentPage>

実行例を以下に示します。