位置定位/定位/实时定位

https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-positioning#section189692202585

git:

https://gitee.com/harmonyos_samples/location-service.git

https://gitee.com/openharmony/applications_app_samples.git

定位两种方式：GNSS定位和网络定位

• 当前位置定位：获取设备的当前位置信息。开发者可以根据实际需求将其应用于多种业务场景，如外卖定位、打车定位等。
• 实时位置定位：持续获取设备的实时位置信息。开发者可以将此能力应用于需要实时定位的场景，如步行导航，驾车出行等。
• 应用后台定位：将应用切换到后台仍然可以持续获取位置信息。该能力可以用于实现后台应用实时记录运动轨迹等业务场景。
• 历史定位获取：获取系统缓存的最新位置，即最近一次的历史定位信息。该能力可以用于在设备网络信号较弱或对系统功耗比较敏感的场景下获取位置信息。

当前位置定位

1. 申请定位权限，具体内容可参考申请位置权限开发指导。
2. 实例化位置信息请求对象，确认当前定位策略。以实例化SingleLocationRequest对象为例，将其定位方式优先级设置为快速获取位置优先，定位超时时间设置为10秒，具体代码如下：
3. 根据定位策略，调用getCurrentLocation()接口获取当前位置信息。
4. 调用getAddressesFromLocation() 接口进行逆地理编码转化，将位置坐标信息转换为对应的地理位置描述。

实时位置定位

1. 申请定位权限，具体内容可参考申请位置权限开发指导。
2. 实例化位置信息请求对象，确认持续定位策略。以实例化ContinuousLocationRequest为例，将定位场景类型设置为导航场景，位置信息上报时间间隔设置为1秒，具体代码如下：
3. 根据定位策略，调用on(‘locationChange’)开启位置变化订阅，并发起定位请求，持续获取当前位置信息。
4. 在on(‘locationChange’)的回调函数中，调用getAddressesFromLocation()接口进行逆地理编码转化，将坐标信息转换为对应的地理位置描述。
5. 在不需要获取位置信息时，及时关闭位置变化订阅，并删除对应的定位请求，减少设备功耗。

应用后台定位

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

权限配置

  "requestPermissions": [
    {
        "name": "ohos.permission.LOCATION", //用于获取精准位置，精准度在米级别。
        "reason": "$string:permission_reason",
        "usedScene": {"when": "always"}
    },
    {
        "name": "ohos.permission.APPROXIMATELY_LOCATION", //用于获取模糊位置，精确度为5公里。
        "reason": "$string:permission_reason",
        "usedScene": {"when": "always"}
    },
    {
        "name": "ohos.permission.LOCATION_IN_BACKGROUND",//用于应用切换到后台仍然需要获取定位信息的场景。
        "reason": "$string:permission_reason",
        "usedScene": {"when": "always"}
    },
    {
        "name": "ohos.permission.KEEP_BACKGROUND_RUNNING",
        "reason": "$string:permission_reason",
        "usedScene": {
            "abilities": [
                "EntryAbility"
            ],
            "when": "always"
        }
    }
  ],

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

Index.ets

import { geoLocationManager } from '@kit.LocationKit';
import { BusinessError } from '@kit.BasicServicesKit';
import hilog from '@ohos.hilog';
import { abilityAccessCtrl, common, wantAgent } from '@kit.AbilityKit';
import { backgroundTaskManager } from '@kit.BackgroundTasksKit';

const TAG = '位置';

@Entry
@Component
struct Index {
  //当前位置
  @State
  curAddress: string = '';
  //实时位置
  @State
  address: string = '';
  //上一次缓存位置
  @State
  cacheAddress: string = '';
  @State
  isOnLocationChange: boolean = false;
  @State
  backIsOn: boolean = false;

  aboutToAppear() {
    abilityAccessCtrl.createAtManager().requestPermissionsFromUser(this.getUIContext().getHostContext(),
      [
        'ohos.permission.LOCATION',
        'ohos.permission.APPROXIMATELY_LOCATION',
      ])
  }

  build() {
    Column() {
      Text("获取当前位置:" + this.curAddress)
        .onClick(() => {
          //实例化位置信息请求对象，确认当前定位策略。以实例化SingleLocationRequest对象为例，将其定位方式优先级设置为快速获取位置优先，定位超时时间设置为10秒
          let request: geoLocationManager.SingleLocationRequest = { locatingPriority: 0x502, locatingTimeoutMs: 10000 };
          geoLocationManager.getCurrentLocation(request).then((location: geoLocationManager.Location) => {
            geoLocationManager.getAddressesFromLocation({
              latitude: location.latitude,
              longitude: location.longitude
            }, async (err, data) => {
              if (data) {

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

              }
            });
          }).catch((err: BusinessError) => {
            hilog.error(0x0000, TAG, `getCurrentLocationPosition failed, code: ${err.code}, message: ${err.message}`);
            // ...
          });

        })

      Text("获取缓存位置:" + this.cacheAddress)
        .onClick(()=>{
          let location = geoLocationManager.getLastLocation();
          geoLocationManager.getAddressesFromLocation({
            latitude: location.latitude,
            longitude: location.longitude
          }, async (err, data) => {
            if (data) {
              this.cacheAddress = data[0]?.placeName || '';
              // ...
            } else {
              hilog.error(0x0000, TAG, `getAddressesFromLocation failed, code: ${err.code}, message: ${err.message}`);
              // ...
            }
          });
        })


      Toggle({
        type: ToggleType.Button, //按钮 开关
        isOn: this.isOnLocationChange
      }) {
        Text('实时定位' + this.address)
      }.width(100)
      .onChange((isOn: boolean) => {
        this.isOnLocationChange = isOn;
        if (this.isOnLocationChange) {
          this.onLocationChange();
        } else {
          if(!this.backIsOn){
            this.offLocationChange();
          }
        }
      })

      Toggle({
        type: ToggleType.Button, //按钮 开关
        isOn: this.backIsOn
      }) {
        Text('应用后台定位' + this.address)
      }.width(100)
      .onChange((isOn: boolean) => {
        this.backIsOn = isOn;
        if (this.backIsOn) {
          this.startContinuousTask()
        }else {
          this.stopContinuousTask()
        }
      })

    }
    .height('100%')
    .width('100%')
  }

  //关闭长时任务
  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)}`);
    });
  }

  //开启长时任务
  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)}`);
      });
    });
  }

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

  onLocationChange() {
    let request: geoLocationManager.ContinuousLocationRequest = {
      interval: 0, //上报时间间隔默认1    不动动时候20秒一次 表示上报位置信息的时间间隔，单位是秒。默认值为1，取值范围为大于等于0。等于0时对位置上报时间间隔无限制。
      locationScenario: 0x401
    };
    geoLocationManager.on('locationChange', request, this.locationChange);
  }

  //必须抽成方法 这样on('locationChange'）可以注册多次只会执行一次,且
  locationChange = (location: geoLocationManager.Location): void =>  {
    console.log('locationChange: ' + JSON.stringify(location));
    geoLocationManager.getAddressesFromLocation({
      latitude: location.latitude,
      longitude: location.longitude
    }, async (err, data) => {
      if (data) {
        console.log('locationChange: ' );
        this.address = (data[0]?.placeName || '') ;
        // ...
      } else {
        hilog.error(0x0000, TAG, `getAddressesFromLocation failed, code: ${err.code}, message: ${err.message}`);
        // ...
      }
    });
  }
}