| Copyright | (c) 2013-2021 Brendan Hay |
|---|---|
| License | Mozilla Public License, v. 2.0. |
| Maintainer | Brendan Hay <brendan.g.hay+amazonka@gmail.com> |
| Stability | auto-generated |
| Portability | non-portable (GHC extensions) |
| Safe Haskell | None |
Amazonka.Location.BatchUpdateDevicePosition
Description
Uploads position update data for one or more devices to a tracker resource. Amazon Location uses the data when it reports the last known device position and position history. Amazon Location retains location data for 30 days.
Position updates are handled based on the PositionFiltering property
of the tracker. When PositionFiltering is set to TimeBased, updates
are evaluated against linked geofence collections, and location data is
stored at a maximum of one position per 30 second interval. If your
update frequency is more often than every 30 seconds, only one update
per 30 seconds is stored for each unique device ID. When
PositionFiltering is set to DistanceBased filtering, location data
is stored and evaluated against linked geofence collections only if the
device has moved more than 30 m (98.4 ft).
Synopsis
- data BatchUpdateDevicePosition = BatchUpdateDevicePosition' {}
- newBatchUpdateDevicePosition :: Text -> NonEmpty DevicePositionUpdate -> BatchUpdateDevicePosition
- batchUpdateDevicePosition_trackerName :: Lens' BatchUpdateDevicePosition Text
- batchUpdateDevicePosition_updates :: Lens' BatchUpdateDevicePosition (NonEmpty DevicePositionUpdate)
- data BatchUpdateDevicePositionResponse = BatchUpdateDevicePositionResponse' {}
- newBatchUpdateDevicePositionResponse :: Int -> BatchUpdateDevicePositionResponse
- batchUpdateDevicePositionResponse_httpStatus :: Lens' BatchUpdateDevicePositionResponse Int
- batchUpdateDevicePositionResponse_errors :: Lens' BatchUpdateDevicePositionResponse [BatchUpdateDevicePositionError]
Creating a Request
data BatchUpdateDevicePosition Source #
See: newBatchUpdateDevicePosition smart constructor.
Constructors
| BatchUpdateDevicePosition' | |
Fields
| |
Instances
newBatchUpdateDevicePosition Source #
Arguments
| :: Text | |
| -> NonEmpty DevicePositionUpdate | |
| -> BatchUpdateDevicePosition |
Create a value of BatchUpdateDevicePosition with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:trackerName:BatchUpdateDevicePosition', batchUpdateDevicePosition_trackerName - The name of the tracker resource to update.
$sel:updates:BatchUpdateDevicePosition', batchUpdateDevicePosition_updates - Contains the position update details for each device.
Request Lenses
batchUpdateDevicePosition_trackerName :: Lens' BatchUpdateDevicePosition Text Source #
The name of the tracker resource to update.
batchUpdateDevicePosition_updates :: Lens' BatchUpdateDevicePosition (NonEmpty DevicePositionUpdate) Source #
Contains the position update details for each device.
Destructuring the Response
data BatchUpdateDevicePositionResponse Source #
See: newBatchUpdateDevicePositionResponse smart constructor.
Constructors
| BatchUpdateDevicePositionResponse' | |
Fields
| |
Instances
newBatchUpdateDevicePositionResponse Source #
Arguments
| :: Int | |
| -> BatchUpdateDevicePositionResponse |
Create a value of BatchUpdateDevicePositionResponse with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:httpStatus:BatchUpdateDevicePositionResponse', batchUpdateDevicePositionResponse_httpStatus - The response's http status code.
$sel:errors:BatchUpdateDevicePositionResponse', batchUpdateDevicePositionResponse_errors - Contains error details for each device that failed to update its
position.
Response Lenses
batchUpdateDevicePositionResponse_httpStatus :: Lens' BatchUpdateDevicePositionResponse Int Source #
The response's http status code.
batchUpdateDevicePositionResponse_errors :: Lens' BatchUpdateDevicePositionResponse [BatchUpdateDevicePositionError] Source #
Contains error details for each device that failed to update its position.