|
BenQ Mobile |
||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
The LocationListener represents a listener that receives
events associated with a particular
LocationProvider. Applications implement this interface and
register it with a LocationProvider to obtain regular
position updates.
When the listener is registered with a LocationProvider
with some update period, the implementation shall attempt to provide
updates at the defined interval. If it isn't possible to determine the
location, e.g. because of the LocationProvider being
TEMPORARILY_UNAVAILABLE or OUT_OF_SERVICE
or because the update period is too frequent for the location method to
provide updates, the implementation can send an update to the
listener that contains an 'invalid' Location instance.
The implementation shall use best effort to post the location updates at the specified interval, but this timing is not guaranteed to be very exact (i.e. this is not an exact timer facility for an application).
The application is responsible for any possible synchronization needed in the listener methods.
The listener methods MUST return quickly and should not perform any extensive processing. The method calls are intended as triggers to the application. Application should do any necessary extensive processing in a separate thread and only use these methods to initiate the processing.
LocationProvider,
Location| Method Summary | |
void |
locationUpdated(LocationProvider provider,
Location location)
Called by the LocationProvider to which this listener is
registered. |
void |
providerStateChanged(LocationProvider provider,
int newState)
Called by the LocationProvider to which this listener is
registered if the state of the LocationProvider
has changed.
|
| Method Detail |
public void locationUpdated(LocationProvider provider,
Location location)
LocationProvider to which this listener is
registered. This method will be called periodically according to
the interval defined when registering the listener to provide
updates of the current location.
provider - the source of the eventlocation - the location to which the event relates, i.e. the new
position
public void providerStateChanged(LocationProvider provider,
int newState)
LocationProvider to which this listener is
registered if the state of the LocationProvider
has changed.
These provider state changes are delivered to the application as soon as possible after the state of a provider changes. The timing of these events is not related to the period of the location updates.
If the application is subscribed to receive periodic location
updates, it will continue to receive these regardless of the
state of the LocationProvider. If the application
wishes to stop receiving location updates for an unavailable
provider, it should de-register itself from the provider.
provider - the source of the eventnewState - the new state of the LocationProvider.
This value is one of the constants for the
state defined in the LocationProvider
class.
|
BenQ Mobile |
||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
|
Copyright © 2006 BenQ Mobile GmbH & Co. OHG or respective copyright owner. All Rights Reserved. BenQ Corp. is a trademark licensee of Siemens AG. |
For further information about Mobility Toolkit (MTK) visit our Developer Portal. |