トラッカーをジオフェンスコレクションにリンクする - Amazon Location Service

トラッカーをジオフェンスコレクションにリンクする

ジオフェンスコレクションとトラッカーを作成したので、これらをリンクして、位置情報の更新がすべてのジオフェンスに対して自動的に評価されるようにします。位置情報の更新をすべて評価したくない場合や、一部の位置情報をトラッカーリソースに保存していない場合は、オンデマンドでジオフェンスに対してデバイス位置を評価することができます。

ジオフェンスに対してデバイス位置を評価すると、イベントが生成されます。これらのイベントにはアクションを設定できます。ジオフェンスイベントに設定できるアクションの詳細については、「Amazon EventBridge による Amazon Location Service イベントへの対応」を参照してください。

Amazon Location イベントには、そのイベントを生成するデバイス位置更新の属性と、出入りしたジオフェンスの属性の一部が含まれます。ジオフェンスイベントに含まれるデータについては、「Amazon Location Service 用の Amazon EventBridge イベントの例」を参照してください。

以下の例では、コンソール、AWS CLI、または Amazon Location API を使用してトラッカーリソースをジオフェンスコレクションにリンクしています。

Console

Amazon Location Service コンソールを使用してトラッカーリソースをジオフェンスコレクションにリンクするには

  1. Amazon Location Service コンソール (https://console.aws.amazon.com/location/) を開きます。

  2. 左のナビゲーションペインから、[トラッカー] を選択します。

  3. [デバイストラッカー] で、対象トラッカーの名前リンクを選択します。

  4. [リンクされたジオフェンスコレクション] で [ジオフェンスコレクションをリンク] を選択します。

  5. [リンクされたジオフェンスコレクション] ウィンドウのドロップダウンメニューからジオフェンスコレクションを選択します。

  6. [Link (リンク)] を選択します。

トラッカーリソースをリンクすると、そのリソースには[アクティブ] ステータスが割り当てられます。

API

Amazon Location API を使用してトラッカーリソースをジオフェンスコレクションにリンクするには

Amazon Location Trackers API の AsssociateTrackerConsumer オペレーションを使用してください。

以下は、Amazon リソースネーム (ARN) を使用して ExampleTracker をジオフェンスコレクションにリンクする API リクエストの例です。

POST /tracking/v0/trackers/ExampleTracker/consumers
Content-type: application/json

{
   "ConsumerArn": "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleGeofenceCollection"
}
AWS CLI

AWS CLI コマンドを使用してトラッカーリソースをジオフェンスコレクションにリンクするには

associate-tracker-consumer コマンドを使用します。

次の例では、AWS CLIを使用して ExampleGeofenceCollection というジオフェンスコレクションを作成しています。

aws location \
    associate-tracker-consumer \
        --consumer-arn "arn:aws:geo:us-west-2:123456789012:geofence-collection/ExampleGeofenceCollection" \
        --tracker-name "ExampleTracker"