This document describes Positioning Module status, which applications access through the Location Acquisition API.
A Positioning Module has a status which is represented by a
A change in Positioning Module status is indicated by a status event. Details of the event are held in a
Figure 1 illustrates Positioning Module status and event classes.
TPositionModuleStatus
Device status
Device status is the status of the hardware device utilised by a Positioning Module, such as the chipset used by an A-GPS Positioning Module.
Data quality status
Data quality status describes the accuracy of the location data that a Positioning Module is able to provide at a point in time.
When a Positioning Module's status changes, a Positioning Module status event occurs.
There are three types of Positioning Module status events:
Device status events
Data quality status events
System level events. These events indicate that a Positioning Module has been added or removed in the system.
TPositionModuleStatusEvent
An object of class
As the object on which an application defines the types of Positioning Module status events for which it requests notification. These are set by calling
As the object on which the location framework sets the type of events that have occurred. These are retrieved by calling
Event notification
An application calls
When the status of a Positioning Module changes, the client application is notified. The
The Positioning Module status is obtained by calling
See
Quality status events are useful for applications that need to modify their behaviour based on the quality of location information that can be received. For example, an application may need to show a message when a user moves into an area where the accuracy of location information is degraded to a lower quality than is required because of distance from a base station or inability to receive satellite signals.
Device status events and system Positioning Module events are most useful to software components that perform administrative operations, such as taking a Positioning Module online or offline. The events can be used to notify when such an administrative operation is complete.
Device status events can also be used to keep a user informed as to the status of a particular Positioning Module. For example, a phone status bar could be updated to show that GPS is active when location information is being received.
This document describes Positioning Module status, which applications access through the Location Acquisition API.
A Positioning Module has a status which is represented by a
A change in Positioning Module status is indicated by a status event. Details of the event are held in a
Figure 1 illustrates Positioning Module status and event classes.
TPositionModuleStatus
Device status
Device status is the status of the hardware device utilised by a Positioning Module, such as the chipset used by an A-GPS Positioning Module.
Data quality status
Data quality status describes the accuracy of the location data that a Positioning Module is able to provide at a point in time.
When a Positioning Module's status changes, a Positioning Module status event occurs.
There are three types of Positioning Module status events:
Device status events
Data quality status events
System level events. These events indicate that a Positioning Module has been added or removed in the system.
TPositionModuleStatusEvent
An object of class
As the object on which an application defines the types of Positioning Module status events for which it requests notification. These are set by calling
As the object on which the location framework sets the type of events that have occurred. These are retrieved by calling
Event notification
An application calls
When the status of a Positioning Module changes, the client application is notified. The
The Positioning Module status is obtained by calling
See
Quality status events are useful for applications that need to modify their behaviour based on the quality of location information that can be received. For example, an application may need to show a message when a user moves into an area where the accuracy of location information is degraded to a lower quality than is required because of distance from a base station or inability to receive satellite signals.
Device status events and system Positioning Module events are most useful to software components that perform administrative operations, such as taking a Positioning Module online or offline. The events can be used to notify when such an administrative operation is complete.
Device status events can also be used to keep a user informed as to the status of a particular Positioning Module. For example, a phone status bar could be updated to show that GPS is active when location information is being received.