자습서: Amazon Location의 지오펜스 컬렉션에 트래커 연결

이제 지오펜스 컬렉션과 트래커를 만들었으니, 이들을 서로 연결하여 위치 업데이트가 모든 지오펜스에 대해 자동으로 평가되도록 할 수 있습니다. 모든 위치 업데이트를 평가하고 싶지 않거나 일부 위치를 트래커 리소스에 저장하지 않는 경우 필요한 경우에만 디바이스 위치를 지오펜스와 비교하여 평가할 수 있습니다.

지오펜스를 기준으로 디바이스 위치를 평가하면 이벤트가 생성됩니다. 이러한 이벤트에 작업을 설정할 수 있습니다. 지오펜스 이벤트에 대해 설정할 수 있는 작업에 대한 자세한 내용은 Amazon 를 사용하여 Amazon Location Service 이벤트에 대응을 EventBridge 참조하세요.

Amazon Location 이벤트는 이벤트를 생성하는 디바이스 위치 업데이트의 속성과 입장 또는 퇴장이 발생한 지오펜스의 일부 속성을 포함합니다. 지오펜스 이벤트에 포함된 데이터에 대한 자세한 내용은 Amazon Location Service의 아마존 EventBridge 이벤트 예제 항목을 참조하세요.

다음 예제에서는 콘솔, AWS CLI또는 Amazon Location 을 사용하여 트래커 리소스를 지오펜스 컬렉션에 연결합니다APIs.

Console

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

1. 에서 Amazon Location Service 콘솔을 엽니다https://console.aws.amazon.com/location/.

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

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

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

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

6. 연결을 선택합니다.

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

API

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

Amazon Location Trackers 의 AsssociateTrackerConsumer 작업을 사용합니다APIs.

다음 예제에서는 가 연결하는 API 요청을 사용합니다.ExampleTracker Amazon 리소스 이름()을 사용하여 지오펜스 컬렉션을 사용합니다ARN.

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"