ジオフェンスのセットアップ

[アーティクル]
07/13/2023

注意

MapControl とマップサービスには、MapServiceToken と呼ばれるマップ認証キーが必要です。マップ認証キーを取得して設定する方法について詳しくは、「マップ認証キーの要求」をご覧ください。

アプリでジオフェンスをセットアップし、フォアグラウンドとバックグラウンドで通知を処理する方法について説明します。

ヒント アプリで位置情報にアクセスする方法について詳しくは、GitHub の Windows-universal-samples リポジトリから次のサンプルをダウンロードしてください。

ユニバーサル Windows プラットフォーム (UWP) の地図のサンプル

位置情報機能を有効にする

ソリューションエクスプローラーで、package.appxmanifest をダブルクリックし、[機能] タブを選びます。
[機能] ボックスの一覧で、[位置情報] をオンにします。これにより、Location デバイス機能がパッケージマニフェストファイルに追加されます。

  <Capabilities>
    <!-- DeviceCapability elements must follow Capability elements (if present) -->
    <DeviceCapability Name="location"/>
  </Capabilities>

ジオフェンスのセットアップ

手順 1. ユーザーの位置情報へのアクセス許可を求める

重要: ユーザーの位置情報にアクセスする前に、RequestAccessAsync メソッドを使って、ユーザーに位置情報へのアクセス許可を求める必要があります。 RequestAccessAsync メソッドは UI スレッドから呼び出す必要があり、アプリがフォアグラウンドで実行されている必要があります。アプリがユーザーの位置情報にアクセスするには、先にユーザーがその情報へのアクセス許可をアプリに与える必要があります。

using Windows.Devices.Geolocation;
...
var accessStatus = await Geolocator.RequestAccessAsync();

RequestAccessAsync メソッドを使って、ユーザーに位置情報へのアクセス許可を求めます。ユーザーに対するこの要求はアプリごとに 1 回だけ行われます。アクセス許可の付与または拒否を行った後、このメソッドはユーザーにアクセス許可を求めなくなります。ユーザーが位置情報へのアクセス許可を求められた後にそのアクセス許可を変更できるように、位置情報の設定へのリンクを用意することをお勧めします。これについては、このトピックの後半で紹介します。

手順 2. ジオフェンスの状態変更と位置情報のアクセス許可の変更を登録する

この例では、switch ステートメントを (前の例で示した) accessStatus と共に使って、ユーザーの位置情報へのアクセス許可が与えられている場合にのみ動作するように指定します。ユーザーの位置情報へのアクセスが許可された場合、コードによって現在のジオフェンスにアクセスされ、ジオフェンスの状態変更が登録されます。また、位置情報のアクセス許可の変更も登録されます。

ヒント ジオフェンスを使うときは、Geolocator クラスの StatusChanged イベントではなく、GeofenceMonitor の StatusChanged イベントを使って、位置情報のアクセス許可の変更を監視します。 Disabled の GeofenceMonitorStatus は、無効になった PositionStatus と同じです。どちらも、ユーザーの位置情報にアクセスするためのアクセス許可がアプリにないことを示します。

switch (accessStatus)
{
    case GeolocationAccessStatus.Allowed:
        geofences = GeofenceMonitor.Current.Geofences;

        FillRegisteredGeofenceListBoxWithExistingGeofences();
        FillEventListBoxWithExistingEvents();

        // Register for state change events.
        GeofenceMonitor.Current.GeofenceStateChanged += OnGeofenceStateChanged;
        GeofenceMonitor.Current.StatusChanged += OnGeofenceStatusChanged;
        break;


    case GeolocationAccessStatus.Denied:
        _rootPage.NotifyUser("Access denied.", NotifyType.ErrorMessage);
        break;

    case GeolocationAccessStatus.Unspecified:
        _rootPage.NotifyUser("Unspecified error.", NotifyType.ErrorMessage);
        break;
}

次に、フォアグラウンドアプリから移動するときに、イベントリスナーの登録を解除します。

protected override void OnNavigatingFrom(NavigatingCancelEventArgs e)
{
    GeofenceMonitor.Current.GeofenceStateChanged -= OnGeofenceStateChanged;
    GeofenceMonitor.Current.StatusChanged -= OnGeofenceStatusChanged;

    base.OnNavigatingFrom(e);
}

手順 3. ジオフェンスを作成する

これで、Geofence オブジェクトを定義してセットアップする準備ができました。必要に応じて、複数の異なるコンストラクターオーバーロードから選べます。最も基本的なジオフェンスのコンストラクターで、次に示すように Id と Geoshape のみを指定します。

