기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 트래커를 지오펜스 컬렉션에 연결
<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. [https://console.aws.amazon.com/location/](https://console.aws.amazon.com/location/home)에서 Amazon Location Service 콘솔을 엽니다.

1. 왼쪽 탐색 창에서 **트래커**를 선택합니다.

1. **디바이스 트래커**에서 대상 트래커의 이름 링크를 선택합니다.

1. **연결된 지오펜스 컬렉션**에서 **지오펜스 컬렉션 연결**을 선택합니다.

1. **연결된 지오펜스 컬렉션** 창의 드롭다운 메뉴에서 지오펜스 컬렉션을 선택합니다.

1. **연결**을 선택합니다.

트래커 리소스를 연결하면 해당 리소스에 **활성** 상태가 할당됩니다.

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

**Amazon Location API를 사용하여 트래커 리소스를 지오펜스 컬렉션에 연결하려면**

Amazon Location Trackers API에서 `[AsssociateTrackerConsumer](https://docs.aws.amazon.com/location-trackers/latest/APIReference/API_AssociateTrackerConsumer.html)` 작업을 사용합니다.

다음 예시에서는 [Amazon 리소스 이름(ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html)을 사용하여 *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"
```

------