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

# 지오펜스를 기준으로 디바이스 위치 평가하기
<a name="evaluate-geofences"></a>

지오펜스를 기준으로 위치를 평가하여 지오펜스 이벤트를 생성하는 두 가지 방법이 있습니다.
+ 트래커와 지오펜스 컬렉션을 연결할 수 있습니다. 자세한 내용은 [트래커를 지오펜스 컬렉션에 연결](associate-consumer.md) 섹션을 참조하세요.
+ 지오펜스 컬렉션 리소스에 직접 요청하여 하나 이상의 위치를 평가할 수 있습니다.

디바이스 위치 기록을 추적하거나 맵에 위치를 표시하려면 트래커를 지오펜스 컬렉션과 연결합니다. 또는 모든 위치 업데이트를 평가하고 싶지 않거나 위치 데이터를 트래커 리소스에 저장하지 않을 수 있습니다. 두 가지 상황 중 하나에 해당하는 경우 지오펜스 컬렉션에 직접 요청하여 지오펜스와 비교하여 하나 이상의 디바이스 위치를 평가할 수 있습니다.

지오펜스와 비교하여 디바이스 위치를 평가하면 이벤트가 생성됩니다. 이러한 이벤트에 반응하여 다른 AWS 서비스로 라우팅할 수 있습니다. 지오펜스 이벤트를 수신할 때 취할 수 있는 조치에 대한 자세한 내용은 [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를 사용합니다.

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

**Amazon Location API를 사용하여 지오펜스의 위치에 대해 디바이스 위치를 평가하려면**

Amazon Location 지오펜스 API에서 `[BatchEvaluateGeofences](https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_BatchEvaluateGeofences.html)` 작업을 사용합니다.

다음 예시에서는 API 요청을 사용하여 관련 지오펜스 컬렉션 *ExampleGeofenceCollection*에 대한 디바이스 *ExampleDevice*의 위치를 평가합니다. 이 값을 자체 지오펜스 및 디바이스 ID로 바꿉니다.

```
POST /geofencing/v0/collections/ExampleGeofenceCollection/positions HTTP/1.1
Content-type: application/json

{
   "DevicePositionUpdates": [ 
      { 
         "DeviceId": "ExampleDevice",
         "Position": [-123.123, 47.123],
         "SampleTime": "2021-11-30T21:47:25.149Z",
         "Accuracy": {
            "Horizontal": 10.30
         },
         "PositionProperties": {
            "field1": "value1",
            "field2": "value2"
         }
      }
   ]
}
```

------
#### [ AWS CLI ]

** AWS CLI 명령을 사용하여 지오펜스의 위치와 비교하여 디바이스 위치를 평가하려면**

`[batch-evaluate-geofences](https://docs.aws.amazon.com/cli/latest/reference/location/batch-evaluate-geofences.html)` 명령을 사용합니다.

다음 예제에서는 AWS CLI 를 사용하여 연결된 지오펜스 컬렉션 *ExampleGeofenceCollection**ExampleDevice*의 위치를 평가합니다. 이 값을 자체 지오펜스 및 디바이스 ID로 바꿉니다.

```
aws location \
    batch-evaluate-geofences \
        --collection-name ExampleGeofenceCollection \
        --device-position-updates '[{"DeviceId":"ExampleDevice","Position":[-123.123,47.123],"SampleTime":"2021-11-30T21:47:25.149Z","Accuracy":{"Horizontal":10.30},"PositionProperties":{"field1":"value1","field2":"value2"}}]'
```

------