ここでは、位置情報近接アラートを使用するために必要な手順を説明します。
以下のメソッドは、ある位置情報に対して、指定した距離よりも近くなったり、その距離よりも遠ざかったりした場合に、ユーザーにアラートを送信するアプリケーションを作成するために使用します。
新しいアラートはデバイス上で作成されます。これを行うには、次の 2 つの手順に従います:
1.メインオブジェクトで
アクション (クライアント側で実行されるユーザー定義のイベント) を作成します。
このイベントは、アラートがトリガーされたときに実行されます。次に例を示します:
Event 'ProxAlertNotification'
// イベントコード
EndEvent
2.SetProximityAlerts メソッドを使用して、次のデータを設定します:
- 名前
- 説明
- 位置情報
- 半径
- 有効期限
- アクション名
これらの情報をメソッドに渡すには、
GeolocationProximityAlert SDT (
&alert) にロードし、同じタイプのコレクション (&
alerts) に追加する必要があります。
&alert.ActionName = 'ProxAlertNotification'
&alert.Name = 'Test'
&alert.ExpirationTime = #2015-12-31#
&alert.GeoLocation = '-35,-56'
&alert.Radius = 1000
&alerts.Add(&alert)
&boolean = Geolocation.SetProximityAlerts(&alerts)
この場合、ユーザーが位置情報 '-35,-56' から 1000mts 以内になるか、この位置情報から 1000m 以上離れると、アラートがトリガーされ、それに伴って 'ProxAlertNotification' イベントが実行されます。
アラートがトリガーされたときにイベントを実行するかどうかは任意です。イベントを実行する場合、どのアラートによってどのイベントが実行されたかを把握しておく必要があります。
その情報を取得するには、アラートによって実行されたイベントでこのメソッドを使用する必要があります。
&alert = &Geolocation.GetCurrentProximityAlert()
デバイスでアクティブなアラートのリストを取得するには、
GetProximityAlerts メソッドを使用する必要があります。
&alerts = Geolocation.GetProximityAlerts()
デバイスに設定されたすべてのアラートを削除するには、次のように
ClearProximityAlerts メソッドを実行する必要があります:
Geolocation.ClearProximityAlerts()
こちらからサンプルをダウンロードできます:
位置情報近接アラートのサンプル。
Geolocation 外部オブジェクト
SetProximityAlerts メソッド
GetCurrentProximityAlert メソッド
GetProximityAlerts メソッド
ClearProximityAlerts メソッド
GeolocationProximityAlert データタイプ