最近のアクセス:
位置情報近接アラートを使用する方法

ここでは、位置情報近接アラートを使用するために必要な手順を説明します。
以下のメソッドは、ある位置情報に対して、指定した距離よりも近くなったり、その距離よりも遠ざかったりした場合に、ユーザーにアラートを送信するアプリケーションを作成するために使用します。

新しいアラートの設定手順

新しいアラートはデバイス上で作成されます。これを行うには、次の 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()

考慮事項

  • Apple デバイスでこの機能を使用するには、開発者は、 [ Location Always usage description ] を設定する必要があります。
  • Android デバイスでこの機能を使用するには、ネイティブモバイルの [ Main object properties ] [ Use Proximity Alert ] プロパティを有効にする必要があります。このプロパティの目的は、デバイスを再起動してもアラートが残るようにすることです。

こちらからサンプルをダウンロードできます: 位置情報近接アラートのサンプル

参考情報

Geolocation 外部オブジェクト
SetProximityAlerts メソッド
GetCurrentProximityAlert メソッド
GetProximityAlerts メソッド
ClearProximityAlerts メソッド
GeolocationProximityAlert データタイプ


サブページ
Created: 18/10/28 23:59 by Admin Last update: 24/03/25 23:57 by Admin
カテゴリ
Powered by GXwiki 3.0