更新记录

0.1.0(2026-11-05) 下载此版本

0.1.0

  • 单次定位(超时快失败)/ 持续·后台定位 + 监护自愈 / wgs84·gcj02·bd09 互转 / 轨迹抽稀(Douglas-Peucker + 等距)/ 厂商设置一键引导。

平台兼容性

pk-location 定位套件

单次/持续/后台定位 + 监护自愈 + 坐标转换 + 轨迹抽稀 + 厂商引导 —— 纯 JS、零原生插件、免自定义基座、不绑定包名。

为什么做这款

调研 4 款头部保活/定位竞品(30+ 条评价)发现:头部 3 款停更仍占 4100+ 购买,痛点集中在——锁屏后定位悄悄失效没人知道、错误被吞掉、国产 ROM 白名单没人引导。pk-location 把"定位"从玄学变成数据:失效可感知、可自愈、可上报。

核心能力

模块 说明
getLocation() 单次定位:权限编排 + 超时快失败(E-LC-10)+ 坐标系统一输出
startWatch()/stopWatch() 持续定位(前台/后台):watchdog 监护 → 定位流中断自动重启 → 上限后上报 E-LC-20
getStatus() 监护快照:采集点数/自愈次数/缓冲区
coords.* wgs84/gcj02/bd09 互转、球面距离、轨迹总长(纯函数)
simplify.* Douglas-Peucker 形状保真抽稀 + 等距采样(纯函数)
vendor-guide 小米/华为/OPPO/vivo/三星/魅族 设置知识库 + 一键跳转
getCapabilities() 能力如实探测——不支持就是 supported:false,绝不假 true

使用

import pkLocation from '@/uni_modules/pk-location/js_sdk/index.js';
pkLocation.init();

const p = await pkLocation.getLocation({ coordType: 'gcj02', timeoutMs: 10000 });

await pkLocation.startWatch({ mode: 'bgWatch', onPoint: save, onRestart: i => console.warn('自愈', i.restarts) });

质量保障

  • 20 个 node 单测全绿(坐标往返精度、抽稀不变性、监护状态机、策略生成)
  • 厚逻辑全部纯函数化,运行时薄封装

文档

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

许可协议

MIT协议

暂无用户评论。