@coreo/ionic-background-tracking
Ionic 2+ module for tracking a users location.
Installation
cordova plugin add https://github.com/transistorsoft/cordova-background-geolocation.git#2.11.0 --save
yarn add @coreo/ionic-background-tracking
Usage
Import the module in your app.module.ts
;
import { CoreoBackgroundTrackingModule } from '@coreo/ionic-background-tracking';
...
@NgModule({
imports: [
...
CoreoBackgroundTrackingModule
...
]
})
export class AppModule {}
CoreoBackgroundTracking
service
Inject the service into your component;
import { CoreoBackgroundTracking } from '@coreo/ionic-background-tracking';
@Component()
export class MyComponent() {
constructor(private geoService: CoreoBackgroundTracking) {}
}
Methods
startTracking()
- Enables location tracking. Returns an observable which emits the position of the device. Emitted position objects conform to the CoreoBackgroundTrackingPosition
interface.stopTracking()
- Disables location tracking.getCurrentLocation
- Retrieves the current position of the device using maximum power and accuracy. Returns a promise which is resolved with an object conforming to the CoreoBackgroundTrackingPosition
interface.setConfig(config)
- Sets the config to be used by the cordova-background-geolocation
plugin. See [the cordova-background-geolocation-lt
]
(https://github.com/transistorsoft/cordova-background-geolocation-lt/blob/master/docs/README.md#wrench-configuration-options-1) for a list of config options that can be set.setAccuracyFilter(accuracyFilter)
- Sets the accuracy filter in meters. Positions retrieved from the cordova-background-geolocation
plugin are only accepted if they have an accuracy equal to or less than the accuracy filter.
Properties
isTracking: boolean
- Flag indicating whether location tracking is currently enabled.