轨迹追踪

功能场景

出行、运动健康类app中动态展示小车、用户的轨迹变化。

Android

iOS

https://mapopen-website-wiki.cdn.bcebos.com/demos/andDemos/yingyan/轨迹追踪.mp4

扫码体验

使用产品

轨迹追踪

下载源码

核心接口

类

接口

描述

Trace

Trace(long serviceId, String entityName)

创建轨迹服务

setInterval(int gatherInterval, int packInterval)

设置采集和打包位置数据的时间间隔

startTrace(Trace mTrace, OnTraceListener traceListener)

开启轨迹服务

LBSTraceClient

startGather(OnTraceListener traceListener)

开启轨迹采集

stopTrace(Trace mTrace, OnTraceListener traceListener)

停止轨迹服务

stopGather(OnTraceListener traceListener)

停止轨迹采集

重点关注

1）、注意：回传周期不能小于定位周期，否则回传不生效；回传周期建议设置为定位周期的整数倍，打包间隔最小为2秒，最大为5分钟。
//位置采集周期
int gatherInterval = 2;
//打包周期
int packInterval = 12;
//设置位置采集和打包周期
client.setInterval(gatherInterval, packInterval);

2）、注意：因为startTrace与startGather是异步执行，且startGather依赖startTrace执行开启服务成功，所以建议startGather在public void onStartTraceCallback(int errorNo, String message)回调返回错误码为0后，再进行调用执行，否则会出现服务开启失败12002的错误。

3）、注意：开启服务、开启采集、停止采集、停止服务四个接口共用OnTraceListener监听器，每次调用时，请务必传入同一个监听器实例；或者在初始化时调用LBSTraceClient.setOnTraceListener()设置监听器，后续调用以上四个接口时无须再次传入，如：
开启服务LBSTraceClient.startTrace(mTrace, null)
开启采集LBSTraceClient.startGather(null)
此时回调消息由setOnTraceListener()时传入的监听器接收

核心代码

1.初始化轨迹服务

JAVA

// 轨迹服务ID 
long serviceId = 0;
// 设备标识
String entityName = "myTrace";
// 初始化轨迹服务
Trace mTrace = new Trace(serviceId, entityName);
// 初始化轨迹服务客户端
LBSTraceClient mTraceClient = new LBSTraceClient(getApplicationContext());

复制

深色

复制成功

2.设置上传打包周期

JAVA

// 定位周期(单位:秒)
int gatherInterval = 5;
// 打包回传周期(单位:秒)
int packInterval = 10;
trackApp.mClient.setInterval(gatherInterval, packInterval);

复制

深色

复制成功

3.初始化轨迹监听

JAVA

// 初始化轨迹服务监听器
OnTraceListener mTraceListener = new OnTraceListener() {
    // 开启服务回调
    @Override
    public void onStartTraceCallback(int status, String message) {}
    // 停止服务回调
    @Override
    public void onStopTraceCallback(int status, String message) {}
    // 开启采集回调
    @Override
    public void onStartGatherCallback(int status, String message) {}
    // 停止采集回调
    @Override
    public void onStopGatherCallback(int status, String message) {}
    ....
};

复制

深色

复制成功

4.开启服务

JAVA

trackApp.mClient.startTrace(trackApp.mTrace, traceListener);

复制

深色

复制成功

5.开启采集

JAVA

trackApp.mClient.startGather(traceListener);

复制

深色

复制成功

6.关闭采集

JAVA

trackApp.mClient.stopGather(traceListener);

复制

深色

复制成功

7.关闭服务

JAVA

trackApp.mClient.stopTrace(trackApp.mTrace, traceListener);

复制

深色

复制成功

https://mapopen-website-wiki.cdn.bcebos.com/demos/ioscodes/yingyan/轨迹追踪.mp4

扫码体验

使用产品

轨迹追踪

下载源码

核心接口

类

接口

描述

BTKStartServiceOption

NSString *entityName;

终端实体的名称

-(void)changeGatherAndPackIntervals:(NSUInteger)gatherInterval packInterval:(NSUInteger)packInterval delegate:(id <BTKTraceDelegate>)delegate;

设置采集和打包位置数据的时间间隔

-(void)startService:(BTKStartServiceOption *)option delegate:(id <BTKTraceDelegate>)delegate;

开启轨迹服务

BTKAction

startGather(OnTraceListener traceListener)

