更新记录

1.1.0（2026-11-05）

• 首发：定位权限检测与引导、单次/连续定位采样、Haversine 里程与速度统计。
• 官方 map 组件轨迹可视化、GPX 导出；含漂移点过滤（不画飞线）。
• 深度增强：RDP 轨迹抽稀与包围盒缩放（免费性能优化）、停留点检测、完整轨迹统计、按里程分段配速、CSV 导出（Pro）。

平台兼容性

uni-app(4.0)

轨迹定位·合规采集 Pro（zl-loc-track）

简介

uni-app 轨迹定位套件：定位权限检测与引导、单次/连续定位采样、Haversine 里程与速度统计、官方 map 组件轨迹可视化、GPX 导出。合规采集：用户主动开启、随时可停、后台定位须前台服务可见通知，不静默采集、不捆绑地图厂商 SDK。

功能特性

• 轨迹抽稀（免费）：Ramer-Douglas-Peucker 保留形状、去掉冗余点，长轨迹地图渲染更轻
• 包围盒自适应缩放（免费）：include-points 只用对角两点，不再传全量点
• 停留点检测（Pro）：半径+时长双条件，外勤/配送拜访判定
• 完整轨迹统计（Pro）：里程、爬升/下降、最高速、移动与静止时长
• 分段配速与 CSV 导出（Pro）：按公里切段输出配速，表格软件可直接打开
• 定位权限检测与引导
• 单次 / 连续定位采样（串行采样省电）
• Haversine 里程与速度统计（增量计算防卡顿）
• 漂移过滤（防飞线）
• 官方 map 轨迹可视化与回放
• GPX 导出（导出至用户可见目录）

平台兼容

App-Android、App-iOS、H5、微信小程序（GPX 导出仅 App/H5）

快速上手

import { startTrack, stopTrack, exportGpx } from '@/uni_modules/zl-loc-track'
await startTrack({ intervalMs: 3000 })   // 连续采样
const pts = await stopTrack()              // 停止并返回轨迹点
await exportGpx(pts, 'my-track.gpx')      // 导出 GPX

Android 权限与配置

• ACCESS_FINE_LOCATION / ACCESS_COARSE_LOCATION
• 后台定位需 ACCESS_BACKGROUND_LOCATION + 前台服务类型 location
• iOS 需 NSLocationWhenInUseUsageDescription（持续采集需 Always 并说明用途）

合规声明

定位数据默认仅保存在设备本地，插件不上传任何位置信息；GPX 导出或上报由接入方实现，接入方需向用户告知用途。

常见问题

• Q：轨迹画飞线？ A：已内置漂移过滤，剔除低精度与速度异常点。
• Q：耗电快？ A：采用串行采样，避免 GPS 并发；可调大 intervalMs。

更新说明

1.0.0 首发：采样、漂移过滤、里程统计、轨迹回放、GPX 导出。 1.1.0 深度增强：RDP 轨迹抽稀与包围盒缩放（免费性能优化）、停留点检测、完整轨迹统计、分段配速与 CSV 导出（Pro）。