|
|||||||||
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.
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)
provider
- the source of the eventlocation
- the location to which the event relates, i.e. the new position
providerStateChangedvoid providerStateChanged(LocationProvider provider, int newState)
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 |