Amazon Location의 지오펜스에 대한 디바이스 위치 평가

지오펜스를 기준으로 위치를 평가하여 지오펜스 이벤트를 생성하는 두 가지 방법이 있습니다.

• 트래커와 지오펜스 컬렉션을 연결할 수 있습니다. 자세한 내용은 자습서: Amazon Location의 지오펜스 컬렉션에 트래커 연결 섹션을 참조하세요.

• 를 사용하여 지오펜스 컬렉션 리소스에 직접 요청하여 하나 이상의 위치를 평가할 수 있습니다BatchEvaluateGeofencesAPI.

또한 지오펜스 내에서 디바이스가 입력, 종료 또는 유휴 상태로 유지되는 경우 들어오는 지오펜스 이벤트를 예측할 수 있습니다. 를 사용하여 이벤트를 예측ForecastGeofenceEventsAPI합니다.

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

지오펜스와 비교하여 디바이스 위치를 평가하면 이벤트가 생성됩니다. 이러한 이벤트에 반응하여 다른 AWS 서비스로 라우팅할 수 있습니다. 지오펜스 이벤트를 수신할 때 수행할 수 있는 작업에 대한 자세한 내용은 Amazon 를 사용하여 Amazon Location Service 이벤트에 대응을 EventBridge 참조하세요.

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

다음 예제에서는 AWS CLI또는 Amazon Location 을 사용합니다APIs.

API

Amazon Location을 사용하여 지오펜스의 위치와 비교하여 디바이스 위치를 평가하려면 APIs

Amazon Location Geofences 의 BatchEvaluateGeofences 작업을 사용합니다APIs.

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

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 명령을 사용합니다.

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

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"}}]'

지오펜스와 비교하여 디바이스 위치를 평가하면 이벤트가 생성됩니다. 전통적으로 를 사용하여 이벤트에 대응할 수 Amazon EventBridge있지만 이 프로세스를 통해 이후 발생한 이벤트에만 대응할 수 있습니다. 디바이스가 지오펜스에 들어오거나 나갈 때를 예상해야 하는 경우, 예를 들어 디바이스가 경계를 넘어 다른 규정이 적용될 경우 를 사용하여 향후 지오펜스 이벤트를 예측ForecastGeofenceEventsAPI할 수 있습니다.

는 디바이스의 time-to-breach, 근접성, 속도 및 위치와 같은 기준을 ForecastGeofenceEvents API 사용하여 이벤트를 예측합니다. API 가 반환되어 ForecastedBreachTime지오펜스 이벤트가 발생할 예상 시간을 알립니다.

다음 예제에서는 Amazon Location 을 사용합니다APIs.

API

Amazon Location을 사용하여 지오펜스 이벤트를 예측하려면 APIs

Amazon Location Geofences 의 ForecastGeofenceEvents 작업을 사용합니다APIs.

다음 예제에서는 API 요청을 사용하여 에 대한 지오펜스 이벤트를 예측합니다.ExampleDevice 를 기준으로 ExampleGeofence. 이러한 값을 자체 지오펜스 및 디바이스 로 바꿉니다IDs.

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
}