最近在做一个户外运动类的小项目需要在Android端把用户的运动轨迹记录下来生成一条可回放、可导出的路径。我选择了Android系统自带的GPS APILocationManager来实现没有引入高德或百度定位SDK。做完之后回头看这套方案虽然代码量不大但涉及权限适配、定位参数调优、后台保活、数据落盘、坐标纠偏等一系列问题每一步都有坑。这篇文章就把我这次实现轨迹记录功能的完整过程、踩坑记录和可直接抄的代码结构整理出来给需要做类似功能的朋友一个参考。如果你是刚入门的Android开发者或者正在做一个轻量级的轨迹记录工具这篇文章应该能让你少走不少弯路。我会尽量把每个关键选择的原因也讲清楚不光是给结论还会解释为什么这么做。1. 功能设计与需求拆解1.1 核心需求我这次要做的是在App里提供一个“开始记录”和“结束记录”的入口用户在开始记录后App每隔一段时间比如3秒或每隔一定距离比如5米获取一次当前GPS位置把经纬度、速度、方向、海拔、时间戳这些信息记录下来结束后把轨迹数据保存在本地并且能在界面上简单地画出一条路径。听起来很简单但仔细拆下来有几个关键点定位源的选择用GPS还是网络定位是否需要支持室内定位频率控制时间间隔和最小距离怎么配才能兼顾精度和耗电后台记录用户切到后台或锁屏时轨迹不能断。数据存储怎么组织记录数据用什么格式保存能不能导出成通用格式比如GPX。权限适配Android 6.0以上动态权限、Android 10以上分区存储、Android 12以上精确定位权限都要处理。我最终选择原生LocationManager一个原因是项目里不想为了一个轨迹记录功能就引入重量级定位SDK另一个原因是GPS API在绝大多数手机上都能稳定工作不依赖第三方服务。当然它的缺点也很明显初次定位慢、室内定位基本不可用、没有地图相关能力这些后面会讲到。1.2 方案选型原生GPS API足够用现在做定位很多方案会优先推荐高德定位SDK、百度定位SDK或者Google Play服务里的FusedLocationProviderClient。我这次没有用第三方原因有三点第一这个功能的核心是“轨迹记录”不是“逆地理编码”或“地图展示”第三方SDK很多能力我用不上反而会增加包体积和申请Key的流程。第二原生LocationManager返回的Location对象已经包含经纬度、速度、海拔、方位、精度、时间等字段完全够用。第三国内Android设备没装Google Play服务的情况很常见FusedLocationProviderClient在某些机型上会出现不回调的问题排查起来很麻烦。但如果你要做的是类似“城市导航”这种需要快速定位、室内外无缝切换的功能那就老老实实用高德或百度。它们内部有基站、Wi-Fi、GPS多源融合定位首次定位速度比纯GPS快很多。轨迹记录一般是户外场景GPS信号条件好原生API就够。1.3 前置准备开发前先把环境确认好我用的Android Studio版本是稳定版targetSdk版本要适配到当前主流系统。轨迹记录属于定位功能涉及用户的敏感信息所以必须申请权限并在隐私政策中说明。主要权限是android.permission.ACCESS_FINE_LOCATION android.permission.ACCESS_COARSE_LOCATION如果要在后台持续定位还需要申请后台定位权限Android 10引入比如android.permission.ACCESS_BACKGROUND_LOCATION这个权限在Android 10及以上需要单独申请而且不能和前台权限一起弹出需要在设置里单独授权后面我会细说。另外如果记录轨迹时App处于前台只是偶尔切后台可以考虑用前台服务加通知的方式这样不需要单独申请后台定位权限只在前台定位权限下也能持续获取位置但要保证有前台服务运行。2. 核心细节解析与实操要点2.1 LocationManager的工作方式LocationManager是Android系统提供的位置管理类使用方式非常简单先从系统服务获取实例然后requestLocationUpdates注册一个监听器系统会按照你设置的参数周期性地通过LocationListener回调Location对象。这里有一个新手很容易搞混的概念LocationManager通过不同provider来区分定位源常见的有GPS_PROVIDER纯GPS卫星定位精度高耗电高室内基本没用。NETWORK_PROVIDER基站和Wi-Fi定位速度快室内能用但精度不稳定。PASSIVE_PROVIDER被动接收其他应用请求的位置更新自己不主动请求。我的做法是优先使用GPS_PROVIDER但为了在GPS信号弱的场景下尽量不断数据可以在监听器里做降级判断。比如GPS超时没拿到位置就去取NETWORK_PROVIDER的最后一个已知位置。还有一种更省电的做法注册两个provider的监听收到网络定位结果后只作为临时参考等到GPS定位结果回来以后覆盖它。2.2 参数调优时间间隔与最小距离requestLocationUpdates方法支持设置最小时间间隔和最小距离这两个参数很多人不理解以为设了时间间隔就会严格按这个间隔回调。实际上系统会尽量满足时间间隔但也会受到最小距离的限制。只有当两个条件都满足时才会触发回调。如果设置最小距离为0则只要位置变化就回调如果设置最小距离为5米则至少要移动5米才会触发。我这次用的参数是long minTime 3000; // 3秒 float minDistance 5f; // 5米 locationManager.requestLocationUpdates( LocationManager.GPS_PROVIDER, minTime, minDistance, locationListener, Looper.getMainLooper() );为什么选3秒和5米户外跑步场景正常速度约3米/秒3秒移动9米左右5米阈值可以过滤掉原地不动的抖动点同时保留足够密度的轨迹点。如果做骑行或开车记录建议改成1秒和2米但耗电会明显变快如果只是徒步可以放宽到5秒和10米一样能画出连续轨迹。这里提醒一下requestLocationUpdates的参数是“最小”时间和“最小”距离实际回调间隔会受硬件和系统调度影响不要依赖它精确到毫秒。我做的是把每次回调的Location对象加上一个时间戳这样后期处理时可以知道每个点实际记录的时刻。2.3 首次定位慢与GPS冷启动处理GPS冷启动是轨迹记录里最容易遇到的问题。用户点“开始记录”之后如果等了5秒界面上还没有任何位置反馈就会觉得App坏了。原因很简单GPS模块需要搜星第一次获取有效定位可能耗时10到30秒甚至更久尤其是在高楼间、树荫下或阴天。解决这个问题的标准做法是先调getLastKnownLocation拿一次缓存位置展示给用户“正在启动定位上次已知位置是xxx”等系统GPS定位成功后再切换到实时位置。但getLastKnownLocation返回的位置可能已经过时有的甚至隔了好几个小时所以拿到后要判断时间戳只把5分钟内的位置当作有效缓存否则提示用户等待。加速冷启动还有一个有用的小技巧在申请定位权限之前先测试一下GPS开关是否打开。如果用户关闭了系统定位LocationManager是收不到任何回调的必须引导用户去打开定位开关。可以用Settings.Secure.isLocationProviderEnabled(ContentResolver, LocationManager.GPS_PROVIDER)来判断但不能保证在新系统上一定有效更稳妥的是监听GPS状态或者直接提示用户检查系统定位开关。3. 实操过程与核心环节实现3.1 工程结构与依赖这是一个单模块的普通Android项目没有引入额外的定位依赖只用了系统API和Kotlin协程做异步存储。我的代码结构大致如下app/src/main/java/com/example/trackrecorder/ MainActivity.kt // 界面和权限处理 TrackRecorder.kt // 轨迹记录核心类 TrackPoint.kt // 轨迹点数据模型 TrackRepository.kt // 数据存储如果你用的是Java逻辑也完全一样只是语法不同。我这段代码可以改造成一个单独的TrackRecorder工具类放到项目里直接用。3.2 Manifest配置与动态权限申请Manifest里首先声明权限注意我这里连后台定位权限一起声明了但不会在首次启动就申请而是在需要后台记录时再引导uses-permission android:nameandroid.permission.ACCESS_FINE_LOCATION / uses-permission android:nameandroid.permission.ACCESS_COARSE_LOCATION / uses-permission android:nameandroid.permission.ACCESS_BACKGROUND_LOCATION / uses-permission android:nameandroid.permission.FOREGROUND_SERVICE / uses-permission android:nameandroid.permission.FOREGROUND_SERVICE_LOCATION /Android 12和13对前台服务类型有要求。具体来说如果targetSdk是34前台服务声明里最好指定foregroundServiceTypelocation如下service android:name.TrackService android:exportedfalse android:foregroundServiceTypelocation /动态权限这块我用的是Activity Result API。先检查checkSelfPermission没有授权就调用requestPermissions。注意Android 10以上如果要在后台持续定位必须到系统设置里单独开启“允许始终访问位置信息”在运行时申请弹窗里只有“仅使用期间允许”的选项。我在首次定位权限授权后会弹一个自定义引导浮层告诉用户如果切后台会停止记录并引导到设置页开启后台定位。3.3 轨迹采集核心代码轨迹记录类的主流程分四步开始记录、采集点、暂停/继续、结束。核心采集逻辑如下class TrackRecorder(context: Context) { private val locationManager context.getSystemService(Context.LOCATION_SERVICE) as LocationManager private val trackPoints mutableListOfTrackPoint() private val listener object : LocationListener { override fun onLocationChanged(location: Location) { val point TrackPoint( lat location.latitude, lon location.longitude, altitude location.altitude, speed location.speed, bearing location.bearing, accuracy location.accuracy, timestamp location.time ) trackPoints.add(point) // 回调到界面刷新 onPointRecorded?.invoke(point) } override fun onProviderEnabled(provider: String) {} override fun onProviderDisabled(provider: String) {} } fun start() { if (hasPermission()) { try { locationManager.requestLocationUpdates( LocationManager.GPS_PROVIDER, 3000L, 5f, listener, Looper.getMainLooper() ) } catch (e: SecurityException) { // 没有权限 } } } fun stop() { locationManager.removeUpdates(listener) } }这里有个细节我在onLocationChanged回调里没有做耗时操作只是把点加入内存列表和一个轻量级回调执行。因为LocationListener默认可以运行在任意线程如果传的是main looper就放在主线程更要注意不能卡顿。真正的存储我是在stop时统一写的避免频繁I/O导致掉帧。3.4 轨迹数据落盘与生命周期管理一直把点存在内存里如果App被杀就全丢了。我采用的方式是记录过程中边采集边写缓存但缓存不直接写到JSON或数据库而是先写到一个临时文件里每收到一个点就追加一行格式是“时间,纬度,经度,海拔,速度,方向,精度”。这样即使过程中崩溃临时文件还在下次启动可以恢复部分数据。结束时再把临时文件解析生成一个完整的记录条目保存到Room数据库同时导出一份GPX文件到应用专属外部目录。GPX是通用的轨迹交换格式方便用户以后导入到其他地图软件查看。GPX文件内容类似这样?xml version1.0 encodingUTF-8? gpx version1.1 creatorTrackRecorder trk name20240607-1530/name trkseg trkpt lat39.908823 lon116.397470 ele44.0/ele time2024-06-07T15:30:12Z/time /trkpt /trkseg /trk /gpxGPX的时间必须用UTC时间的ISO8601格式不能直接用本地时间字符串很多工具导入时认识不了。转换方式很简单用SimpleDateFormat加上TimeZone.getTimeZone(UTC)即可。轨迹记录的App生命周期也要注意。如果只是用户在前台使用不涉及后台记录直接在Activity的onDestroy里调用stop即可。但如果要支持锁屏后继续记录就要用前台服务。一个简单的方案是TrackRecorder运行在Service里Service通过startForeground显示一个常驻通知这样系统不会轻易回收它而且可以在状态栏显示当前轨迹长度和时间。3.5 简单轨迹绘制验证记录完轨迹后我需要在界面上看到效果最简单的办法是用MapView。但我这次不想引入地图SDK所以我做了一个自绘View来验证轨迹把经纬度范围映射到Canvas坐标然后drawPolyline。这个方法精度不高但足以确认记录的点是连续的、逻辑是对的。具体做法是遍历轨迹点找到纬度的最大值最小值和经度的最大值最小值然后按View的宽高等比例缩放把所有点画上去。如果后期要上正式功能再替换成高德地图或MapView把轨迹点转成Polyline添加到地图上即可。4. 常见问题与排查技巧实录4.1 常见问题速查表下面这些是我测试过程中遇到最频繁的问题整理成表格方便直接对照现象可能原因解决方法点击开始后一直没有定位回调系统定位开关关闭没有权限GPS冷启动检查系统定位设置检查运行时权限等几秒或调用getLastKnownLocation定位点忽远忽近轨迹出现漂移信号反射高楼遮挡低精度网络定位混入过滤掉accuracy大于30米的点只用GPS_PROVIDER对速度做平滑App切后台后轨迹中断没有后台定位权限没有前台服务被电池优化省电杀死引导开放始终定位权限使用前台服务申请忽略电池优化或引导加白名单部分手机写完GPX后文件找不到Android 10分区存储限制存到context.getExternalFilesDir()不用getExternalStorageDirectory()定位时间不准确导致轨迹时间轴错乱系统时间和网络时间未同步GPS周数翻转使用location.getTime()而不是System.currentTimeMillis()引导用户开启自动时间高德/百度地图导入轨迹出现偏移坐标系不同GCJ-02和WGS-84之间没有转换了解坐标系必要时在导出时增加坐标转换配置4.2 GPS在室内或高楼附近定位飘移GPS定位依赖卫星信号在室内、地下车库、隧道和高楼密集区信号会被建筑物遮挡或反射产生多径效应定位结果会飘移。你会发现轨迹上出现一些离实际路径很远的“飞点”就像一瞬间飞到了马路对面。我的处理方案有两层。第一层是采集时的过滤在onLocationChanged里判断location.getAccuracy()超过阈值就直接丢弃不加入轨迹点。阈值要根据场景设置跑步我一般用30米超过就丢。第二层是后处理时写一个简单的平滑算法如果当前点与上一个点的速度超过一个合理范围比如每秒50米即每小时180公里明显不符合步行或跑步就认为这个点是噪声过滤掉。再配合一个低通滤波对坐标做一点点修正轨迹会漂亮很多。4.3 Android后台限制导致记录中断我这次在真机测试时发现有些手机在锁屏几分钟后记录会悄悄停下来打开屏幕后发现轨迹缺了一块。原因主要是系统省电策略把后台Service冻结了还有一个原因是部分国产ROM的“后台耗电管理”默认拦截应用自启动。解决方案是双管齐下。首先在记录过程中使用前台服务并给通知加上“进行中的操作”这样系统至少知道你在干活。其次在开始记录前主动检测应用是否允许后台运行如果没有引导用户到系统设置里把应用加进“耗电白名单”。MobileSecure等工具的原理也类似但咱自己App里至少要提供一个打开系统设置的引导入口让用户手动配置。另外有一点值得注意每次进入后台系统可能在日志里记录一个“stopLocationUpdates”之类的调用但这不代表一定是系统关掉了定位有时是省电模式把GPS芯片暂停了。我测试下来最稳的组合是“前台服务 允许后台定位权限 用户手动关闭对该应用的电池优化”。4.4 坐标偏移问题这个问题在做地图展示时特别明显。Android系统LocationManager返回的是WGS-84坐标系经纬度而国内大多数地图服务高德、百度使用的是GCJ-02或BD-09坐标系。如果你直接用WGS-84坐标画到高德地图上轨迹会整体偏移几百米看起来就像“跑偏”了。解决办法是如果只是为了自绘验证用WGS-84没问题如果你要把轨迹放到高德地图展示或导出给高德工具使用就需要在导出时做坐标转换。高德开放平台提供了坐标转换API也可以自己写GCJ-02偏移算法。我这个项目暂时没接入地图所以在数据模型里保留了原始坐标后期接地图时统一转换。这里给大家一个提醒不要在空中转换坐标最好在最终导出或显示时才转换避免累加误差。4.5 老设备GPS周数翻转与时间异常的坑某些老款手机或定位模块比较旧的设备在特定时间节点会出现GPS周数翻转问题表现是定位时间突然跳到过去或未来导致轨迹时间轴乱掉。严格来说这不是App代码能完全解决的但我们可以做防御性处理。我建议记录轨迹点时Location对象里的时间戳以location.getTime()为基础不要用System.currentTimeMillis()因为系统时间可能与GPS时间不一致。但location.getTime()也可能异常所以我会额外做一个判断如果当前点时间与上一个点时间差超过了5分钟并且地理位置变化小于几十米那大概率是时间戳异常就把这个点的时间修正为“上一个点时间 最后一次正常间隔”。遇到真正异常的设备我会在界面上提示用户检查系统时间和“使用网络提供时间”选项。5. 还能怎么扩展轨迹记录功能做完基础版本后可以继续扩展的方向其实挺多在地图上加载轨迹并回放、计算总里程和累计爬升、导出GPX/KML、生成轨迹分享图片、实时显示配速和海拔曲线。我目前做的是把数据采集和存储打扎实后续接地图和图表就是水到渠成的事。如果你打算接高德地图建议先申请Key再使用高德SDK的Polyline绘制轨迹坐标转换用高德提供的CoordinateConverter能省不少事。如果要做海拔曲线可以用Google的Elevation API或者离线DEM数据但免费方案精度有限户外专业场景还是得用专业设备。最后再分享一个实用小技巧测试定位功能时不要只坐在办公室试最好到室外开阔地走一圈。我调试时发现同一个手机在室内窗边和室外空地上首次定位速度可以相差半分钟以上这个差别会直接影响你判断“代码是不是有问题”。一定要先排除环境因素再看代码。我在实际项目里的经验是轨迹记录这个功能最核心的不是怎么拿定位而是怎么把拿到的定位数据处理得干净、稳定、可恢复。把上面这些边界情况处理好了这个功能才算真正可用。希望这篇文章能帮你顺利搞定Android上的轨迹记录功能。