// Set the fence ID.
string fenceId = "fence1";

// Define the fence location and radius.
BasicGeoposition position;
position.Latitude = 47.6510;
position.Longitude = -122.3473;
position.Altitude = 0.0;
double radius = 10; // in meters

// Set a circular region for the geofence.
Geocircle geocircle = new Geocircle(position, radius);

// Create the geofence.
Geofence geofence = new Geofence(fenceId, geocircle);

他のコンストラクターのいずれかを使用して、ジオフェンスをさらに微調整できます。次の例では、ジオフェンスのコンストラクターで次の追加のパラメーターを指定します。

MonitoredStates - どのジオフェンスイベントで通知を受け取るかを示します。イベントは、定義された領域に入ったとき、定義された領域を離れたとき、ジオフェンスが除去されたときに発生します。
SingleUse - ジオフェンスが監視されている状態がすべて満たされるとジオフェンスを除去します。
DwellTime - 進入または退出イベントがトリガーされる前に、定義された領域の内側または外側にユーザーがどれぐらいとどまる必要があるかを示します。
StartTime - ジオフェンスの監視を開始する時刻を示します。
Duration - ジオフェンスを監視する期間を示します。

// Set the fence ID.
string fenceId = "fence2";

// Define the fence location and radius.
BasicGeoposition position;
position.Latitude = 47.6510;
position.Longitude = -122.3473;
position.Altitude = 0.0;
double radius = 10; // in meters

// Set the circular region for geofence.
Geocircle geocircle = new Geocircle(position, radius);

// Remove the geofence after the first trigger.
bool singleUse = true;

// Set the monitored states.
MonitoredGeofenceStates monitoredStates =
                MonitoredGeofenceStates.Entered |
                MonitoredGeofenceStates.Exited |
                MonitoredGeofenceStates.Removed;

// Set how long you need to be in geofence for the enter event to fire.
TimeSpan dwellTime = TimeSpan.FromMinutes(5);

// Set how long the geofence should be active.
TimeSpan duration = TimeSpan.FromDays(1);

// Set up the start time of the geofence.
DateTimeOffset startTime = DateTime.Now;

// Create the geofence.
Geofence geofence = new Geofence(fenceId, geocircle, monitoredStates, singleUse, dwellTime, startTime, duration);

作成後、新しい Geofence を忘れずにモニターに登録してください。

// Register the geofence
try {
   GeofenceMonitor.Current.Geofences.Add(geofence);
} catch {
   // Handle failure to add geofence
}

手順 4. 位置情報へのアクセス許可の変更を処理する

GeofenceMonitor オブジェクトは StatusChanged イベントをトリガーして、ユーザーの位置情報設定が変化したことを示します。このイベントは、引数の sender.Status プロパティ (GeofenceMonitorStatus 型) を使って、対応する状態を渡します。このメソッドは UI スレッドから呼び出されず、Dispatcher オブジェクトが UI の変更を呼び出します。

using Windows.UI.Core;
...
public async void OnGeofenceStatusChanged(GeofenceMonitor sender, object e)
{
   await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
   {
    // Show the location setting message only if the status is disabled.
    LocationDisabledMessage.Visibility = Visibility.Collapsed;

    switch (sender.Status)
    {
     case GeofenceMonitorStatus.Ready:
      _rootPage.NotifyUser("The monitor is ready and active.", NotifyType.StatusMessage);
      break;

     case GeofenceMonitorStatus.Initializing:
      _rootPage.NotifyUser("The monitor is in the process of initializing.", NotifyType.StatusMessage);
      break;

     case GeofenceMonitorStatus.NoData:
      _rootPage.NotifyUser("There is no data on the status of the monitor.", NotifyType.ErrorMessage);
      break;

     case GeofenceMonitorStatus.Disabled:
      _rootPage.NotifyUser("Access to location is denied.", NotifyType.ErrorMessage);

      // Show the message to the user to go to the location settings.
      LocationDisabledMessage.Visibility = Visibility.Visible;
      break;

     case GeofenceMonitorStatus.NotInitialized:
      _rootPage.NotifyUser("The geofence monitor has not been initialized.", NotifyType.StatusMessage);
      break;

     case GeofenceMonitorStatus.NotAvailable:
      _rootPage.NotifyUser("The geofence monitor is not available.", NotifyType.ErrorMessage);
      break;

     default:
      ScenarioOutput_Status.Text = "Unknown";
      _rootPage.NotifyUser(string.Empty, NotifyType.StatusMessage);
      break;
    }
   });
}

