Package world.mappable.mapkit.location
Interface LocationManager
All known Subinterfaces:
DummyLocationManager, LocationSimulator
interface LocationManager
Handles location updates and changes.
Summary
Methods
|
Type and modifiers |
Method and Description |
|
void |
subscribeForLocationUpdates(double desiredAccuracy, |
|
void |
requestSingleUpdate(@NonNull LocationListener locationListener) |
|
void |
unsubscribe(@NonNull LocationListener locationListener) |
|
void |
suspend() |
|
void |
resume() |
Methods
subscribeForLocationUpdates
|
void subscribeForLocationUpdates(double desiredAccuracy, |
Subscribe for location update events.
If the listener was already subscribed to updates from the LocationManager, subscription settings will be updated. Use desiredAccuracy = 0 to obtain best possible accuracy, minTime = 0 to ignore minTime and use minDistance instead, minDistance = 0 to use only minTime. If both minTime and minDistance are set to zero, the subscription will use the same settings as other LocationManager clients.
The class does not retain the object in the 'locationListener' parameter. It is your responsibility to maintain a strong reference to the target object while it is attached to a class.
|
Parameters |
|
|
|
Desired location accuracy, in meters. This value is used to configure location services provided by the host OS. If locations with the desired accuracy are not available, updates may be called with lower accuracy. |
|
|
Minimal time interval between events, in milliseconds. |
|
|
Minimal distance between location updates, in meters. |
|
|
Defines whether the subscription can continue to fetch notifications when the application is inactive. If allowUseInBackground is true, set the |
|
|
Defines whether locations should be filtered. |
|
|
Defines whether locations will be used for navigation. |
|
|
Location update listener. |
requestSingleUpdate
|
void requestSingleUpdate(@NonNull LocationListener locationListener) |
Subscribe to a single location update.
If the listener was already subscribed to location updates, the previous subscription will be removed.
The class does not retain the object in the 'locationListener' parameter. It is your responsibility to maintain a strong reference to the target object while it is attached to a class.
|
Parameters |
|
|
|
Location update listener. |
unsubscribe
|
void unsubscribe(@NonNull LocationListener locationListener) |
Unsubscribe from location update events.
Can be called for either [mapkit.location.LocationManager#subscribeForLocationUpdates(double,
long, double, boolean, FilteringMode, Purpose, LocationListener)](./LocationManager.md#subscribeforlocationupdatesdouble-
long-double-boolean-filteringmode-purpose-locationlistener) or mapkit.location.LocationManager#requestSingleUpdate(LocationListener). For mapkit.location.LocationManager#requestSingleUpdate(LocationListener), if an event was already received, mapkit.location.LocationManager#unsubscribe(LocationListener) does not have any effect. If the listener is already unsubscribed, the method call is ignored.
The class does not retain the object in the 'locationListener' parameter. It is your responsibility to maintain a strong reference to the target object while it is attached to a class.
|
Parameters |
|
|
|
Listener passed to either [mapkit.location.LocationManager#subscribeForLocationUpdates(double, |
suspend
|
void suspend() |
Stops updates for all subscriptions until resume() is called.
resume
|
void resume() |
Resumes updates stopped by a suspend() call.