get_device_position

LocationService.Client.get_device_position(**kwargs)

Retrieves a device's most recent position according to its sample time.

Note

Device positions are deleted after 30 days.

See also: AWS API Documentation

Request Syntax

response = client.get_device_position(
    DeviceId='string',
    TrackerName='string'
)

Parameters

• DeviceId (string) --

  [REQUIRED]

  The device whose position you want to retrieve.

• TrackerName (string) --

  [REQUIRED]

  The tracker resource receiving the position update.

Return type

dict

Returns

Response Syntax

{
    'Accuracy': {
        'Horizontal': 123.0
    },
    'DeviceId': 'string',
    'Position': [
        123.0,
    ],
    'PositionProperties': {
        'string': 'string'
    },
    'ReceivedTime': datetime(2015, 1, 1),
    'SampleTime': datetime(2015, 1, 1)
}

Response Structure

• (dict) --

  • Accuracy (dict) --

    The accuracy of the device position.

    • Horizontal (float) --

      Estimated maximum distance, in meters, between the measured position and the true position of a device, along the Earth's surface.

  • DeviceId (string) --

    The device whose position you retrieved.

  • Position (list) --

    The last known device position.

    • (float) --

  • PositionProperties (dict) --

    The properties associated with the position.

    • (string) --
      • (string) --

  • ReceivedTime (datetime) --

    The timestamp for when the tracker resource received the device position in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ .

  • SampleTime (datetime) --

    The timestamp at which the device's position was determined. Uses ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ .

Exceptions

• LocationService.Client.exceptions.InternalServerException
• LocationService.Client.exceptions.ResourceNotFoundException
• LocationService.Client.exceptions.AccessDeniedException
• LocationService.Client.exceptions.ValidationException
• LocationService.Client.exceptions.ThrottlingException