フォアグラウンド通知のセットアップ

ジオフェンスを作成した後で、ジオフェンスイベントが発生したときの処理ロジックを追加する必要があります。セットアップした MonitoredStates に応じて、次の場合にイベントを受け取ります。

ユーザーが関心領域に入った。
ユーザーが関心領域から離れた。
ジオフェンスが期限切れになったか、除去された。除去イベントではバックグラウンドアプリがアクティブ化されないことに注意してください。

実行中のアプリからイベントを直接リッスンすることも、バックグラウンドタスクの登録を行い、イベントが発生するとバックグラウンド通知を受け取ることもできます。

手順 1. ジオフェンスの状態変更イベントに登録する

アプリでジオフェンスの状態変更についてフォアグラウンド通知を受け取るには、イベントハンドラーを登録する必要があります。これは一般にジオフェンスの作成時にセットアップします。

private void Initialize()
{
    // Other initialization logic

    GeofenceMonitor.Current.GeofenceStateChanged += OnGeofenceStateChanged;
}

手順 2. ジオフェンスのイベントハンドラーを実装する

次の手順は、イベントハンドラーの実装です。ここで実行するアクションは、ジオフェンスの利用目的に応じて変わります。

public async void OnGeofenceStateChanged(GeofenceMonitor sender, object e)
{
    var reports = sender.ReadReports();

    await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
    {
        foreach (GeofenceStateChangeReport report in reports)
        {
            GeofenceState state = report.NewState;

            Geofence geofence = report.Geofence;

            if (state == GeofenceState.Removed)
            {
                // Remove the geofence from the geofences collection.
                GeofenceMonitor.Current.Geofences.Remove(geofence);
            }
            else if (state == GeofenceState.Entered)
            {
                // Your app takes action based on the entered event.

                // NOTE: You might want to write your app to take a particular
                // action based on whether the app has internet connectivity.

            }
            else if (state == GeofenceState.Exited)
            {
                // Your app takes action based on the exited event.

                // NOTE: You might want to write your app to take a particular
                // action based on whether the app has internet connectivity.

            }
        }
    });
}

バックグラウンド通知のセットアップ

ユーザーが関心領域に入った。
ユーザーが関心領域から離れた。
ジオフェンスが期限切れになったか、除去された。除去イベントではバックグラウンドアプリがアクティブ化されないことに注意してください。

バックグラウンドでのジオフェンスイベントをリッスンするには

アプリのマニフェストでバックグラウンドタスクを宣言します。
アプリでバックグラウンドタスクを登録します。クラウドサービスへのアクセスなど、インターネットアクセスがアプリに必要な場合は、イベントがトリガーされたときにそのためのフラグを設定できます。イベントがトリガーされたときにユーザーがその場にいて、ユーザーに通知が確実に届くようにするために、フラグを設定することもできます。
アプリをフォアグラウンドで実行中に、位置情報のアクセス許可をアプリに与えるようユーザーに求めます。

手順 1. ジオフェンスの状態変更イベントに登録する

アプリのマニフェストの [宣言] タブで、位置情報バックグラウンドタスクの宣言を追加します。手順は次のとおりです。

タイプが [バックグラウンドタスク] の宣言を追加します。
プロパティのタスクタイプを [位置情報] に設定します。
イベントがトリガーされたときに呼び出すアプリのエントリポイントを設定します。

手順 2. バックグラウンドタスクを登録する

この手順のコードでは、ジオフェンスバックグラウンドタスクを登録しています。ジオフェンスを作成したときに、位置情報のアクセス許可を確認しました。

