:doc:`IoTWireless <../../iotwireless>` / Client / get_position

************
get_position
************



.. py:method:: IoTWireless.Client.get_position(**kwargs)

  

  Get the position information for a given resource.

   

  .. warning::

     

    This action is no longer supported. Calls to retrieve the position information should use the `GetResourcePosition <https://docs.aws.amazon.com/iot-wireless/latest/apireference/API_GetResourcePosition.html>`__ API operation instead.

    

  

  .. danger::

        This operation is deprecated and may not function as expected. This operation should not be used going forward and is only kept for the purpose of backwards compatiblity.


  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/iotwireless-2020-11-22/GetPosition>`_  


  **Request Syntax**
  ::

    response = client.get_position(
        ResourceIdentifier='string',
        ResourceType='WirelessDevice'|'WirelessGateway'
    )
    
  :type ResourceIdentifier: string
  :param ResourceIdentifier: **[REQUIRED]** 

    Resource identifier used to retrieve the position information.

    

  
  :type ResourceType: string
  :param ResourceType: **[REQUIRED]** 

    Resource type of the resource for which position information is retrieved.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'Position': [
              ...,
          ],
          'Accuracy': {
              'HorizontalAccuracy': ...,
              'VerticalAccuracy': ...
          },
          'SolverType': 'GNSS',
          'SolverProvider': 'Semtech',
          'SolverVersion': 'string',
          'Timestamp': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **Position** *(list) --* 

        The position information of the resource.

        
        

        - *(float) --* 
    
      

      - **Accuracy** *(dict) --* 

        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.

        
        

        - **HorizontalAccuracy** *(float) --* 

          The horizontal accuracy of the estimated position, which is the difference between the estimated location and the actual device location.

          
        

        - **VerticalAccuracy** *(float) --* 

          The vertical accuracy of the estimated position, which is the difference between the estimated altitude and actual device latitude in meters.

          
    
      

      - **SolverType** *(string) --* 

        The type of solver used to identify the position of the resource.

        
      

      - **SolverProvider** *(string) --* 

        The vendor of the positioning solver.

        
      

      - **SolverVersion** *(string) --* 

        The version of the positioning solver.

        
      

      - **Timestamp** *(string) --* 

        The timestamp at which the device's position was determined.

        
  
  **Exceptions**
  
  *   :py:class:`IoTWireless.Client.exceptions.ValidationException`

  
  *   :py:class:`IoTWireless.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`IoTWireless.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`IoTWireless.Client.exceptions.ThrottlingException`

  
  *   :py:class:`IoTWireless.Client.exceptions.InternalServerException`

  