public interface ProximityListener
This listener is called when the terminal enters the proximity of the registered coordinates. The proximity is defined as the proximity radius around the coordinates combined with the horizontal accuracy of the current sampled location.
The listener is called only once when the terminal enters the proximity of the registered coordinates. The registration with these coordinates is cancelled when the listener is called. If the application wants to be notified again about these coordinates, it must re-register the coordinates and the listener.
Modifier and Type | Method and Description |
---|---|
void |
monitoringStateChanged(boolean isMonitoringActive)
Called to notify that the state of the proximity monitoring has changed.
|
void |
proximityEvent(Coordinates coordinates,
Location location)
After registering this listener with the LocationProvider, this method will be
called by the platform when the implementation detects that the current location of
the terminal is within the defined proximity radius of the registered coordinates.
|
void monitoringStateChanged(boolean isMonitoringActive)
Regardless of the state, the ProximityListener remains registered until the application explicitly removes it with LocationProvider.removeProximityListener or the application exits.
These state changes may be related to state changes of some location providers, but this is implementation dependent as implementations can freely choose the method used to implement this proximity monitoring.
isMonitoringActive
- a boolean indicating the new state of the proximity monitoring. true
indicates that the proximity monitoring is active and false indicates
that the proximity monitoring can't be done currently.void proximityEvent(Coordinates coordinates, Location location)
coordinates
- the registered coordinates to which proximity has been detectedlocation
- the current location of the terminal monitoringStateChanged