场景图

时序图

前序文档

行为数据服务初始化

关键参数

com.autonavi.gbl.user.usertrack.model.GpsTrackPoint GPS定位信息

f64Longitude 经度
f64Latitude 纬度
f32Speed 速度（公里/小时）
n64TickTime 时间戳，GPS卫星时间戳（单位：毫秒）
nSectionId 路线段ID，接续导航标记

com.autonavi.gbl.user.usertrack.model.GpsTrackDepthInfo

filePath 轨迹文件存放路径
fileName 轨迹文件名称
fastestIndex 最快速点在列表中的索引位置
trackPoints 轨迹GPS点集合
duration Gps轨迹有效时长（单位:秒）
distance Gps轨迹距离（单位:米）
averageSpeed 平均速度（单位：米/秒）

轨迹文件名基础版命名规则：timestamp_navitype_devicecode

timestamp: 开始记录轨迹时间戳（单位: 毫秒）

navitype: 导航或者巡航（0: 巡航 1: 导航）

devicecode: 车机设备唯一标识

核心接口

int com.autonavi.gbl.user.usertrack.UserTrackService.startGpsTrack(String, String, long)

int com.autonavi.gbl.user.usertrack.UserTrackService.closeGpsTrack(String, String)

int com.autonavi.gbl.user.usertrack.UserTrackService.obtainGpsTrackDepInfo(String, String)

GpsTrackPoint com.autonavi.gbl.user.usertrack.observer.IGpsInfoGetter.getGpsTrackPoint()

void com.autonavi.gbl.user.usertrack.observer.IUserTrackObserver.onStartGpsTrack(int, String, String)

void com.autonavi.gbl.user.usertrack.observer.IUserTrackObserver.onCloseGpsTrack(int, String, String, GpsTrackDepthInfo)

void com.autonavi.gbl.user.usertrack.observer.IUserTrackObserver.onGpsTrackDepInfo(int, String, String, GpsTrackDepthInfo)

说明：函数详情，请复制函数名称到在线API搜索

调用示例

//1. 开始打点，生成轨迹文件\nString filePath = ""; // GPS轨迹文件保存路径\nString fileName = ""; // GPS轨迹文件名 timestamp_navitype_devicecode\nlong nTimerRate = 2000; // 定时器触发间隔时间 单位:毫秒，不要低于 500\nint nRet = UserTrackPresenter.getInstance().startGpsTrack(filePath, fileName, nTimerRate);\n// nRet 返回 0 调用成功\n\n// 1.1 对应异步回调 onStartGpsTrack 通知开始结果\npublic void onStartGpsTrack(int n32SuccessTag, String psSavePath, String psFileName) {\n    // 可以调用 setBehaviorData 接口 保存未完成的行程数据(没有终点信息)\n}\n\n//2. 停止打点，调用时机 停止导航、巡航导航切换\nint nRet = UserTrackPresenter.getInstance().closeGpsTrack(filePath, fileName);\n// nRet 返回 0 调用成功\n\n// 2.1 对应异步回调 onCloseGpsTrack 通知开始结果\npublic void onCloseGpsTrack(int n32SuccessTag, String psSavePath, String psFileName, GpsTrackDepthInfo depInfo) {\n    // 1.判断轨迹数据是否有效， 基础版只保存 导航里程超过 5KM 的行程数据\n    // 2.获取 开始打点时保存的 未完成的行程数据\n    // 3.补全终点信息\n    // 4.调用 setBehaviorData 接口 保存完成的 GPS轨迹信息\n}\n\n//3. 获取轨迹文件信息\nint nRet = UserTrackPresenter.getInstance().obtainGpsTrackDepInfo(filePath, fileName);\n// nRet 返回 0 调用成功\n\n// 3.1 对应异步回调 onGpsTrackDepInfo 通知开始结果\npublic void onGpsTrackDepInfo(int n32SuccessTag, String psSavePath, String psFileName, GpsTrackDepthInfo depInfo) {\n    // 1.显示轨迹信息\n}