翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# トラッカーをジオフェンスコレクションにリンクする
<a name="associate-consumer"></a>

ジオフェンスコレクションとトラッカーを作成したので、これらをリンクして、位置情報の更新がすべてのジオフェンスに対して自動的に評価されるようにします。位置情報の更新をすべて評価したくない場合や、一部の位置情報をトラッカーリソースに保存していない場合は、オンデマンドで[ジオフェンスに対してデバイス位置を評価](https://docs.aws.amazon.com/location/latest/developerguide/evaluate-geofences.html)することができます。

ジオフェンスに対してデバイス位置を評価すると、イベントが生成されます。これらのイベントにはアクションを設定できます。ジオフェンスイベントに設定できるアクションの詳細については、「[Amazon EventBridge による Amazon Location Service イベントへの対応](https://docs.aws.amazon.com/location/latest/developerguide/location-events.html)」を参照してください。

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

次の例では、 コンソール、、 AWS CLIまたは Amazon Location APIs。

------
#### [ Console ]

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

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

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

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

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

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

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

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

------
#### [ API ]

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

Amazon Location Trackers API の `[AsssociateTrackerConsumer](https://docs.aws.amazon.com/location-trackers/latest/APIReference/API_AssociateTrackerConsumer.html)` オペレーションを使用してください。

以下は、[Amazon リソースネーム](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) (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](https://docs.aws.amazon.com/cli/latest/reference/location/associate-tracker-consumer.html)` コマンドを使用します。

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

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

------