|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface LocationListener
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 |
---|
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.
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.
provider
- - the source of the event.location
- - the location to which the event relates, i.e. the new
position.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.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |