写这篇文章的初衷是因为刚开始做猎鹰轨迹功能的时候，除了高德本身相关的API可参考，其他基本很少有相关的教程，也入了一些坑。所以为了方便iOS开发者接入猎鹰轨迹功能，这里写一篇相关的教程。
概述：高德猎鹰功能是一套轨迹管理服务，提供移动端SDK（iOS和安卓）和后端API供开发者接入。猎鹰可以满足您追踪车辆等定位设备，其提供的丰富接口和云端服务，可以让开发者基于猎鹰迅速构建一套完全属于自己的精准、高效 的轨迹管理系统，应用于车队管理、人员管理等领域。"
关于如何接入轨迹sdk以及相关的配置这里就不讲了, 猎鹰SDK文档上都有介绍，唯一需要注意的是我们使用的key是iOS平台，是根据BundleID生成的，而不是创建web服务生成的key，web服务生成的key是后台人员用的。
在开始前先了解几个概念：
猎鹰轨迹服务：service (猎鹰轨迹服务。一个service对应一个轨迹管理系统，通过一个service可管理多个终端设备（即terminal），service的唯一标识符是sid。举例说明，针对某网约车公司的轨迹管理系统，可以创建一个service，在创建的service中管理所有营运车辆的轨迹)
服务id：service id（服务端开启service后，会返回serviceid，这个serviceid就相当于你应用的标识，例如你使用高德sdk，需要绑定你的包名，高德会创建你应用唯一的key）
终端id：terminal id（在启动轨迹上报服务(service id)时，需要提供terminal id信息，每个terminal id都对应您的业务中一个唯一的实体，相当于每个用户或车辆的唯一标识，一般是不会改变的）
轨迹id：track id （轨迹采集成功后，要将人员或车辆的轨迹点上报到指定的轨迹id上）
下面开始上代码：
第一步：开始轨迹服务(开始前要先查询是否存在终端id，如果有直接使用，没有则创建)
#pragma mark - Actions
//开始轨迹服务
-(void)startTrackServer{
//开始服务
AMapTrackManagerServiceOption *serviceOption = [[AMapTrackManagerServiceOption alloc] init];
serviceOption.terminalID = self.termiID;
[self.trackManager startServiceWithOptions:serviceOption];
}
第二步：创建终端ID
1: 创建之前要先查询终端id是否存在，查询和创建都要使用服务端返回给你的服务id(serviceID), 再根据终端名称(我这里用的是userid来进行查询和创建），如果存在则不创建，直接通过终端id开启轨迹服务。
2：如果查询后终端id不存在，则要进行创建，创建成功后再开启轨迹服务
//创建终端ID
-(void)createTerminalID{
//Service ID 根据需要进行修改
AMapTrackManagerOptions *option = [[AMapTrackManagerOptions alloc] init];
option.serviceID = [UserModel getUserInfo].serverID;
//初始化AMapTrackManager
self.trackManager = [[AMapTrackManager alloc] initWithOptions:option];
//将定位信息采集周期设置为10s，上报周期设置为30s(这个根据实际需要自行设置)
[self.trackManager changeGatherAndPackTimeInterval:10 packTimeInterval:30];
self.trackManager.delegate = self;
//配置定位属性
[self.trackManager setAllowsBackgroundLocationUpdates:YES];
[self.trackManager setPausesLocationUpdatesAutomatically:NO];
//查询终端是否存在
AMapTrackQueryTerminalRequest *request = [[AMapTrackQueryTerminalRequest alloc] init];
request.serviceID = self.trackManager.serviceID;
request.terminalName = [UserModel getUserInfo].userId; //根据userID创建终端id
[self.trackManager AMapTrackQueryTerminal:request];
}
//查询终端结果
- (void)onQueryTerminalDone:(AMapTrackQueryTerminalRequest *)request response:(AMapTrackQueryTerminalResponse *)response
{
//查询成功
if ([[response terminals] count] > 0) {
//查询到结果，使用 Terminal ID
NSString *terminalID = [[[response terminals] firstObject] tid];
NSLog(@"terminalID == %@",terminalID);
self.termiID = terminalID;
//启动轨迹上报服务
[self startTrackServer];
}
else {
//查询结果为空，创建新的terminal
AMapTrackAddTerminalRequest *addRequest = [[AMapTrackAddTerminalRequest alloc] init];
addRequest.serviceID = self.trackManager.serviceID;
addRequest.terminalName = [UserModel getUserInfo].userId; //根据userID创建终端id;
[self.trackManager AMapTrackAddTerminal:addRequest];
}
}
//创建终端结果
- (void)onAddTerminalDone:(AMapTrackAddTerminalRequest *)request response:(AMapTrackAddTerminalResponse *)response {
//创建terminal成功
NSString *terminalID = [response terminalID];
NSLog(@"终端id == %@",terminalID);
self.termiID = terminalID;
//启动轨迹上报服务
[self startTrackServer];
}
- (void)onStartService:(AMapTrackErrorCode)errorCode {
if (errorCode == AMapTrackErrorOK) {
//开始服务成功
NSLog(@"开始轨迹服务成功");
//服务成功后，开始轨迹采集
[self startTrackGather];
} else {
//开始服务失败
NSLog(@"开始轨迹服务失败");
NSLog(@"onStartService:%ld", (long)errorCode);
}
}
第三步：轨迹上报服务成功后，创建轨迹id (因为后台要根据轨迹id查询具体人员的轨迹，所以要创建轨迹id)
//创建轨迹ID
- (void)doCreateTrackName {
if (self.trackManager == nil) {
return;
}
NSLog(@"创建轨迹ID");
AMapTrackAddTrackRequest *request = [[AMapTrackAddTrackRequest alloc] init];
request.serviceID = self.trackManager.serviceID;
request.terminalID = self.trackManager.terminalID;
[self.trackManager AMapTrackAddTrack:request];
}
//生成轨迹ID
- (void)onAddTrackDone:(AMapTrackAddTrackRequest *)request response:(AMapTrackAddTrackResponse *)response
{
NSLog(@"onAddTrackDone%@", response.formattedDescription);
if (response.code == AMapTrackErrorOK) {
//创建trackID成功，开始采集
self.trackManager.trackID = response.trackID;
NSLog(@"轨迹ID == %@",response.trackID);
//在巡检过程中杀死应用后，需要重启上报服务，但轨迹id被清空，不能继续开始轨迹采集，所以需要本地存储，巡检结束后删除
[KKUserDefault setObject:response.trackID forKey:@"trackID"];
[KKUserDefault synchronize];
//开始采集轨迹
[self.trackManager startGatherAndPack];
if (self.isUplodTrack) {
//上传轨迹
//这里轨迹已经开始采集成功，请求后台接口上传相关的数据
}
}else {
//创建trackID失败
NSLog(@"创建trackID失败");
}
}
第四步：生成轨迹id后，开始轨迹采集
//开始轨迹采集
-(void)startTrackGather{
if (![KKUserDefault objectForKey:@"trackID"]) {
//轨迹id不存在，创建轨迹id
[self doCreateTrackName];
}else{
//轨迹id已存在，直接开始采集
NSLog(@"轨迹id已存在，直接开始采集 == %@",[KKUserDefault objectForKey:@"trackID"]);
self.trackManager.trackID = [KKUserDefault objectForKey:@"trackID"];
[self.trackManager startGatherAndPack];
if (self.isUplodTrack) {
//上传轨迹
//这里轨迹已经开始采集成功，请求后台接口上传相关的数据
}
}
}
- (void)onStartGatherAndPack:(AMapTrackErrorCode)errorCode {
if (errorCode == AMapTrackErrorOK) {
//开始采集成功
NSLog(@"开始轨迹采集成功");
} else {
//开始采集失败
NSLog(@"开始轨迹采集失败");
NSLog(@"onStartGatherAndPack:%ld", (long)errorCode);
}
}
第五步：结束巡检后，关闭轨迹服务 （先关闭轨迹采集，再关闭服务）
-(void)stopTrackServer{
//关闭轨迹采集
[self.trackManager stopGaterAndPack];
//关闭轨迹服务
[self.trackManager stopService];
self.trackManager.delegate = nil;
self.trackManager = nil;
//删除轨迹id
[KKUserDefault removeObjectForKey:@"trackID"];
[KKUserDefault synchronize];
}
- (void)onStopService:(AMapTrackErrorCode)errorCode {
if (errorCode == AMapTrackErrorOK) {
NSLog(@"成功关闭轨迹服务");
}else{
NSLog(@"关闭轨迹服务错误");
}
}
注意：如果以上的有些代理方法未执行，查看是否设置了代理，而且目前代理方法只能在控制器中实现，在view中不走代理方法....
在上面已经提到，如果在开启服务过程中杀死应用后，服务也就挂了，所以app打开激活后，需要重启服务，重启服务用的轨迹id还是杀死应用之前的，否则同一条巡检会有多个轨迹id，这样就会出问题，这一点别忘记了....
以上就是猎鹰轨迹功能的所有步骤，注意所有的过程必须一步步进行，否则会导致各种错误，如果报错，检查报错的code，对应相关的报错信息查看错误。
如有问题请在下方留言讨论！！
网友评论