Background Geolocation

此插件提供在前台和后台以省电“圆形区域监视”和“停止检测”获取地理位置。 有关详细信息，请参阅https://github.com/mauron85/cordova-plugin-background-geolocation
Repo（备用）: https://github.com/mauron85/cordova-plugin-background-geolocation

Installation（安装）

1.安装Cordova和Ionic插件:

$ ionic cordova plugin add cordova-plugin-mauron85-background-geolocation
$ npm install --save @ionic-native/background-geolocation

2.添加插件到app's module

Supported platforms（支持平台）

Android
iOS

Usage（用法）

必须在app.ts内或Geolocation之前调用BackgroundGeolocation。 否则，平台不会要求您提供后台跟踪权限。

import { BackgroundGeolocation, BackgroundGeolocationConfig } from '@ionic-native/background-geolocation';

constructor(private backgroundGeolocation: BackgroundGeolocation) { }

...

const config: BackgroundGeolocationConfig = {
            desiredAccuracy: 10,
            stationaryRadius: 20,
            distanceFilter: 30,
            debug: true, //  enable this hear sounds for background-geolocation life-cycle.
            stopOnTerminate: false, // enable this to clear background location settings when the app terminates
    };

this.backgroundGeolocation.configure(config)
  .subscribe((location: BackgroundGeolocationResponse) => {

    console.log(location);

    // IMPORTANT:  You must execute the finish method here to inform the native plugin that you're finished,
    // and the background-task may be completed.  You must do this regardless if your HTTP request is successful or not.
    // IF YOU DON'T, ios will CRASH YOUR APP for spending too much time in the background.
    this.backgroundGeolocation.finish(); // FOR IOS ONLY

  });

// start recording location
this.backgroundGeolocation.start();

// If you wish to turn OFF background-tracking, call the #stop method.
this.backgroundGeolocation.stop();

Instance Members（实例成员）

LocationProvider

设置提供地理位置服务 @参照 https://github.com/mauron85/cordova-plugin-background-geolocation/wiki/Android-providers
可能的值: ANDROID_DISTANCE_FILTER_PROVIDER: 0, ANDROID_ACTIVITY_PROVIDER: 1

Accuracy

所需精度以米计。 可能的值[0，10，100，1000]。 数字越小，GeoLocation的功率越多，导致读数越高。 1000导致最低的功耗和最不精确的读数。
可能的值：HIGH：0 MEDIUM：10 LOW：100 PASSIVE：1000

enum {number}

Mode

用于switchMode功能
可能的值: BACKGROUND: 0 FOREGROUND: 1

configure(options)

配置这个插件.

****Returns:** Observable<BackgroundGeolocationResponse>

start()

打开后台地理位置系统。 每当挂起应用程序时，用户将被跟踪。
****Returns:** Promise<any>

stop()

停止后台地理位置系统
****Returns:** Promise<any>

finish()

Platforms:****IOS WINDOWS PHONE
通知原生插件已完成，后台任务可能已完成
****Returns:** Promise<any>

changePace(isMoving)

Platforms:****IOS WINDOWS PHONE
强制插件进入“移动”或“静止”状态

****Returns:** Promise<any>

setConfig(options)

设置配置

****Returns:** Promise<any>

getStationaryLocation()

Platforms:****IOS WINDOWS PHONE
返回当前的fixedLocation（如果可用）。 如果没有则为null
****Returns:** Promise<Location>

onStationary()

Platforms:****IOS WINDOWS PHONE
添加一个静止区域监听器。 每当设备进入“固定模式”时，#success回调将执行#location param，其中包含#radius的区域
****Returns:** Promise<any>

isLocationEnabled()

Platforms:****ANDROID
检查设备上是否启用了位置
****Returns:** Promise<number>
返回一个使用int参数的promise，取值为0，1（true）。

showAppSettings()

显示应用设置来更改权限

showLocationSettings()

显示设备位置设置

watchLocationMode()

Platforms:****ANDROID
方法可用于检测用户位置服务设置的变化。 如果用户启用或禁用位置服务，则将执行成功回调。 如果发生错误（SettingNotFoundException），则将执行回调。
****Returns:** Promise<boolean>

stopWatchingLocationMode()

Platforms:****ANDROID
停止监测位置模式更改。
****Returns:** Promise<any>

getLocations()

Platforms:****ANDROID
方法将返回所有存储的位置。 当地点存储时：

config.stopOnTerminate is false and main activity was killed by the system or
option.debug is true

****Returns:** Promise<any>

getValidLocations()

方法将返回尚未发布到服务器的位置。 注意：位置确实包含locationId。
****Returns:** Promise<any>

deleteLocation(locationId)

Platforms:****ANDROID
通过给定的locationId删除存储的位置。

****Returns:** Promise<any>

deleteAllLocations()

Platforms:****ANDROID
删除所有存储的位置。
****Returns:** Promise<any>

switchMode(modeId)

Platforms:****IOS
通常插件将处理BACKGROUND和FOREGROUND模式之间的切换。 调用switchMode可以覆盖插件行为，并强制插件切换到其他模式。
在FOREGROUND模式下，插件使用iOS本地管理器接收位置和行为受option.desiredAccuracy和option.distanceFilter的影响。
在BACKGROUND 模式中，插件使用重大更改和区域监视来接收位置，并使用option.stationaryRadius。
BackgroundGeolocation.Mode.FOREGROUND BackgroundGeolocation.Mode.BACKGROUND *

****Returns:** Promise<any>

getLogEntries()

返回所有记录的事件。 适用于插件调试。 参数限制返回条目数。 @更多信息参见https://github.com/mauron85/cordova-plugin-background-geolocation/tree/v2.2.1#debugging
@param limit {number} 限制条目数量
****Returns:** Promise<any>

BackgroundGeolocationResponse

BackgroundGeolocationConfig