async private void RegisterBackgroundTask(object sender, RoutedEventArgs e)
{
    // Get permission for a background task from the user. If the user has already answered once,
    // this does nothing and the user must manually update their preference via PC Settings.
    BackgroundAccessStatus backgroundAccessStatus = await BackgroundExecutionManager.RequestAccessAsync();

    // Regardless of the answer, register the background task. Note that the user can use
    // the Settings app to prevent your app from running background tasks.
    // Create a new background task builder.
    BackgroundTaskBuilder geofenceTaskBuilder = new BackgroundTaskBuilder();

    geofenceTaskBuilder.Name = SampleBackgroundTaskName;
    geofenceTaskBuilder.TaskEntryPoint = SampleBackgroundTaskEntryPoint;

    // Create a new location trigger.
    var trigger = new LocationTrigger(LocationTriggerType.Geofence);

    // Associate the location trigger with the background task builder.
    geofenceTaskBuilder.SetTrigger(trigger);

    // If it is important that there is user presence and/or
    // internet connection when OnCompleted is called
    // the following could be called before calling Register().
    // SystemCondition condition = new SystemCondition(SystemConditionType.UserPresent | SystemConditionType.InternetAvailable);
    // geofenceTaskBuilder.AddCondition(condition);

    // Register the background task.
    geofenceTask = geofenceTaskBuilder.Register();

    // Associate an event handler with the new background task.
    geofenceTask.Completed += new BackgroundTaskCompletedEventHandler(OnCompleted);

    BackgroundTaskState.RegisterBackgroundTask(BackgroundTaskState.LocationTriggerBackgroundTaskName);

    switch (backgroundAccessStatus)
    {
    case BackgroundAccessStatus.Unspecified:
    case BackgroundAccessStatus.Denied:
        rootPage.NotifyUser("This app is not allowed to run in the background.", NotifyType.ErrorMessage);
        break;

    }
}

手順 3. バックグラウンド通知を処理する

ユーザーに通知するためにとるアクションは、アプリの用途に応じて変わりますが、トースト通知の表示、サウンドの再生、ライブタイルの更新などが考えられます。この手順のコードは通知を処理します。

async private void OnCompleted(IBackgroundTaskRegistration sender, BackgroundTaskCompletedEventArgs e)
{
    if (sender != null)
    {
        // Update the UI with progress reported by the background task.
        await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
        {
            try
            {
                // If the background task threw an exception, display the exception in
                // the error text box.
                e.CheckResult();

                // Update the UI with the completion status of the background task.
                // The Run method of the background task sets the LocalSettings.
                var settings = ApplicationData.Current.LocalSettings;

                // Get the status.
                if (settings.Values.ContainsKey("Status"))
                {
                    rootPage.NotifyUser(settings.Values["Status"].ToString(), NotifyType.StatusMessage);
                }

                // Do your app work here.

            }
            catch (Exception ex)
            {
                // The background task had an error.
                rootPage.NotifyUser(ex.ToString(), NotifyType.ErrorMessage);
            }
        });
    }
}

プライバシー設定の変更

位置情報のプライバシー設定でアプリにユーザーの位置情報へのアクセス許可を与えていない場合は、設定アプリの [位置情報のプライバシー設定] へのリンクを用意することをお勧めします。この例では、ハイパーリンクコントロールを使って、ms-settings:privacy-location という URI に移動します。

<!--Set Visibility to Visible when access to the user's location is denied. -->  
<TextBlock x:Name="LocationDisabledMessage" FontStyle="Italic"
                 Visibility="Collapsed" Margin="0,15,0,0" TextWrapping="Wrap" >
          <Run Text="This app is not able to access Location. Go to " />
              <Hyperlink NavigateUri="ms-settings:privacy-location">
                  <Run Text="Settings" />
              </Hyperlink>
          <Run Text=" to check the location privacy settings."/>
</TextBlock>

また、アプリで LaunchUriAsync メソッドを呼び出し、コードで設定アプリを起動することもできます。詳しくは、「Windows 設定アプリの起動」をご覧ください。

using Windows.System;
...
bool result = await Launcher.LaunchUriAsync(new Uri("ms-settings:privacy-location"));

アプリのテストとデバッグ

ジオフェンスアプリはデバイスの位置に依存しているため、そのテストとデバッグは容易ではありません。ここでは、フォアグラウンドとバックグラウンドのジオフェンスの両方をテストするいくつかの方法について概略を示します。

ジオフェンスアプリをデバッグするには

デバイスを新しい位置に物理的に移動します。
現在の物理的な位置を含むジオフェンス領域を作成して、ジオフェンスへの進入をテストします。ジオフェンスの内部に既にいるため、"ジオフェンス進入" イベントが直ちにトリガーされます。
Microsoft Visual Studio エミュレーターを使って、デバイスの位置をシミュレートします。

フォアグラウンドで実行中のジオフェンスアプリのテストとデバッグ

フォアグラウンドで実行中のジオフェンスアプリをテストするには

