The positioning module provides basic access to the S60 position information 4.8. The module can be e.g. used to access position information provided by external Bluetooth GPS-devices and by built-in GPS-receivers4.9 from S60 devices.
The module offers a large amount of information (cost of service, device power consumption etc.) about accessible positioning devices (like GPS-modules), position, course, accuracy and satellite information (depending on the position device used) and much more. This module can also be used to obtain device/vendor specific extended information.
The following data items are available in positioning:
positionfunction callback invocation. The default value set is 1000000 microseconds (= 1 second)
The positioning module has the following functions (for examples of the values returned, see Section 4.6.1):
|course=0,satellites=0,callback=None, interval=positioning.POSITION_INTERVAL, partial=0)|
By default, returns the position information in a dictionary. With course and/or satellites set to 1, information about course and satellites is also returned (if available).
With no callback provided, this call blocks until the position information is available.
The call returns immediately if a valid callback function is given. This callback function is then invoked with the specified time interval (in microseconds) in between the invocations. The callback function is called with the the current position information as parameter.
If partial update is set to 1, the function might return e.g. information about satellites before the final location fix has been calculated.
For an example of the dictionary returned and the detailed keys, see Section 4.6.1.