骑手端的同事投诉:派单页面显示的位置离真实位置差了四百米,商场里直接飘到隔壁街。定位这种功能平时没感觉,一翻车就是客诉。排查两天,把精度和功耗这对矛盾重新捋了一遍。

定位是分档的,别一律开高精度

HarmonyOS 的位置服务在 @kit.LocationKit,LocationRequestPriority 有三档:定位精度优先(PRIORITY_ACCURACY)、快速定位优先(PRIORITY_FIRST_FIX)、功耗优先(PRIORITY_POWER_CONSUMPTION)。

我们的第一版代码,所有页面都开了精度优先、一秒一次上报,结果就是:精度好的时候确实准,但骑手端 App 后台挂着,一上午电量掉百分之二十,用户直接卸载。

正确的姿势是按场景分档:

import { geoLocationManager } from '@kit.LocationKit';

// 派单页:高精度,间隔放宽到 5 秒
const ridingRequest: geoLocationManager.LocationRequest = {
  priority: geoLocationManager.LocationRequestPriority.ACCURACY,
  scenario: geoLocationManager.LocationRequestScenario.NAVIGATION,
  timeInterval: 5,
  distanceInterval: 10,
};

geoLocationManager.on('locationChange', ridingRequest,
  (location: geoLocationManager.Location) => {
    updateRiderMarker(location.latitude, location.longitude);
  });

distanceInterval 这个参数被我们忽略了很久:它表示位置变化超过多少米才回调。配送场景骑手不动时不需要刷新,设 10 米之后,回调次数直接砍掉七成,精度不受影响。

▲ 示意图 · 定位精度取舍

室内飘移要靠缓存裁决

商场里的四百米飘移,单纯调精度救不了——室内 GPS 信号弱,网络定位的基站误差就是几百米量级。工程上的解法不是追求更准的原始坐标,而是过滤可疑坐标:

let lastGoodLocation: geoLocationManager.Location | null = null;

function acceptLocation(loc: geoLocationManager.Location): boolean {
  if (!lastGoodLocation) return true;
  const dist = haversine(lastGoodLocation, loc);
  // 两次定位间隔内不可能移动那么远,判定为飘移
  const maxPossible = estimateMaxSpeed(lastGoodLocation, loc);
  return dist < maxPossible;
}

思路简单粗暴:骑手是骑电动车的,两次定位之间超过最大速度能跑的距离,这个点就是飘的,丢掉继续用上一个。上线后商场场景的客诉基本归零。geoLocationManager.getLocation() 返回的 accuracy 字段也可以参考,精度差于一百米的点先打个可疑标记,连续几个都差才真的切换。

单次定位和连续监听要分开

"打开页面获取当前位置"这种需求用单次 API 就够,别挂监听不摘:

const loc = await geoLocationManager.getCurrentLocation({
  priority: geoLocationManager.LocationRequestPriority.FIRST_FIX,
});

单次定位选 FIRST_FIX,用户要的是"有个位置"而不是"最准的位置"。连续监听才是精度优先的主场。

权限侧老话重提:LOCATION 是模糊定位,APPROXIMATELY_LOCATION 是更粗的一档,申请时把用途说明写清楚,授权率和精度都受益。

写在最后

两天排查的结论沉淀成三条规则:场景决定精度档位,distanceInterval 是免费的功耗优化,飘移靠速度裁决而不是堆精度。

定位功能做完不难,做得让用户无感才难——用户注意到你的定位,多半是因为它飘了。下次要接地图选点,逆地理编码那块的中文地址解析据说也有几个坑,先记在这。

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