HarmonyOS鸿蒙Next中开发一款骑行记录 App，如何确保 GPS 在锁屏后仍能以 1Hz 频率持续采集位置？

开发者您好，需要您开启长时任务，具体步骤如下：

应用后台定位

当用户将应用切至后台且依然需要获取设备的位置信息时，可以使用该方式进行后台定位。

实现原理

应用后台定位需要申请后台定位权限ohos.permission.LOCATION_IN_BACKGROUND和长时任务权限ohos.permission.KEEP_BACKGROUND_RUNNING。申请了相关权限后，开启任务模式为定位导航的长时任务，并在其回调接口中通过on(‘locationChange’)订阅位置变化情况，在应用后台持续获取当前位置信息。

开发步骤

1. 申请后台定位权限，具体内容可参考申请位置权限开发指导。

2. 在模块的module.json5文件中，申请长时任务权限，并将长时任务模式设置为定位导航类型。 申请长时任务权限

   {
     "name": "ohos.permission.KEEP_BACKGROUND_RUNNING",
     "reason": "$string:running_background",
     "usedScene": {
       "abilities": [
         "EntryAbility"
       ],
       "when": "always"
     }
   },
   

   设置长时任务模式为定位导航类型

   "abilities": [
     {
       // ...
       "backgroundModes": [
         "location"
       ],
       // ...
     }
   ],
   

3. 详细参考开启任务模式为定位导航类型的长时任务，在其回调接口中开启位置变化订阅，并发起定位请求，在应用后台持续获取当前位置信息。

   开启长时任务

   startContinuousTask(): void {
     let context = this.getUIContext().getHostContext() as common.UIAbilityContext;
     if (!context) {
       return;
     }
     let wantAgentInfo: wantAgent.WantAgentInfo = {
       wants: [
         {
           bundleName: context.abilityInfo.bundleName,
           abilityName: context.abilityInfo.name
         }
       ],
       operationType: wantAgent.OperationType.START_ABILITY,
       requestCode: 1,
       wantAgentFlags: [wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
     };
   
     wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => {
       backgroundTaskManager.startBackgroundRunning(context,
         backgroundTaskManager.BackgroundMode.LOCATION, wantAgentObj).then(() => {
         this.onLocationChange();
         hilog.info(0x0000, TAG, 'startBackgroundRunning succeeded');
       }).catch((err: BusinessError) => {
         hilog.error(0x0000, TAG, `startBackgroundRunning failed, cause:  ${JSON.stringify(err)}`);
       });
     }).catch((err: BusinessError) => {
       hilog.error(0x0000, TAG, `getWantAgent failed, cause:  ${JSON.stringify(err)}`);
     });
   }
   

   订阅位置变化情况

   onLocationChange(): void {
     let request: geoLocationManager.ContinuousLocationRequest = {
       interval: 1,
       locationScenario: 0x401
     };
     try {
       geoLocationManager.on('locationChange', request, this.locationChange);
       // ...
     } catch (err) {
       hilog.error(0x0000, TAG, `onLocationChange failed, code: ${err.code}, message: ${err.message}`);
       // ...
     }
   }
   

4. 在位置变化的回调中，调用getAddressesFromLocation()接口进行逆地理编码转化，将坐标信息转换为对应的地理位置描述。

   geoLocationManager.getAddressesFromLocation(reverseGeocodeRequest, async (err, data) => {
     if (data) {
       this.address = data[0]?.placeName || '';
       // ...
     } else {
       hilog.error(0x0000, TAG, `getAddressesFromLocation failed, code: ${err.code}, message: ${err.message}`);
       // ...
     }
   });
   

5. 当不需要在应用后台获取位置信息时，及时关闭长时任务和位置变化订阅，并删除对应的定位请求，减少设备功耗。

   关闭长时任务

   stopContinuousTask(): void {
     let context = this.getUIContext().getHostContext() as common.UIAbilityContext;
     if (!context) {
       return;
     }
     backgroundTaskManager.stopBackgroundRunning(context).then(() => {
       if (!this.isOnLocationChange) {
         this.offLocationChange();
       }
       hilog.info(0x0000, TAG, 'stopBackgroundRunning succeeded');
     }).catch((err: BusinessError) => {
       hilog.error(0x0000, TAG, `stopBackgroundRunning failed, cause:  ${JSON.stringify(err)}`);
     });
   }
   

   关闭位置变化订阅

   offLocationChange(): void {
     try {
       geoLocationManager.off('locationChange', this.locationChange);
     } catch (err) {
       hilog.error(0x0000, TAG, `offLocationChange failed, code: ${err.code}, message: ${err.message}`);
     }
   }
   

详细demo请参考：基于位置服务获取设备定位信息