目录

无法获取设备当前定位信息

问题现象

用户打开应用进入相关位置信息显示的页面,无法通过执行相关操作获取当前位置信息。包括但不限于:

背景知识

问题定位

  1. 复现问题:首次打开应用,进入相关位置信息显示的页面,期间若有位置权限获取弹窗则跳过步骤2。
  2. 排查应用是否在module.json5中声明正确的位置权限(需满足实际定位需求),同时根据关键词requestPermissionsFromUser查看是否有相关申请授权位置权限设置和触发逻辑。可参考场景一分析。
  3. 查看位置信息展示的页面属于ArkUI页面或者Web页面。
  4. 对于ArkUI页面,根据【背景知识】提供的相关接口、结合场景分析位置定位的实现原理:
    • 未使用位置服务获取位置:分析位置信息获取来源,进而排查是否数据请求失败。
    • 使用位置和地图服务获取位置:
      1. 位置服务:搜索位置请求API接口,查看获取位置逻辑是否正确,如,获取当前位置getCurrentLocation,同时排查位置请求参数的优先级和场景与当前场景是否匹配。
      2. 地图服务:查看setMyLocationControlsEnabled设置是否启用“我的位置”按钮。如果设置setMyLocation,排查通过Location Kit获取用户位置后,传递Map Kit的逻辑是否完善。
  5. 对于Web页面,通过调试H5页面,检查位置请求的触发逻辑。同时查看Web组件的onGeolocationShow接口对网站进行位置权限管理设置是否正确。

分析结论

[h2]场景一

由于未声明或未授予定位权限导致的定位失败,包括下列三种情况:

  1. 用户误操作,未开启位置服务或者拒绝了位置授权。
  2. 应用未向用户申请权限,或者未申请满足相应定位场景的位置权限。
  3. 位置权限授权弹窗的触发位置和逻辑设置不正确,未在首次打开应用进入需要获取位置的页面前向用户申请。

[h2]场景二

  1. 使用Location Kit(位置服务)获取当前定位信息,由于相关接口和请求参数设置不正确导致的定位失败。
  2. 使用Map Kit(地图服务)默认的连续定位能力,未设置setMyLocationControlsEnabled启用“我的位置”按钮,导致点击无响应。

[h2]场景三

位置权限请求属于Web前端页面发起的,由于未通过onGeolocationShow接口对网站进行位置权限管理(或设置不正确),并响应结果赋予前端页面权限导致的定位失败。

修改建议

[h2]场景一

  1. 增加提醒机制:通过isLocationEnabled判断位置服务是否已经使能和二次向用户申请授权完成引导用户。
  2. 在module.json5中声明相应定位权限,然后使用requestPermissionsFromUser()方法向用户申请授权。详情请参考应用权限申请开发实践。
  3. 优化位置权限授权弹窗的触发位置和逻辑设置,在需要获取位置前完成申请。

[h2]场景二

  1. 在确保位置权限获取的前提下,根据实际业务场景配置位置请求参数,获取设备的位置信息。详情参考开发步骤。
  2. 初始化地图并获取MapComponentController地图操作类对象。调用mapController对象的setMyLocationControlsEnabled方法启用“我的位置”功能,详情参考开发步骤。

[h2]场景三

参考申请位置权限,实现用户点击前端页面"获取位置"按钮,Web组件通过弹窗通知应用侧位置权限请求消息。

常见FAQ

Q:3301200定位失败,未获取到定位结果,错误信息:Failed to obtain the geographical location.

A:请参考错误码3301200的可能原因和解决方案。

Q:位置请求参数中maxAccuracy如何设置?

A:maxAccuracy是应用向系统请求位置信息时要求的精度值,当位置信息Location中的精度值(accuracy)小于等于maxAccuracy时,位置信息会返回给应用;否则系统将丢弃本次收到的位置信息。详情参考LocationRequest中对maxAccuracy的描述。

Q:在室内等特殊场地时,在持续定位场景中设置LocationRequest的timeInterval为1,为何不生效?

A:在室内因为没有GNSS信号,返回的是网络位置。因为WLAN扫描有较大的功耗,系统限制20秒扫描一次,因此在室内即使timeInterval设置为1,也只能20秒获取到一次位置。

Q:系统缓存位置信息不准确,使用getCurrentLocation()接口获取当前定位信息后,再使用getLastLocation()接口获取缓存定位信息,两次获取的定位信息不一致。

A:所有应用共用系统中的同一份缓存定位信息,有可能在两次接口调用之间有其他应用发起定位,刷新了系统中的缓存定位信息。可以对比获取定位信息的时间,根据时间判断缓存定位信息是否更新。

Q:开启飞行模式,是否可以获取设备当前定位信息?

A:开启飞行模式或者无网络场景下,会使用GPS进行定位,室内可能无GPS信息,需要空旷无遮挡的室外环境。

Q:位置定位中,如何获取当前定位的城市?

A:导入geoLocationManager模块,先调用isGeoServiceAvailable查询正地理编码与逆地理编码服务是否可用,确认服务可用后调用逆地理编码服务接口getAddressesFromLocation把经纬度坐标转化为地理位置信息,从回调中获得与此坐标匹配的GeoAddress(地理编码地址信息)列表,其中locality表示城市信息。