【鸿蒙 HarmonyOS Next 最佳实践】位置定位场景开发指导

已于 2024-11-01 16:24:41 修改
阅读量2.2k 收藏 18
点赞数 27
分类专栏： HarmonyOS Next 鸿蒙开发 文章标签： harmonyos 华为
于 2024-11-01 16:22:55 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/zhangtian6691844/article/details/143434701
版权

简介

位置定位提供了GNSS定位、网络定位等多种功能。在实际开发场景中，经常会使用位置定位的功能，如城市定位功能、外卖与快递服务实时跟踪配送员位置、汽车实时导航等等。
常见开发场景如下所示：

  • 使用精准定位确认具体位置
  • 获取历史定位
  • 实时获取当前位置
  • 后台定位

申请定位权限

场景描述

应用在使用位置能力前，首先需要确认系统的位置开关为开启状态。如果系统位置能力没有开启，应用不能使用定位服务。


其次，设备的位置信息需要想用户申请对应的访问权限，用户授权后，应用才能使用定位服务。需要用户授权的用户如下所示。

  • ohos.permission.LOCATION：用于获取精准位置，精准度在米级别。
  • ohos.permission.APPROXIMATELY_LOCATION：用于获取模糊位置，精确度为5公里。
  • ohos.permission.LOCATION_IN_BACKGROUND：用于应用切换到后台仍然需要获取定位信息的场景。

开发步骤

1.在module.json5中配置需要的权限。

{
// ...
 "requestPermissions": [
         {
           "name": "ohos.permission.LOCATION",
           "reason": "$string:location_permission",
           "usedScene": {
             "abilities": [
               "EntryAbility"
             ],
             "when": "inuse"
           }
         },
         {
           "name": "ohos.permission.INTERNET",
           "reason": "$string:internet_permission",
           "usedScene": {
             "abilities": [
               "EntryAbility"
             ],
             "when": "inuse"
           }
         },
         {
           "name": "ohos.permission.APPROXIMATELY_LOCATION",
           "reason": "$string:fuzzy_location_permission",
           "usedScene": {
             "abilities": [
               "EntryAbility"
             ],
             "when": "inuse"
           }
         },
         {
           "name": "ohos.permission.LOCATION_IN_BACKGROUND",
           "reason": "$string:location_permission",
           "usedScene": {
             "abilities": [
               "EntryAbility"
             ],
             "when": "inuse"
           }
         }
       ]
// ...
}

2.详细申请定位权限的代码如下所示。关于权限的申请，详情可以参考向用户申请授权。

// 引入abilityAccessCtrl
import { UIAbility, AbilityConstant, Want, abilityAccessCtrl } from '@kit.AbilityKit';
// ...

export default class EntryAbility extends UIAbility {
  async onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
    Logger.info(TAG, `[Demo] EntryAbility onCreate`);
    let atManager = abilityAccessCtrl.createAtManager();
    try {
      // 申请权限
      atManager.requestPermissionsFromUser(this.context,
        ['ohos.permission.INTERNET', 'ohos.permission.LOCATION', 'ohos.permission.APPROXIMATELY_LOCATION'])
        .then((data) => {
          Logger.info(TAG, `data: ${JSON.stringify(data)}`);
        })
        .catch((err: BusinessError) => {
          Logger.error(TAG, `err: ${JSON.stringify(err)}`);
        })
    } catch (err) {
      Logger.error(TAG, `catch err->${JSON.stringify(err)}`);
    }
  }
// ...
}
​

使用精准定位确认具体位置

场景描述

关于位置定位，主要有两种方式GNSS定位和网络定位，如下表所示。

定位方式说明优点
GNSS定位基于全球导航卫星系统，包含GPS、GLONASS、北斗、Galileo等，通过导航卫星、设备芯片提供的定位算法，来确定设备准确位置。定位精准
网络定位通过网络进行定位，包括WLAN、蓝牙定位、基站定位。定位速度快

位置定位的策略是主要是基于GNSS定位和网络定位实现的，定位精准的策略使用的是GNSS定位，定位快速的策略使用的网络定位。
获取定位信息的接口getCurrentLocation需要设置定位策略和单次定位超时时间，单次定位超时时间建议设置为10秒，定位策略支持两种参数配置，分别是CurrentLocationRequest和SingleLocationRequest。SingleLocationRequest从API version 12开始支持，在实现上更为简单，也是推荐的实现方式。CurrentLocationRequest和SingleLocationRequest的定位策略对比如下所示：

