지오펜스를 기준으로 위치를 평가하여 지오펜스 이벤트를 생성하는 두 가지 방법이 있습니다.
-
트래커와 지오펜스 컬렉션을 연결할 수 있습니다. 자세한 내용은 자습서: Amazon Location의 지오펜스 컬렉션에 트래커 연결 섹션을 참조하세요.
-
BatchEvaluateGeofences API를 사용하면 지오펜스 컬렉션 리소스에 직접 요청하여 하나 이상의 위치를 평가할 수 있습니다.
또한 지오펜스 내에서 디바이스가 들어오거나, 나가거나 또는 유휴 상태로 유지되는 경우 들어오는 지오펜스 이벤트를 예측할 수 있습니다. ForecastGeofenceEvents API를 사용하여 이벤트를 예측합니다.
디바이스 위치 기록을 추적하거나 맵에 위치를 표시하려면 트래커를 지오펜스 컬렉션과 연결합니다. 또는 모든 위치 업데이트를 평가하고 싶지 않거나 위치 데이터를 트래커 리소스에 저장하지 않을 수 있습니다. 두 가지 상황 중 하나에 해당하는 경우 지오펜스 컬렉션에 직접 요청하여 지오펜스와 비교하여 하나 이상의 디바이스 위치를 평가할 수 있습니다.
지오펜스와 비교하여 디바이스 위치를 평가하면 이벤트가 생성됩니다. 이러한 이벤트에 반응하여 다른 AWS 서비스로 라우팅할 수 있습니다. 지오펜스 이벤트를 수신할 때 취할 수 있는 조치에 대한 자세한 내용은 Amazon EventBridge를 사용하여 Amazon Location Service 이벤트에 대응하기를 참조하세요.
Amazon Location 이벤트는 시간, 위치, 정확도, 키-값 메타데이터 등 이벤트를 생성하는 디바이스 위치 업데이트의 속성과 입장 또는 퇴장이 발생한 지오펜스의 일부 속성을 포함합니다. 지오펜스 이벤트에 포함된 데이터에 대한 자세한 내용은 Amazon Location Service용 Amazon EventBridge 이벤트 예시 항목을 참조하세요.
다음 예시에서는 AWS CLI 또는 Amazon Location API를 사용합니다.
Amazon Location API를 사용하여 지오펜스의 위치에 대해 디바이스 위치를 평가하려면
Amazon Location 지오펜스 API에서 BatchEvaluateGeofences 작업을 사용합니다.
다음 예시에서는 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" } } ] }
지오펜스와 비교하여 디바이스 위치를 평가하면 이벤트가 생성됩니다. 전통적으로 Amazon EventBridge를 사용하여 이벤트에 대응할 수 있지만 이 프로세스를 통해 이후 발생한 이벤트에만 대응할 수 있습니다. 디바이스가 지오펜스에 들어오거나 나가는 시점을 예상해야 하는 경우, 예를 들어 디바이스가 경계를 넘어 다른 규정이 적용되는 경우 ForecastGeofenceEvents API를 사용하여 향후 지오펜스 이벤트를 예측할 수 있습니다.
ForecastGeofenceEvents API는 디바이스의 위반 시간, 근접성, 속도 및 위치와 같은 기준을 사용하여 이벤트를 예측합니다. API는 ForecastedBreachTime을 반환하며, 이는 지오펜스 이벤트가 발생할 예상 시간을 나타냅니다.
다음 예제에서는 Amazon Location API를 사용합니다.
Amazon Location API를 사용하여 지오펜스 이벤트를 예측하려면
Amazon Location 지오펜스 API에서 ForecastGeofenceEvents 작업을 사용합니다.
다음 예제에서는 API 요청을 사용하여 ExampleGeofence와 관련된 ExampleDevice에 대한 지오펜스 이벤트를 예측합니다. 이 값을 자체 지오펜스 및 디바이스 ID로 바꿉니다.
POST /geofencing/v0/collections/CollectionName/forecast-geofence-events HTTP/1.1
Content-type: application/json
{
"DeviceState": {
"Position": [ number ],
"Speed": number
},
"DistanceUnit": "string",
"MaxResults": number,
"NextToken": "string",
"SpeedUnit": "string",
"TimeHorizonMinutes": number
}