更新记录
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 单测全绿(坐标往返精度、抽稀不变性、监护状态机、策略生成)
- 厚逻辑全部纯函数化,运行时薄封装
文档
- 在线文档(含示例下载):https://plugins.cnajiu.cn/public/pk-location.html
- 兼容性矩阵(如实标注):docs/compatibility.md
- 竞品调研:docs/research.md

收藏人数:
下载插件并导入HBuilderX
下载插件ZIP
赞赏(0)
下载 3
赞赏 0
下载 12745488
赞赏 1959
赞赏
京公网安备:11010802035340号