Visual Studio でアプリをビルドします。
Visual Studio エミュレーターでアプリを起動します。
これらのツールを使って、ジオフェンス領域の内外のさまざまな位置をシミュレートします。 DwellTime プロパティで指定した時間が経過してイベントがトリガーされるまで、十分な時間、待ってください。アプリに位置情報のアクセス許可を与えるというメッセージに同意する必要があります。位置のシミュレーションについて詳しくは、「シミュレーターでの Windows ストアアプリの実行」の「デバイスのシミュレートされる地理上の位置を設定する」をご覧ください。
また、さまざまな速度での検出に必要なおおよそのジオフェンスのサイズとドウェル時間を見積もるためにエミュレーターを使うこともできます。

バックグラウンドで実行中のジオフェンスアプリのテストとデバッグ

バックグラウンドで実行中のジオフェンスアプリをテストするには

Visual Studio でアプリをビルドします。アプリでバックグラウンドタスクの種類を Location に設定する必要があります。
最初に、アプリをローカルに展開します。
ローカルで実行中のアプリを閉じます。
Visual Studio エミュレーターでアプリを起動します。バックグラウンドのジオフェンスシミュレーションは、エミュレーター内では一度に 1 つのアプリでしかサポートされていません。エミュレーター内で複数のジオフェンスアプリを起動しないでください。
エミュレーターから、ジオフェンス領域の内外のさまざまな位置をシミュレートします。 DwellTime の時間が経過してイベントがトリガーされるまで、十分な時間、待ってください。アプリに位置情報のアクセス許可を与えるというメッセージに同意する必要があります。
Visual Studio を使って、位置情報バックグラウンドタスクをトリガーします。 Visual Studio でのバックグラウンドタスクのトリガーについて詳しくは、「Visual Studio で Windows ストアアプリの中断イベント、再開イベント、およびバックグラウンドイベントをトリガーする方法」をご覧ください。

アプリのトラブルシューティング

アプリが位置情報にアクセスする前に、デバイスで [位置情報] を有効にする必要があります。設定アプリで、次の位置情報に関するプライバシー設定がオンになっていることを確認します。

[このデバイスの位置情報] がオンになっている (Windows 10 Mobile には適用されません)
位置情報サービス設定の [位置情報] がオンになっている
[位置情報を使うことができるアプリを選ぶ] で、アプリがオンになっている

ジオフェンスのセットアップ

位置情報機能を有効にする

ジオフェンスのセットアップ

手順 1. ユーザーの位置情報へのアクセス許可を求める

手順 2. ジオフェンスの状態変更と位置情報のアクセス許可の変更を登録する

手順 3. ジオフェンスを作成する

手順 4. 位置情報へのアクセス許可の変更を処理する

フォアグラウンド通知のセットアップ

手順 1. ジオフェンスの状態変更イベントに登録する

手順 2. ジオフェンスのイベントハンドラーを実装する

バックグラウンド通知のセットアップ

手順 1. ジオフェンスの状態変更イベントに登録する

手順 2. バックグラウンドタスクを登録する

手順 3. バックグラウンド通知を処理する

プライバシー設定の変更

アプリのテストとデバッグ

フォアグラウンドで実行中のジオフェンスアプリのテストとデバッグ

バックグラウンドで実行中のジオフェンスアプリのテストとデバッグ

アプリのトラブルシューティング

フィードバック

フィードバック

その他のリソース

ジオフェンスのセットアップ

位置情報機能を有効にする

ジオフェンスのセットアップ

手順 1. ユーザーの位置情報へのアクセス許可を求める

手順 2. ジオフェンスの状態変更と位置情報のアクセス許可の変更を登録する

手順 3. ジオフェンスを作成する

手順 4. 位置情報へのアクセス許可の変更を処理する

フォアグラウンド通知のセットアップ

手順 1. ジオフェンスの状態変更イベントに登録する

手順 2. ジオフェンスのイベント ハンドラーを実装する

バックグラウンド通知のセットアップ

手順 1. ジオフェンスの状態変更イベントに登録する

手順 2. バックグラウンド タスクを登録する

手順 3. バックグラウンド通知を処理する

プライバシー設定の変更

アプリのテストとデバッグ

フォアグラウンドで実行中のジオフェンス アプリのテストとデバッグ

バックグラウンドで実行中のジオフェンス アプリのテストとデバッグ

アプリのトラブルシューティング

関連トピック

フィードバック

フィードバック

その他のリソース

手順 2. ジオフェンスのイベントハンドラーを実装する

手順 2. バックグラウンドタスクを登録する

フォアグラウンドで実行中のジオフェンスアプリのテストとデバッグ

バックグラウンドで実行中のジオフェンスアプリのテストとデバッグ