Copyright | (c) 2013-2023 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | Safe-Inferred |
Language | Haskell2010 |
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).
When PositionFiltering
is set to AccuracyBased
filtering, location
data is stored and evaluated against linked geofence collections only if
the device has moved more than the measured accuracy. For example, if
two consecutive updates from a device have a horizontal accuracy of 5 m
and 10 m, the second update is neither stored or evaluated if the device
has moved less than 15 m. If PositionFiltering
is set to
AccuracyBased
filtering, Amazon Location uses the default value
{ "Horizontal": 0}
when accuracy is not provided on a
DevicePositionUpdate
.
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.
BatchUpdateDevicePosition' | |
|
Instances
newBatchUpdateDevicePosition Source #
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:
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.
BatchUpdateDevicePositionResponse' | |
|
Instances
Generic BatchUpdateDevicePositionResponse Source # | |
Read BatchUpdateDevicePositionResponse Source # | |
Show BatchUpdateDevicePositionResponse Source # | |
NFData BatchUpdateDevicePositionResponse Source # | |
Defined in Amazonka.Location.BatchUpdateDevicePosition rnf :: BatchUpdateDevicePositionResponse -> () # | |
Eq BatchUpdateDevicePositionResponse Source # | |
type Rep BatchUpdateDevicePositionResponse Source # | |
Defined in Amazonka.Location.BatchUpdateDevicePosition type Rep BatchUpdateDevicePositionResponse = D1 ('MetaData "BatchUpdateDevicePositionResponse" "Amazonka.Location.BatchUpdateDevicePosition" "amazonka-location-2.0-4NLaYgEbMXwF6j2j7LAFNb" 'False) (C1 ('MetaCons "BatchUpdateDevicePositionResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int) :*: S1 ('MetaSel ('Just "errors") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 [BatchUpdateDevicePositionError]))) |
newBatchUpdateDevicePositionResponse Source #
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.