Background Geolocation

此插件提供在前臺(tái)和后臺(tái)以省電“圓形區(qū)域監(jiān)視”和“停止檢測(cè)”獲取地理位置拗秘。 有關(guān)詳細(xì)信息栗恩，請(qǐng)參閱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（支持平臺(tái)）

Android
iOS

Usage（用法）

必須在app.ts內(nèi)或Geolocation之前調(diào)用BackgroundGeolocation。 否則，平臺(tái)不會(huì)要求您提供后臺(tái)跟蹤權(quán)限。

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（實(shí)例成員）

LocationProvider

設(shè)置提供地理位置服務(wù) @參照 https://github.com/mauron85/cordova-plugin-background-geolocation/wiki/Android-providers
可能的值: ANDROID_DISTANCE_FILTER_PROVIDER: 0, ANDROID_ACTIVITY_PROVIDER: 1

Accuracy

所需精度以米計(jì)锌仅。 可能的值[0，10墙贱，100热芹，1000]。 數(shù)字越小惨撇，GeoLocation的功率越多伊脓，導(dǎo)致讀數(shù)越高。 1000導(dǎo)致最低的功耗和最不精確的讀數(shù)魁衙。
可能的值：HIGH：0 MEDIUM：10 LOW：100 PASSIVE：1000

enum {number}

Mode

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

configure(options)

配置這個(gè)插件.

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

start()

打開(kāi)后臺(tái)地理位置系統(tǒng)报腔。 每當(dāng)掛起應(yīng)用程序時(shí)，用戶將被跟蹤剖淀。
****Returns:** Promise<any>

stop()

停止后臺(tái)地理位置系統(tǒng)
****Returns:** Promise<any>

finish()

Platforms:****IOS WINDOWS PHONE
通知原生插件已完成纯蛾，后臺(tái)任務(wù)可能已完成
****Returns:** Promise<any>

changePace(isMoving)

Platforms:****IOS WINDOWS PHONE
強(qiáng)制插件進(jìn)入“移動(dòng)”或“靜止”狀態(tài)

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

setConfig(options)

設(shè)置配置

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

getStationaryLocation()

Platforms:****IOS WINDOWS PHONE
返回當(dāng)前的fixedLocation（如果可用）纵隔。 如果沒(méi)有則為null
****Returns:** Promise<Location>

onStationary()

Platforms:****IOS WINDOWS PHONE
添加一個(gè)靜止區(qū)域監(jiān)聽(tīng)器翻诉。 每當(dāng)設(shè)備進(jìn)入“固定模式”時(shí)，#success回調(diào)將執(zhí)行#location param捌刮，其中包含#radius的區(qū)域
****Returns:** Promise<any>

isLocationEnabled()

Platforms:****ANDROID
檢查設(shè)備上是否啟用了位置
****Returns:** Promise<number>
返回一個(gè)使用int參數(shù)的promise碰煌，取值為0，1（true）绅作。

showAppSettings()

顯示應(yīng)用設(shè)置來(lái)更改權(quán)限

showLocationSettings()

顯示設(shè)備位置設(shè)置

watchLocationMode()

Platforms:****ANDROID
方法可用于檢測(cè)用戶位置服務(wù)設(shè)置的變化芦圾。 如果用戶啟用或禁用位置服務(wù)，則將執(zhí)行成功回調(diào)俄认。 如果發(fā)生錯(cuò)誤（SettingNotFoundException）个少，則將執(zhí)行回調(diào)碍脏。
****Returns:** Promise<boolean>

stopWatchingLocationMode()

Platforms:****ANDROID
停止監(jiān)測(cè)位置模式更改。
****Returns:** Promise<any>

getLocations()

Platforms:****ANDROID
方法將返回所有存儲(chǔ)的位置稍算。 當(dāng)?shù)攸c(diǎn)存儲(chǔ)時(shí)：

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

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

getValidLocations()

方法將返回尚未發(fā)布到服務(wù)器的位置。 注意：位置確實(shí)包含locationId役拴。
****Returns:** Promise<any>

deleteLocation(locationId)

Platforms:****ANDROID
通過(guò)給定的locationId刪除存儲(chǔ)的位置糊探。

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

deleteAllLocations()

Platforms:****ANDROID
刪除所有存儲(chǔ)的位置。
****Returns:** Promise<any>

switchMode(modeId)

Platforms:****IOS
通常插件將處理BACKGROUND和FOREGROUND模式之間的切換河闰。 調(diào)用switchMode可以覆蓋插件行為科平，并強(qiáng)制插件切換到其他模式。
在FOREGROUND模式下姜性，插件使用iOS本地管理器接收位置和行為受option.desiredAccuracy和option.distanceFilter的影響瞪慧。
在BACKGROUND 模式中，插件使用重大更改和區(qū)域監(jiān)視來(lái)接收位置部念，并使用option.stationaryRadius弃酌。
BackgroundGeolocation.Mode.FOREGROUND BackgroundGeolocation.Mode.BACKGROUND *

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

getLogEntries()

返回所有記錄的事件。 適用于插件調(diào)試儡炼。 參數(shù)限制返回條目數(shù)妓湘。 @更多信息參見(jiàn)https://github.com/mauron85/cordova-plugin-background-geolocation/tree/v2.2.1#debugging
@param limit {number} 限制條目數(shù)量
****Returns:** Promise<any>

BackgroundGeolocationResponse

BackgroundGeolocationConfig