开启轨迹采集

-(void)startGather:(id <BTKTraceDelegate>)delegate;

停止轨迹服务

-(void)stopGather:(id <BTKTraceDelegate>)delegate;

停止轨迹采集

重点关注

1）、鹰眼iOS SDK V3.1.1开始支持在前台定位权限下使用，但App集成鹰眼SDK的最佳实践仍然是申请后台定位权限，后台定位的作用是保证应用退到后台时，仍然能持续获得轨迹，最大限度减少被系统杀死的概率。关于定位权限的配置，请参考开发指南中配置工程 说明。此版SDK具体新增内容为： BTKTraceDelegate 中新增-(void)onRequestAlwaysLocationAuthorization:(CLLocationManager*) locationManager; 回调函数，当鹰眼SDK需要申请后台定位权限时，会回调此方法，开发者可以这样实现此回调函数：

- (void)onRequestAlwaysLocationAuthorization:(CLLocationManager *)locationManager {
[locationManager requestAlwaysAuthorization];
}                

这样做的原因是：AppStore加强了定位权限的审核要求，如果App在plist文件中没有后台定位权限相关的配置，那么不能出现申请后台定位的代码。因此不需要后台定位的App就不需要实现此回调函数，可以通过上架审核。

2)、app保活

在onStartService回调的errorCode中新增BTK_START_SERVICE_SUCCESS_BUT_NO_AUTH_TO_KEEP_ALIVE 状态码，如果将keepAlive设置为true后调用startService时，还没有定位权限，则回调此状态码，代表轨迹服务开启成功，但是由于没有定位权限，无法实现保活，回调此状态码的同时，鹰眼SDK会根据用户选择的权限向系统申请对应的权限，如果用户选择的是前台或后台定位权限，那么在下一次开启轨迹服务时即可成功保活。

3）、鹰眼iOSSDK V3.1.2开始需要开发者主动申请定位权限,详情可参考工程配置。

4）、注意：回传周期不能小于定位周期，否则回传不生效；回传周期建议设置为定位周期的整数倍，打包间隔最小为2秒，最大为5分钟。

//设置位置采集和打包周期
[[BTKAction sharedInstance] changeGatherAndPackIntervals:2 packInterval:12 delegate:self];

核心代码

1.初始化轨迹服务

Objective-C

// 开启APP保活（可选）
// 1.info.plist配置
// <key>UIBackgroundModes</key>
// <array>
//    <string>location</string>
// </array>
// 2.keepAlive设置为true
BTKServiceOption *sop = [[BTKServiceOption alloc] initWithAK:AK mcode:BUNDLEID serviceID:serviceID keepAlive:true];
[[BTKAction sharedInstance] initInfo:sop];

复制

深色

复制成功

2.设置上传打包周期

Objective-C

[[BTKAction sharedInstance] changeGatherAndPackIntervals:2 packInterval:12 delegate:self];

复制

深色

复制成功

3.初始化轨迹监听

Objective-C

/**
  开启轨迹服务的回调方法
                   
  @param error 开启轨迹服务的结果
  */
-(void)onStartService:(BTKServiceErrorCode) error;
/**
 停止轨迹服务的回调方法                 
 @param error 停止轨迹服务的结果
*/
-(void)onStopService:(BTKServiceErrorCode) error;

/**
  开始采集的回调方法
                   
  @param error 开始采集的操作结果
*/
-(void)onStartGather:(BTKGatherErrorCode) error;
/**
 停止采集的回调方法
 @param error 停止采集的操作结果
*/
-(void)onStopGather:(BTKGatherErrorCode) error;

复制

深色

复制成功

4.开启服务

Objective-C

[[BTKAction sharedInstance] startService:startServiceOption delegate:self]; 
-(void)startService:(BTKStartServiceOption *)option delegate:(id <BTKTraceDelegate>)delegate;

复制

深色

复制成功

5.开启采集

Objective-C

// 启用后台位置指示器，进入后台时保留被授予的临时访问权限（精确位置）
[[BTKAction sharedInstance] showsBackgroundLocationIndicator:YES];
[[BTKAction sharedInstance] startGather:self];

复制

深色

复制成功

6.关闭采集

Objective-C

[[BTKAction sharedInstance] stopGather:self];                

复制

深色

复制成功

7.关闭服务

Objective-C

[[BTKAction sharedInstance] stopService:self];                

复制

深色

复制成功