参数类型策略值说明
CurrentLocationRequestPRIORITY_ACCURACY0x501表示精度优先。(GNSS定位)
PRIORITY_LOCATING_SPEED0x502表示快速获取位置优先。(网络定位)
SingleLocationRequestUNSET0x200表示未设置优先级，表示LocationRequestPriority无效。
ACCURACY0x201表示精度优先。(GNSS定位)
LOW_POWER0x202表示低功耗优先。(网络定位)
PRIORITY_LOCATING_SPEED0x203表示快速获取位置优先，如果应用希望快速拿到一个位置，可以将优先级设置为该字段。 快速定位优先策略会同时使用GNSS定位和网络定位技术。
开发步骤

如下流程图所示，使用精准定位确认具体位置分为以下多个步骤。
1.开启系统定位能力，向用户申请位置权限。
2.设置定位策略，确认当前定位的方式。
3.获取当前定位信息。
4.将定位坐标转化为地理描述。

如下代码所示，设置定位的策略为PRIORITY_LOCATING_SPEED，即速度优先，并根据PRIORITY_LOCATING_SPEED的策略调用getCurrentLocation获取当前位置。

getLocationPosition(): void {
  // 设置LocatingPriority定位策略
  let request: geoLocationManager.SingleLocationRequest = {
    locatingPriority: geoLocationManager.LocatingPriority.PRIORITY_LOCATING_SPEED,
    locatingTimeoutMs: CommonConstants.TEN_THOUSAND
  };
  // 根据策略获取当前定位信息
  geoLocationManager.getCurrentLocation(request).then((location: geoLocationManager.Location) => {
    // 位置转化
    this.getAddress({
      latitude: location.latitude,
      longitude: location.longitude
    });
  }).catch((err: BusinessError) => {
    promptAction.showToast({
      message: JSON.stringify(err),
      duration: CommonConstants.TWO_THOUSAND
    });
  });
}

通过getAddressesFromLocation将定位坐标转化为地理描述，代码如下所示：

async getAddress(location: LocationInter) {
    try {
      // ...
      let reverseGeocodeRequest: geoLocationManager.ReverseGeoCodeRequest = {
        locale: getContext(this).resourceManager.getStringSync($r('app.string.language')),
        latitude: location.latitude,
        longitude: location.longitude,
        maxItems: 1
      };
      // 通过getAddressesFromLocation将定位坐标转化为地理描述
      geoLocationManager.getAddressesFromLocation(reverseGeocodeRequest, async (err, data) => {
        if (data) {
          this.address = data[0]?.placeName || '';
          this.marker?.setInfoWindowVisible(true)
          this.marker?.setSnippet(this.address)
        } else {
          promptAction.showToast({
            message: JSON.stringify(err),
            duration: CommonConstants.TWO_THOUSAND
          });
        }
      });
    } catch (error) {
      promptAction.showToast({
        message: JSON.stringify(error),
        duration: CommonConstants.TWO_THOUSAND
      });
    }
  }

获取历史定位

场景描述

如下图所示，历史定位的缓存是所有应用公用的，应用1和应用2调用getLastLocation获取的缓存是同一个。

开发步骤

通过getLastLocation获取上一次的缓存定位，代码如下所示。

getPreLocationPosition(): void {
  try {
    let location = geoLocationManager.getLastLocation();
    this.getAddress({
      latitude: location.latitude,
      longitude: location.longitude
    });
  } catch (err) {
    promptAction.showToast({
      message: JSON.stringify(err),
      duration: CommonConstants.TWO_THOUSAND
    });
  }
}
​

持续获取当前位置

场景描述

持续获取当前位置常用于导航、运动轨迹、出行等场景。持续获取需要设置位置请求参数，当前locationChange事件支持LocationRequest和ContinuousLocationRequest两种参数。ContinuousLocationRequest从API version 12开始支持，简单易用，推荐使用ContinuousLocationRequest进行配置。

开发步骤

持续获取当前位置主要分为以下步骤：

  • 设置位置请求参数ContinuousLocationRequest
  • 开启位置变化订阅locationChange
  • 设置回调接口

核心代码如下所示：

onLocationChange(): void {
  // 设置位置请求参数
  let request: geoLocationManager.ContinuousLocationRequest = {
    interval: 1,
    locationScenario: CommonConstants.NAVIGATION
  };
  try {
    // 开启位置变化订阅
    geoLocationManager.on('locationChange', request, this.locationChange);
  } catch (err) {
    promptAction.showToast({
      message: JSON.stringify(err),
      duration: CommonConstants.TWO_THOUSAND
    });
  }
}
  
// 回调接口
locationChange = (location: geoLocationManager.Location): void => {
  this.getAddress({
    latitude: location.latitude,
    longitude: location.longitude
  });
}

后台定位

场景描述

后台定位常用于应用切换到后台后，应用需要继续定位的场景。后台定位的功能需要获取ohos.permission.LOCATION_IN_BACKGROUND权限，同时需要申请长时任务。

