지오펜스를 기준으로 디바이스 위치 평가하기

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

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

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

또한 지오펜스에 들어오거나, 종료되거나, 지오펜스 내에서 유휴 상태로 남아 있는 장치에 대해 들어오는 지오펜스 이벤트를 예측할 수 있습니다. 를 사용하여 이벤트를 예측할 수 있습니다. ForecastGeofenceEventsAPI

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

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

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

다음 예에서는 AWS CLI, 또는 Amazon 위치를 사용합니다APIs.

API

Amazon Location을 사용하여 지오펜스의 위치를 기준으로 디바이스 위치를 평가하려면 APIs

Amazon 로케이션 APIs 지오펜스에서 BatchEvaluateGeofences 오퍼레이션을 사용하십시오.

다음 예시에서는 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 명령을 사용합니다.

다음 예제에서는 a를 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, 근접성, 속도, 위치 등의 기준을 ForecastGeofenceEventsAPI사용하여 이벤트를 예측합니다. 지오펜스 이벤트가 발생할 것으로 예상되는 시간을 알려주는 ForecastedBreachTime a가 API 반환됩니다.

다음 예시에서는 Amazon 로케이션을 사용합니다APIs.

API

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

Amazon 로케이션 APIs 지오펜스에서 ForecastGeofenceEvents 오퍼레이션을 사용하십시오.

다음 예시에서는 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
}