positions

Creates, updates, deletes, gets or lists a positions resource.

Overview

Name	positions
Type	Resource
Id	aws.iotwireless.positions

Fields

The following fields are returned by SELECT queries:

get_position

Name	Datatype	Description
accuracy	object	The accuracy of the estimated position in meters. An empty value indicates that no position data is available. A value of ‘0.0’ value indicates that position data is available. This data corresponds to the position information that you specified instead of the position computed by solver.
position	array	The position information of the resource.
solver_provider	string	The vendor of the positioning solver. (Semtech)
solver_type	string	The type of solver used to identify the position of the resource. (GNSS)
solver_version	string	The version of the positioning solver.
timestamp	string	The timestamp at which the device's position was determined. (pattern: <code>^([+-]?\d{4}(?!\d{2}\b))((-?)((0[1-9]|1[0-2])(\3([12]\d|0[1-9]|3[01]))?|W([0-4]\d|5[0-2])(-?[1-7])?|(00[1-9]|0[1-9]\d|[12]\d{2}|3([0-5]\d|6[1-6])))([T\s]((([01]\d|2[0-3])((:?)[0-5]\d)?|24:?00)([.,]\d+(?!:))?)?(\17[0-5]\d([.,]\d+)?)?([zZ]|([+-])([01]\d|2[0-3]):?([0-5]\d)?)?)?)?$</code>)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_position	select	resource_identifier, resourceType, region		Get the position information for a given resource. This action is no longer supported. Calls to retrieve the position information should use the GetResourcePosition API operation instead.
update_position	update	resource_identifier, resourceType, region		Update the position information of a resource. This action is no longer supported. Calls to update the position information should use the UpdateResourcePosition API operation instead.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
region	string	AWS region (default: us-east-1)
resourceType	string	Resource type of the resource for which position is updated.
resource_identifier	string	Resource identifier of the resource for which position is updated.

SELECT examples

get_position

Get the position information for a given resource. This action is no longer supported. Calls to retrieve the position information should use the GetResourcePosition API operation instead.

SELECT
accuracy,
position,
solver_provider,
solver_type,
solver_version,
timestamp
FROM aws.iotwireless.positions
WHERE resource_identifier = '{{ resource_identifier }}' -- required
AND resourceType = '{{ resourceType }}' -- required
AND region = '{{ region }}' -- required
;

UPDATE examples

update_position

Update the position information of a resource. This action is no longer supported. Calls to update the position information should use the UpdateResourcePosition API operation instead.

UPDATE aws.iotwireless.positions
SET 
Position = '{{ Position }}'
WHERE 
resource_identifier = '{{ resource_identifier }}' --required
AND resourceType = '{{ resourceType }}' --required
AND region = '{{ region }}' --required;