核心代码
let context = getContext(this) as common.UIAbilityContext;
    let wantAgentInfo: wantAgent.WantAgentInfo = {
      // 点击通知后，将要执行的动作列表
      wants: [
        {
          bundleName: context.abilityInfo.bundleName,
          abilityName: context.abilityInfo.name
        }
      ],
      operationType: wantAgent.OperationType.START_ABILITY,
      requestCode: 0,
      wantAgentFlags: [wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
    }
    wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj: WantAgent) => {
      backgroundTaskManager.startBackgroundRunning(context, backgroundTaskManager.BackgroundMode.LOCATION, wantAgentObj)
        .then(() => {
          console.log('cwq start background task success');
          this.startLocation()
        })
        .catch((err: BusinessError) => {
          console.error(`cwq Failed to operation startBackgroundRunning. Code is ${err.code}, message is ${err.message}`);
        });
    }).catch((err: BusinessError) => {
      console.error(`cwq Failed to operation getWantAgent. Code is ${err.code}, message is ${err.message}`);
    });
  }

startLocation() {
    console.log('cwq start location');
    let locationChange = (location: geoLocationManager.Location): void => {
      console.log('cwq locationChanger: data: ' + JSON.stringify(location));
    };
    let requestInfo: geoLocationManager.LocationRequest = {
      'scenario': geoLocationManager.LocationRequestScenario.NAVIGATION,
      'timeInterval': 0,
      'distanceInterval': 0,
      'maxAccuracy': 0
    };
    geoLocationManager.on('locationChange', requestInfo, locationChange);
  }
​

常见问题

位置定位有偏差
  1. 华为地图在中国大陆、中国香港和中国澳门使用GCJ02坐标系，若使用WGS84坐标系直接叠加在华为地图上，因坐标值不同，展示位置会有偏移。所以，在中国大陆、中国香港和中国澳门如果使用WGS84坐标调用Map Kit服务，需要先将其转换为GCJ02坐标系再访问。
  2. 网络定位的精度较差，可能会有较大偏差。
  3. 如果使用的是GNSS定位，在室内等强遮蔽定位场景下，无法提供准确的位置服务。
先使用getCurrentLocation获取定位，再使用getLastLocation获取定位，两个值不一致

场景描述
用getCurrentLocation获取到的定位后，再使用getLastLocation获取到的位置和原来的值不一样
可能原因
定位缓存所有应用用的都是一份，有可能中间有其它应用定位把缓存位置刷新了。
解决方案
可以对比一下获取的时间，根据时间判断是否有更新。

欢迎大家评论留言，讨论！有其他开发方案也可以分享给我！

鸿蒙HarmonyOS应用开发 |鸿蒙技术分享HarmonyOS Next 深度解析：分布式能力与跨设备协作实战
一键难忘的博客
12-04 3847
HarmonyOS Next 作为鸿蒙系统的新一代迭代产品，通过进一步增强分布式能力和生态整合，为开发者提供了高效、灵活的开发体验。本文深入探讨了其分布式架构的核心机制，并通过跨设备实时共享画板的实战案例，展示了其强大的设备协同能力。从代码设计到性能优化，我们发现，HarmonyOS Next 不仅简化了多设备开发的复杂性，还通过模块化、开放式的框架提升了应用场景的扩展潜力。分布式软总线提供了快速、稳定的设备连接与通信。分布式数据管理实现了多设备间数据一致性与同步的高效支持。统一开发框架。
鸿蒙5.0开发进阶：地图定位打卡实现案例
HSMMQAQ的博客
11-12 1477
本示例使用geoLocationManager进行地理位置定位和地理信息获取........
鸿蒙Harmony应用开发—ArkTS声明式开发（通用属性：位置设置）
m0_64420071的博客
03-01 5066
ArkTS声明式开发（通用属性：位置设置）
HarmonyOS NEXT中申请用户位置信息授权和再次授权-系统级API获取地理位置的错误码类型问题getCurrentLocation()
最新发布
weixin_50513060的博客
03-15 537
在许多的app中，都需要用到获取用户的地理位置这一功能，由于地理位置属于隐私级别较高的系统能力，所以要申请用户授权，但是在用户授权时，可能出现多种场景，用户不授权，用户授权了但是系统的定位功能没有打开，用户授权了但是由于其他因素（网络问题）导致的获取定位失败。在用户拒绝授权后，怎样再次发起二次授权请求。
鸿蒙NEXT开发-位置服务
qq_56760790的博客
11-17 1125
鸿蒙位置基础能力服务的学习，包含了获取设备的位置信息、申请权限、地理编码等
【鸿蒙实战开发】定位相关知识（Locationkit）
HarmonyOS_002的博客
07-14 1462
这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、openHarmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。
【鸿蒙实战开发】HarmonyOS集成高德地图定位实现
HarmonyOS007的博客
08-06 4689
随着HarmoneyOS 应用的井喷式增长，各大厂商也都加快了自己原生应用鸿蒙化的脚步，今天使用高德打车的时候忽然间想到高德在鸿蒙上有没有实现呢?Key 名称根据规则填写，然后选择HarmoneyOS NEXT平台，把我们刚才复制的appid粘贴上去，点击提交。提交成功后就为我们创建了一个应用，我们把key复制下来，等会就用这个key来进行定位的鉴权。这样我们的工程配置就完成了，当我们打开应用后可以发现获取权限的弹窗提示（如图所示）可以看到已经获取到了，当前的经纬度，这样高德的定位功能就完美实现了。
鸿蒙HarmonyOS NEXT开发：位置设置（ArkTS组件事件）
shudaoshanBBQ的博客
08-07 1448
设置组件的对齐方式、布局方向和显示位置。
鸿蒙HarmonyOS NEXT开发实战：NetConnection开发指导
wewqeqwrqw的博客
09-14 1278
使用本文档涉及接口获取网络相关信息时，需先创建Native C++工程，在源文件中将相关接口封装，再在ArkTs层对封装的接口进行调用，使用hilog或者console.log等手段选择打印在控制台或者生成设备日志。
HarmonyOS NEXT 5.0鸿蒙开发一套影院APP
12-19
随着科技的不断发展与进步，智能手机操作系统领域呈现出多足鼎立的...开发者需要深入研究HarmonyOS NEXT 5.0提供的各种开发工具和API，以确保影院APP能够在HarmonyOS生态中脱颖而出，为用户提供高质量的影院观影体验。
鸿蒙HarmonyOS NEXT开发实战：跨设备互通NDK指导
wewqeqwrqw的博客
09-18 958
跨设备互通提供跨设备的相机、扫描、图库访问能力，平板或2in1设备可以调用手机的相机、扫描、图库等功能。
鸿蒙HarmonyOS开发：JSVM-API调试&定位使用场景
wqad23256的博客
11-20 1073
基于JSVM的JS代码调试调优能力包括：Debugger、CPU Profiler、Heap Snapshot、Heap Statistics。
鸿蒙开发中获取定位信息
LexinZong的博客
09-13 592
使用LocationButton位置控件，首次点击应用中的位置控件，系统将弹窗请求用户授权，如果用户点取消，弹窗消失，应用无授权，用户再次点击位置控件时将会重新弹窗；用户点击允许，弹窗消失，应用将被授予临时位置权限，此后点击该应用的位置控件将不会弹窗。精准定位的临时授权会持续到灭屏、应用切后台、应用退出等任一情况发生，然后恢复到临时授权之前的授权状态。2.通过Location kit将经纬度转为地址信息。3.将地址渲染到页面上。4.如果未开启定位将会闪退，处理闪退情况，用try catch。
在鸿蒙应用中实现位置定位
qq_31532979的博客
03-04 1118
通过以上步骤，就可以在鸿蒙应用中实现位置服务并获取设备的当前位置信息。
鸿蒙HarmonyOS获取GPS精确位置信息
沉溺于移动互联网
01-26 1826
鸿蒙获取GPS位置经纬度信息
鸿蒙应用权限控制与位置服务（Location Kit）
m0_73992525的博客
11-12 2384
11_11日学习笔记。
【HarmonyOS NEXT】获取设备的地理位置
weixin_71403100的博客
04-06 3430
获取移动设备的地理位置，包含：经度、维度、具体地理位置等，地理位置信息能在许多业务场景中被应用，如导航、地图服务、位置服务、社交媒体等。下面以一个Demo例子，来实现获取设备地理位置的功能。
鸿蒙应用开发学习：手机位置信息进阶，从经纬度数据获取地理位置描述信息
bahamutj的博客
01-26 3653
前几天，我通过学习华为官网的位置服务开发指南，实现了获取手机位置信息的功能，但当时的代码存在两个不足，一是我按照官网的指南使用的是getLastLocation()方法，得到的是最近一次的位置，第一次执行该应用获取到位置信息后，之后再次执行，获取的还是之前的位置信息，与实际位置不符；第二是获取到的位置信息是经度、纬度和海拔等数字信息，不能直管的显示做在的地理位置。
鸿邻社区HarmonyOS NEXT应用开发资料
1. HarmonyOS NEXT：HarmonyOS 是华为开发的操作系统，旨在为多种设备和场景提供统一的分布式体验。NEXT可能是HarmonyOS的一个版本或者是特定于项目的开发阶段的标识，这表明鸿邻社区应用是基于HarmonyOS最新或特定...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值