更新日志

2014年10月30日

Web服务API v1.0

新增功能

百度鹰眼轨迹Web服务API v1.0 上线

2015年10月16日

Web服务API v2.0

新增功能：

Web 服务 API v2.0发布

1. 提供被追踪人/物的增删改查、属性字段管理接口

2. 提供轨迹点上传接口、轨迹点属性字段管理接口

3. 提供地理围栏增删改查、被追踪者状态查询、围栏历史报警查询、暂停报警接口

4. 提供MTK SDK配置接口

删除功能：

删除鹰眼轨迹Web服务API的service接口，原V1.0的service接口也将逐步停止服务。Service相关的创建和管理操作集中在轨迹管理台上操作。

原Trace API V1.0将在2016年4月30日停止服务，请使用鹰眼轨迹的小伙伴们及时迁移至鹰眼轨迹Web服务API v2.0。迁移过程中有任何问题，可通过反馈平台联系我们 我们将全力保障小伙伴们顺利迁移。

2015年10月16日

Android SDK v2.0

新增功能：

Android SDK v2.0.0发布

1. 高精综合网络连续定位，实现精准实时轨迹追踪；

2. 支持实时位置和历史轨迹查询；

3. 推出地理围栏服务，实现当被追踪者进出设定地理区域时，云端自动推送报警；

2015年10月27日

Android SDK v2.0.1

新增功能：

完善对CPU架构的支持，目前已支持：

arm64-v8a

armeabi

armeabi-v7a

x86

x86_64

修复问题：

修复鹰眼服务重启失败的bug

2015年11月9日

轨迹管理台v2.0

新增功能：

1. 实时监控页面新增当日活跃人数实时统计

2. 实时监控页面新增当日活跃人员标记

3. 历史轨迹查询页面新增当日活跃时长标识

4. 历史轨迹查询页面新增轨迹活跃度统计

功能改进：

1. 全新视觉交互体验

2. 创建轨迹服务时无需输入ak

2015年11月12日

web服务API v2.1.0

新增功能：

1. 历史轨迹查询接口新增请求参数is_processed，控制是否返回纠偏后轨迹

2. 历史轨迹查询接口新增返回参数distance，即此段轨迹总里程

注意：轨迹纠偏功能包括去噪、抽稀、绑路三个步骤，当is_processed=1时，默认仅进行去噪和抽稀处理，并不作绑路处理。

2015年11月17日

轨迹管理台v2.1

新增功能：

鹰眼轨迹管理台『历史轨迹』页面，新增轨迹查询功能按钮，点击后能查看纠偏后轨迹。（注：系统仅对11月12日之后的轨迹数据进行纠偏处理）

2015年11月19日

Android SDK:v2.1.0

新增功能：

新增纠偏后历史轨迹查询接口：queryProcessedHistoryTrack()

功能改进：

减小so文件体积

修复问题：

1. 修复基站定位不准的bug；

2. 修复用户未退出就切换其他用户登陆时，轨迹数据存储未做相应切换的bug；

2015年11月26日

iOS SDK Beta v1.1

新增功能：

鹰眼轨迹iOS SDK Beta1.1全新推出：

1. 支持实时轨迹追踪；

2. 支持实时位置和历史轨迹查询；

3. 支持地理围栏服务，实现当被追踪者进出设定地理区域时，云端自动推送报警；

2015年12月11日

iOS SDK Beta v1.3

修复问题：

1. 修复停止追踪后关闭wifi时会异常的问题；

2. 修复与部分第三方库命名冲突的问题；

2015年12月17日

Android SDK:v2.1.1

新增功能：

新增实时定位接口，用于获取当前位置，其中：

查询接口：LBSTraceClient.queryRealtimeLoc()
回调接口：OnEntityListener. onReceiveLocation()
定位数据对象：TraceLocation

功能改进：

优化定位数据离线缓存策略，即使开启轨迹服务时未联网，SDK也将采集定位数据并缓存，待联网后再回传数据。

修复问题：

1. 修复当traceType=1时，用户登出后再登录时，SDK立即登出的bug

2. 修复SDK在某些机型上闪退的bug

2016年1月8日

Android SDK:v2.1.3

修复问题：

修复在断网时，轨迹上传顺序错乱问题

2016年1月8日

iOS SDK v2.0.0

修复问题：

修复在断网时，轨迹上传顺序错乱问题

2016年2月18日

iOS SDK v2.0.1

新增功能：

1. 支持在startTrace后动态调整采集周期和打包周期

2. 新增三个定位相关属性（距离阈值、定位精度、运动类型）

SDK已为这几个值设置了默认值的最优值，如果仍不满足需求，开发者可通过BTRACEAction类的setAttributeOfLocation方法中设置三个属性值，自定义触发定位的距离阈值、定位精度和被追踪者常用的运动类型，以合理控制耗电量和定位精度。

3. 新增onStartTrace方法的返回值

当已经开始轨迹服务后，如果中途有网络切换等导致的重新登录等情况，SDK会回调onStartTrace方法，返回状态码：10009，代表重新连接服务器成功。

修复问题：

1. 修复wifi切换时卡顿的BUG

2. 修复了已知的其他BUG，提升稳定性

2016年2月19日

Android SDK:v2.1.4

功能改进：

优化室内漂移问题

2016年3月10日

iOS SDK v2.0.2

功能改进：

1. 修复了反复开始追踪和停止追踪之后，CPU占用率飙升的问题，提升稳定性。

2016年3月11日

Android SDK:v2.1.5

新增功能：

增加设置定位模式接口：void SetLocationMode(LocationMode mode)，支持三种定位模式：

1. High_Accuracy：高精度模式（同时使用GPS、Wi-Fi、基站定位，优先返回最高精度的定位结果）

2. Device_Sensors：仅设备定位模式（仅使用GPS，不使用Wi-Fi、基站定位，这种模式下不支持室内定位）

3. Battery_Saving：低功耗模式（不使用GPS，仅使用Wi-Fi和基站定位）

2016年3月16日

Android SDK:v2.1.6

修复问题：

1. 修复在某些机型上，判断联网状态的bug

2016年3月16日

Web服务API v2.1.1

新增功能：

1.查询历史轨迹接口

新增sort_type请求参数，支持返回结果按loc_time升或降序排序。

2016年3月23日

Android SDK:v2.1.7

功能改进：

1. 定位频率和打包周期由之前的1分钟延长至5分钟，适应更多应用场景，更加节省电量和流量。

2016年3月23日

iOS SDK v2.0.3

升级适配：

1. 适配Xcode7.3

2. 适配iOS9.3

2016年4月14日

Web服务API v2.1.2

新增功能：

查询历史轨迹接口新增里程计算功能，结果仅返回里程。

使用方式，将请求参数的simple_return=2，则结果仅返回时间段内轨迹的里程，单位：米。

2016年5月3日

Android SDK:v2.1.9

新增功能：

增加queryFenceStatusByLocation方法，通过指定的经纬度查询被监控对象的状态。

功能优化：

创建围栏时，由之前的可同时监控5个对象，修改为仅可监控一个对象。

2016年5月3日

iOS SDK v2.0.5

修复问题：

1. 修复2.1.9版本轨迹上传的bug，请已使用2.1.9版本的开发者尽快更新为新版本。

2016年5月13日

Android SDK:v2.1.10

修复问题：

1. 修复2.1.9版本轨迹上传的bug，请已使用2.1.9版本的开发者尽快更新为新版本。

2016年5月24日

iOS鹰眼SDK 升级预告

公告：

自6月1日起，所有提交至苹果AppStore的应用必须支持IPv6-only网络。iOS鹰眼SDK产品 确认需要升级支持，目前正在加急开发测试。预计在6月1日前发布Beta版，

iOS鹰眼SDK升级时间预计在：（任何调整都将在本帖及时更新） 6月1日提供beta版支持IPv6，仅供集成测试，不可做发版使用

6月7日提供正式版，直接替换beta版本即可。

2016年6月6日

Android SDK:v2.1.11

修复问题：

修复在starttrace前setInterval方法不生效的bug

2016年6月12日

地理围栏升级公告

公告：

为提升服务性能，鹰眼的地理围栏服务将于2016年6月14日进行升级，涉及到部分接口变动，请受影响的小伙伴们务必在此之前完成调整，避免影响到线上业务。升级过程中遇到任何问题，可通过反馈平台联系我们。

1、调整围栏可监控对象的数目

升级前：1个围栏可监控5个监控对象（monitored_persons ）

升级后：1个围栏仅可监控1个监控对象（但已存在的监控了多个对象的围栏，仍可监控多个对象，不受影响，且可通过update接口更新监控对象；已存在的围栏若只监控了一个对象，将不可更新为监控多个对象）

受影响接口：创建围栏（create）、更新围栏（update）

2、停止围栏延迟报警接口服务（delayalarm）

停止该接口后，若开发者发起请求，将返回错误信息。

以上变动涉及鹰眼Web服务API v2.0、鹰眼Android SDK v2.0及以上版本和鹰眼iOS SDK v2.0及以上版本。

非常抱歉本次调整可能会对您带来不便，我们将继续努力，为开发者提供更好的轨迹管理服务。

2016年6月24日

iOS SDK v2.0.8

新增功能：

支持IPv6-only网络

修复问题：

1. 修复网络频繁切换时卡顿的BUG

2. 修复使用私有API导致上架审核失败的问题

2016-07-06

Web服务API v2.1.3

新增功能：

历史轨迹查询接口新增process_option参数，开发者可自行开启或关闭各纠偏选项，目前支持的选项有：去噪、抽稀、绑路。

需要使用绑路的开发者无需再发邮件开通绑路，可自行在此接口中设置

2016-07-13

Anrdoid SDK v2.1.12

新增功能：

历史轨迹查询接口新增processOption参数，开发者可自行开启或关闭各纠偏选项，调整纠偏效果。

目前支持的选项有：去噪、抽稀、绑路。

需要使用绑路的开发者无需再发邮件开通绑路，可自行在此接口中设置。

功能改进：

开启轨迹追踪时遇到断网，不论是否收到网络广播，SDK都将定时与服务器重新建立连接。

修复问题：

1. 修复轨迹点未严格按定位时间上传的bug

2. 修复查询service是否存活时出现误判的bug

2016-07-22

Web服务API v2.1.4

新增功能：

针对车辆管理用户对车辆超速、急加速等异常驾驶行为的监控需求，以及对车辆停止状态的监控需求，鹰眼Web服务API新增：

1. 停留点分析接口：查询entity在指定时间段内的停留点

2. 轨迹分析接口：查询entity在指定时间段内的驾驶行为，驾驶行为包括：

- 总体信息：起终点信息、里程、耗时、平均速度、最高速度

- 异常信息：超速、急加速、急刹车、急转弯

接口说明请见：http://lbsyun.baidu.com/index.php?title=yingyan/api/analysis

2016-07-29

Web服务API v2.1.5

新增功能：

1. 新增多边形围栏功能，支持创建、更新、查询多边形围栏

围栏创建、更新和查询接口中增加多边形围栏参数

详见fence/create，fence/update，fence/list接口文档

2. 新增围栏去噪功能，当轨迹点定位误差半径大于设定值时，将不进行围栏计算

创建和更新围栏接口新增precision参数，当轨迹点定位的误差半径（radius）大于precision时，将被认为是噪点，不进行围栏计算。

详见fence/create，fence/update，fence/list接口文档

3. 新增里程补充功能

里程计算时，两个轨迹点定位时间间隔5分钟以上，被认为是中断。gethistory接口新增supplement_mode参数，控制中断轨迹的里程估算方式。

目前提供五种模式：

no_supplement：不补充，中断两点间距离不记入里程。

straight：使用直线距离补充

driving：使用最短驾车路线距离补充

riding：使用最短骑行路线距离补充

walking：使用最短步行路线距离补充

默认值为：no_supplement，不补充

详见gethistory接口文档

2016年8月1日

Android SDK v2.1.14

新增功能：

1. 新增多边形围栏功能，支持创建、更新、查询多边形围栏

围栏创建、更新和查询接口中增加多边形围栏参数

2. 新增围栏去噪功能，当轨迹点定位误差半径大于设定值时，将不进行围栏计算

创建和更新围栏接口新增precision参数，当轨迹点定位的误差半径（radius）大于precision时，将被认为是噪点，不进行围栏计算。

3. 新增里程计算接口queryDistance( )，专用于查询一段时间内轨迹的里程。

4. 新增里程补充功能

老版本在计算轨迹里程时，对于轨迹中断5分钟以上的区间，不计算里程。新版本中对这种处理方式进行了改进，在里程计算接口queryDistance( )中新增了supplement_mode参数，设置里程补充方式，目前提供五种方式：

no_supplement：不补充，中断两点间距离不记入里程。

straight：使用直线距离补充

driving：使用最短驾车路线距离补充

riding：使用最短骑行路线距离补充

walking：使用最短步行路线距离补充

默认值为：no_supplement，不补充

删除功能：

1. 删除延迟围栏报警接口

2016年8月10日

iOS SDK v2.1.12

新增功能：

1. 重载getTrackHistory方法，增加了processOption和supplementMode参数，用于在查询历史轨迹的时候，指定纠偏选项和里程补偿方式。

2. 新增queryDistance方法，用于查询里程数据

3. 新增createVertexesFence方法，用于创建多边形围栏

4. createCircularFence方法中，增加precision参数，用于指定触发围栏报警的轨迹点的精度，当采集到的轨迹点的定位精度大于此值的时候，该定位点不用于围栏报警的触发

修复问题：

1. 修复复杂网络环境下，轨迹采集中断的问题

2. 修复一些会导致crash的BUG

2016年9月22日

Android SDK v2.1.15

新增功能：

1. 新增本地围栏相关接口。离线围栏区别于服务端围栏，是两套独立的围栏体系。本地围栏只能在SDK创建，围栏判断也在SDK中完成，当SDK能够获取到GPS信号时，即使手机处于断网状态，本地围栏也能进行围栏计算与报警。

2. 新增本地围栏报警推送标识：0x04，消息格式与服务端围栏报警保持一致

3. 新增gps状态广播（action为【com.baidu.trace.action.GPS_STATUS】）开发者可通过该功能实时获取GPS状态。

状态信息获取方式：

int statusCode = intent.getIntExtra("statusCode", 0);

String statusMessage = intent.getStringExtra("statusMessage");

状态码和状态消息对应如下：

statusCode     statusMessage

      0            已通过GPS定位

      1            正在搜索GPS

      2            已关闭GPS

      3            未授予GPS定位所需权限

功能优化：

1. 优化数据上传，当有缓存数据时，加快上传。

2. 增加新权限，用于提升GPS首次定位速度

<uses-permission android:name="android.permission.ACCESS_LOCATION_EXTRA_COMMANDS" />

2016年10月12日

轨迹纠偏升级

新增功能：

进行轨迹纠偏时，支持驾车、骑行、步行三种绑路方式

通过在web 服务 API、Android SDK、iOS SDK 的历史轨迹查询接口中的 process_option 参数中设置 transport_mode 来控制交通方式。

具体说明请见：track/gethistory接口说明文档

2016年10月21日

轨迹管理台 v3.0

新增功能：

1. UI改版：采用标准地图更符合操作人员实际视觉需求；

2. 功能升级：增加开发者强烈需求的模糊搜索、在线/离线列表、超速/停留点分析、轨迹纠偏配置、轨迹回放速度控制等功能

3. 支持鹰眼硬件联盟：增加鹰眼硬件联盟设备注册与管理功能

2016年10月27日

iOS SDK v2.2.3

新增功能：

1. 新增客户端地理围栏（目前仅支持圆形）

2. 轨迹的查询，服务端围栏等所有使用HTTP协议的操作升级为HTTPS

【说明】 本版本的SDK需要使用Xcode8编译。Swift工程使用本SDK时，需要将Build Settings中的Use Legacy Swift Language Version设置为Yes，否则无法编译通过。因为Xcode8同时支持Swift2.3和Swift3.0两个版本，本SDK目前仅支持Swift2.3版本，所以需要设置此选项。

从 v2.2.3版本开始，iOS SDK只支持真机环境，不支持模拟器。

修复问题：

1. 较长时间断网缓存了大量轨迹数据后，网络恢复时会加速上传缓存数据，而不依赖于打包周期。待缓存数据上传完毕后，再根据打包周期进行上传。

2. Swift语言调用SDK时，不再需要自己编写module.map文件，直接导入即可使用

2016年10月27日

轨迹纠偏升级

新增功能：

1. 轨迹点新增_supplement 字段，用于区分绑路补充点和原始点

2. 新增计算收费里程功能：当开启绑路功能，且交通方式为驾车时，查询历史轨迹和里程时，将返回收费里程字段（toll_distance），开发者可用于高速路费的估算

功能优化：

1. 优化了原地不动轨迹纠偏效果：漂移轨迹将被聚类至中心点

2. 完善绑路补点功能：弯道和交叉路口补点更加贴合真实道路

2016年12月9日

Web服务API v3.0

新增功能：

v3.0接口采用全新域名：http://yingyan.baidu.com/api/v3， 兼容 v2.0所有数据。

目前正在陆续发布接口，已发布的接口如下：

1. 新增 entity 搜索类接口，包括：

- 关键字搜索：支持 entity_name+entity_desc 联合模糊搜索entity

- 矩形区域搜索：支持在矩形地理范围内搜索 entity

- 周边搜索：根据圆心和半径搜索 entity

以上接口均支持输出百度经纬度坐标和国测局坐标。

2. 新增 entity 管理和 entity 属性字段管理接口。

2016年12月16日

iOS SDK v2.2.6

新增功能：

1. 提供了开发版（支持真机和模拟器）和上架版（仅支持真机）两个版本的 SDK

2. 提供了 Swift 和 Object C 两种语言的 demo

修复问题：

1. 修复上传自定义字段时值为中文时崩溃的BUG

   2.修复创建多边形地理围栏时参数错误的问题

2017年2月22日

Android SDK:v2.1.16

修复问题：

1. 修复在华为 Android 7.0机型上，获取GPS数据时异常问题

2. 修复so文件在某些机型加载失败问题

2017年3月3日

轨迹管理台 v3.1.0

新增功能：

1. service 管理页面改版，增加 service "设置" 选项，包括以下功能：

- 可视化管理entity 和 track自定义字段功能；

- 管理台授权功能，可将自有 service 授权给其他百度帐号查看；可查看授权给自己的service 列表和数据；

- 配置轨迹监控列表所显示的字段功能，支持配置为显示 entity_desc字段；

- 新增配置鹰眼硬件终端定位和上传频率功能

2. 轨迹监控功能升级：增加按时间段显示轨迹功能，拖动播放条的卡尺可隐藏时间区间外的轨迹，减少视觉干扰

2017年3月8日

Web服务API v3.1.0

新增功能：

除地理围栏类接口外，v3.0接口已正式发布，覆盖原 v2.0接口功能并新增：

1. 实时位置纠偏接口： track/getlatestpoint

2. 里程查询接口：track/getdistance

3. 原 track/gethistory接口更名为：track/gettrack

功能优化：

1. 支持海外轨迹追踪和查询

2. 所有接口支持返回百度和国测局坐标，海外轨迹返回 wgs84坐标

3. 批量上传轨迹接口，支持上传 JSON 格式的坐标数据

4. 停留点分析接口，支持自定义停留时间

5. 驾驶行为分析接口，支持自定义限速值

2017年3月14日

轨迹管理台 v3.1.1

新增功能：

1. 轨迹查看页面，支持查看每个轨迹点信息功能

2. 轨迹点详细信息，支持展示海外区域地址信息

2017年3月23日

Web服务 API v3.1.1

新增功能：

1. 新增线型围栏，支持路线偏移报警

2. 新增批量围栏报警查询接口，用于服务端实时同步报警信息

3. 接口说明参见：地理围栏管理和地理围栏报警接口文档

2017年3月28日

轨迹管理台 v3.1.1

新增功能：

entity 搜索类接口新增 sortby 参数，支持支持搜索结果按 entity_name、entity_desc、loc_time、以及 entity自定义检索字段升序或降序排列，详见接口文档

2017年4月11日

鹰眼物流车辆监控解决方案

新增功能：

为帮助行业开发者更好的了解并利用鹰眼服务，为自身业务带来提升，鹰眼将陆续推出各行业解决方案，本次发布的物流车辆监控方案针对以下五个场景提供了方案：

场景一：车辆位置实时追踪

场景二：运输时效性考核

场景三：路线偏移报警

场景四：异常事件上报

场景五：里程和收费里程计算

详见物流车辆监控方案

2017年4月18日

Android SDK v3.0.1

新增功能：

1. 新增线型围栏、行政区划围栏

2. 新增图片对象数据上传、获取、查询接口

3. 新增轨迹分析接口

4. 新增实时位置查询接口

5. 新增设备管理接口

6. 新增缓存轨迹查询、删除接口，缓存轨迹区分entityName

7. API请求增加请求标识，用于唯一区分每个请求，支持并行调用

功能优化：

1. 拆分服务控制接口：

startTrace()负责初始化服务及与服务端建立长连接；

stopTrace()负责停止服务并断开长连接；

startGather()负责开启采集；

stopGather()负责停止采集。

2. 调整轨迹客户端LBSTraceClient中所有对外接口，接口参数均采用对象传入

2017年4月20日

Web服务API v3.1.2

新增功能：

地理围栏新增：行政区划围栏，支持输入行政区关键字创建围栏，目前支持中国区域（含港澳台），支持中国国家、省、市、区/县名称输入。详见行政区围栏接口文档。

2017年5月17日

Android SDK v3.0.2

新增功能：

1. 增加添加单个轨迹点和批量添加轨迹点api接口:

LBSTraceClient.addPoint()

LBSTraceClient.addPoints()

2. Entity搜索接口增加排序方法（com.baidu.trace.api.Entity.SortBy）、AroundSearchRequest、BoundSearchRequest、SearchRequest。调整排序类型SortType，由com.baidu.trace.api.track.SoryType调整为com.baidu.trace.model.SortType；

3. 新增前台广播接口（Trace.setNotification()）,在 startTrace()前调用该接口可将鹰眼服务由后台转成前台，有助于保持鹰眼服务的存活并提升系统定位的更新频率。注意设置Notification的图标时，图标不要过大，具体可以参考demo中图片大小，图标过大时会导致服务开启失败。谷歌关于该功能的说明请见：后台位置限制

4. 新增缓存空间大小限制接口（LBSTraceClient.setCacheSize()），用于控制鹰眼在离线缓存时占用系统内存的最大值，避免因鹰眼持续缓存导致系统内存被占满。设置该值后，则一旦鹰眼缓存达到设定值，鹰眼将删除本地缓存的旧数据，保证新数据的存储。若不设置该值，则鹰眼将持续缓存轨迹，若系统内存被占满，则新的轨迹数据将无法写入。但即便出现长时间断网，鹰眼SDK缓存数据所占用的空间仍然很小，若无特殊限制要求，无须调用该接口。

5. 实时定位结果TraceLocation中增加定位类型（com.baidu.trace.model.LocType）,用以标识每次定位结果是通过网络还是GPS进行定位

功能优化：

1. 开启服务监听器（OnTraceListener），增加bindService()回调接口OnBindServiceCallback()，用于通告鹰眼服务是否已成功运行。开发者需在收到OnBindServiceCallback()回调成功后才可调用开启采集 startGather() 或停止采集stopGather()等操作，否则会返回【服务未开启】

2. 优化删除缓存数据接口，支持删除entity指定时间段内的缓存轨迹信息

2017年5月25日

iOS SDK v3.0.3

鹰眼 iOS SDK v3.0全新发布

新增功能：

1. 缓存轨迹区分entityName，且支持缓存信息的查询和删除

2. 新增实时纠偏接口

3. 新增关键字模糊查询 entity

4. 实时位置搜索新增周边搜索、矩形范围搜索接口

5. 新增里程计算接口，支持计算纠偏和里程补偿后的里程

6. 新增批量上传轨迹点接口

7. 新增服务端线型围栏和行政区围栏

8. 新增轨迹分析接口

9. API请求中增加tag字段，用于在响应回调中区分每个请求

修复问题：

1. 修复使用Xcode8.3以及Swift3导入SDK时编译失败的问题

2. 修复网络切换时服务运行异常的问题

3. 提升了服务运行稳定性

功能优化：

1. 对外的API接口由BTRACEAction一个，按照功能拆分为轨迹追踪、终端实体、轨迹、围栏、分析5个部分。分别通过BTKAction, BTKEntityAction, BTKTrackAction, BTKFenceAction, BTKAnalysisAction这5个类中的接口发起请求，通过BTKTraceDelegate, BTKEntityDelegate, BTKTrackDelegate, BTKFenceDelegate, BTKAnalysisDelegate这5个协议中的方法将响应回调给调用者

2. 取消BTRACE类，服务运行需要的基础参数由BTKAction中的initInfo方法设置

3. 服务控制与采集控制接口分离，分别由startService,stopService,startGather,stopGather这四个接口控制

4. 所有接口的输入参数改为对象类型

2017年6月5日

鹰眼Web API v3.0.3

新增功能：

1. 新增多边形搜索接口，支持搜索任意多边形范围内的 entity

2. 轨迹纠偏效果优化，噪点识别率提升

3. 轨迹分析接口支持自定义急加速、急减速和急转弯阈值，开发者可根据自有业务对危险驾驶行为的定义设定阈值

2017年6月9日

Android SDK:v3.0.3

修复问题：

1. 修复与全景sdk冲突问题

2. 修复某些情况下，启动服务时因数据库异常导致crash问题

3. 修复其他已知bug

2017年6月30日

Android SDK v3.0.4

新增功能：

1. 实时位置搜索接口增加多边形搜索、行政区搜索。

2. 轨迹分析-驾驶行为接口增加急加速、急减速、急转弯阈值参数

修复问题：

1. 修复鉴权失败bug。

2. 修复多线程操作本地围栏时的同步问题

3. 修复多线程操作数据库时，数据库锁定问题

4. 修复其他已知bug

2017年6月30日

iOS SDK:v3.0.4

新增功能：

1. BTKEntityAction中增加行政区域检索和多边形检索终端的接口。

2. BTKAnalysisAction中行为分析接口增加了BTKDrivingBehaviorThresholdOption类型的属性用于设置自定义的分析阈值。

修复问题：

1. 内存泄漏

2. 修改注释使其更准确

2017年7月18日

鹰眼Web API v3.0.4

新增功能：

1. 升级地理围栏接口，支持一个围栏可监控某个service下的所有entity，并对围栏进行更新、删除、查询；升级querystatus接口，支持根据entity在围栏内部或外部进行查询

2017年8月8日

鹰眼Web API v3.0.5

新增功能：

1. 新增"批量导出轨迹"类接口，支持开发者批量下载历史轨迹数据。

2017年9月1日

鹰眼Web轨迹管理台 v3.1.2

新增功能：

1. 新增轨迹管理台"使用手册"和"源码下载"引导

2. 新增从实时位置信息面板直接跳转至查询最新轨迹页面功能

3. 新增设置服务端围栏报警推送地址URL功能

2017年9月12日

iOS SDK v3.0.5

新增功能：

1. 适配iOS11

2. 修复SDK的内存泄漏

3. 修复DEMO中的若干BUG

为了适配iOS11，在APP的info.plist文件中除了NSLocationAlwaysUsageDescription 字段，还需要配置上NSLocationAlwaysAndWhenInUseUsageDescription 和 NSLocationWhenInUseUsageDescription 字段

2017年9月22日

Android SDK:v3.0.5

新增功能：

1. 轨迹自定义属性接口增加定位时间参数，单位为毫秒。该参数为当前轨迹点的定位时间 Map<String, String> onTrackAttributeCallback(long locTime)

2. 为应对设备时间不准导致轨迹点定位时间不准问题，鹰眼SDK引入了使用GPS时间校正定位时间的机制，并新增了设置时间校准阈值接口：setLocTimeOffset()。当开发者设置了时间校准阈值后，鹰眼SDK在每次采集轨迹点时若获取到GPS定位，则计算GPS时间与设备时间之差，若差值小于或等于时间校准阈值，则采用设备时间为轨迹点的定位时间；若大于时间校准阈值则采用GPS时间为轨迹点的定位时间。

3. 增加初始化线程池配置接口：initThreadPoolConfig()，开发者可设置最大线程数和核心线程数

功能优化：

1. 调整定位采集最高频率由原来的2s改为1s

修复问题：

1. 修复轨迹追踪服务自动重启时，未按照之前设置的采集、打包周期进行轮询的问题

2. 修复LBSTraceClient与LBSTraceService不在同一进程时，因LBSTraceClient被回收，导致再次绑定时，对象存储服务未初始化问题

3. 修复LBSTraceClient清除内存时，偶现空指针问题

4. 优化实时定位权限检查逻辑，解决在某些情况下crash的问题

5. 修复某些情况下，bos重复初始化问题

6. 修复其他已知bug

2017年10月23日

iOS SDK v3.0.6

修复问题：

1. 修复采集周期和打包周期持久化失败的BUG，设置完采集和打包周期之后，下次开启服务或开始采集时，将使用之前设置的值，而不再使用默认值

2. 修复从非主线程调用 -(void)changeGatherAndPackIntervals:(NSUInteger)gatherInterval packInterval:(NSUInteger)packInterval delegate:(id )delegate; 方法时，采集和打包周期不生效的BUG

3. 修复某些复杂使用场景下，无法停止采集的BUG

2017年10月23日

Android SDK:v3.0.6

修复问题：

1. 修复某些场景下，本地围栏根据位置信息查询状态失败的问题

2. 修复某些场景下，空指针异常错误

2017年11月28日

Android SDK:v3.0.7

功能优化：

1. 优化鹰眼SDK在华为等机器上的GPS数据获取方案，减少流量损耗，降低功耗；

2. 升级BOS服务，优化BOS服务造成的鉴权错误；

2018年2月1日

鹰眼Web API v3.0.6

新增功能：

1. 升级地理围栏接口，支持一个围栏可监控某个service下的部分entity；服务从功能上区分为两类接口：管理围栏属性、管理围栏监控对象。

2. 新增管理围栏监控对象接口，支持开发者通过该套接口管理围栏的监控对象。包括：1）添加监控对象；2）删除监控对象；3）查询监控对象。

2018年3月20日

鹰眼Web API v3.0.7

新增功能：

1. 新增交通方式智能识别功能
   当开发者不明确用户的交通方式（步行、骑行、驾车、停留）时，鹰眼将使用依据轨迹大数据建立的判断模型，自动识别并返回每一个轨迹点的交通方式。
   具体使用方法为：在track/getlatestpoint、track/gettrack这两个接口中设置请求字段process_option中的transport_mode=auto，则鹰眼将开启交通方式自动识别，并在每个轨迹点的返回字段transport_mode中返回识别结果。
   注：该功能为鹰眼增值服务，若需试用可通过反馈平台联系我们开通。

   2.新增智能纠偏功能

当开发者不明确用户的交通方式（步行、骑行、驾车、停留）时，鹰眼将使用依据轨迹大数据建立的判断模型，自动识别轨迹的交通方式，从而调整相应的纠偏模型和参数，提升轨迹纠偏和里程计算精准度。
具体使用方法为，在track/getlatestpoint、track/getdistance、track/gettrack这三个接口中设置请求字段process_option中的transport_mode=auto，则鹰眼将开启交通方式自动识别，实现自适应纠偏。

3. 新增定位模式智能识别功能

当开发者使用track/getlatestpoint、track/gettrack这两个接口时，鹰眼将自动识别轨迹点的定位模式，并将识别结果通过locate_mode（定位模式）字段返回。
定位模式包括：未知、GPS/北斗定位、网络定位、基站定位。

4. 新增road_grade道路等级字段

当开发者使用track/getlatestpoint、track/gettrack这两个接口时，当纠偏绑路成功时将返回轨迹点对应的道路等级。
道路等级包括：高速路、都市高速路、国道、省道、县道、乡镇道路、其他道路、九级路、轮渡、行人道路。
注：该功能为鹰眼增值服务，若需试用可通过反馈平台联系我们开通。

2018年9月10日

鹰眼Web API v3.0.8

新增功能：

里程计算和轨迹查询接口新增低速里程计算功能，可应用于网约车行业计算低速里程费用场景。使用方法为，当is_processed=1时，设置low_speed_threshold请求参数自定义低速阈值，则返回参数low_speed_distance中将返回速度低于该阈值的里程。

2019年1月2日

Android SDK:v3.0.8

新增功能：

1. 新增缓存轨迹距离查询功能：

在网络异常场景下，可以通过SDK端查询缓存轨迹的里程。 QueryCacheTrackRequest.java中增加缓存里程查询控制参数isQueryCacheDistance；

QueryCacheTrackRequest.java中增加GPS点去噪阈值参数radiusThreshold

QueryCacheTrackRequest.java中增加缓存轨迹里程查询沟通函数： public QueryCacheTrackRequest(int tag, long serviceId, String entityName, boolean isQueryCacheDistance, short radiusThreshold)；

查询结果CacheTrackInfo.java中增加cacheDistance参数标识缓存里程。

详细请参见类参考。

功能优化：

1. 升级鉴权逻辑，提高鉴权效率，解决偶现鉴权异常；

2. 升级Demo中地图SDK版本，提升展示效果；

3. Demo适配全屏手机；

修复问题：

1. 修复空指针异常等问题；

2019年1月2日

iOS SDK:v3.0.7

新增功能：

1. 支持bitcode，官网下载的framework默认是开启了bitcode的，如果您不希望使用bitcode，可以通过命令自行剥离。例如：xcrun bitcode_strip -r BaiduTraceSDK -o BaiduTraceSDK

2. 支持查询SDK缓存轨迹点的里程，通过BTKQueryTrackCacheInfoRequest类中，新增的needDistance和distanceFilter属性，查询到的缓存信息中将增加distance字段代表里程信息。

3. BTKTraceDelegate中新增onGetCustomDataResult回调，通知开发者onGetCustomData回调的执行结果。

修复问题：

1. 修复了customData过大时，轨迹无法上传，导致CPU使用率飙升crash的问题。开发者在onGetCustomData中指定的当前时刻的自定义字段总长度不得超过1024字节，并且key要求为NSString类型，value要求为NSString或NSNumber类型

2. 修复部分场景下的内存泄露

3. 更新了Demo中地图SDK的版本

4. 其他若干BUG修复

2019年3月29日

鹰眼Web API v3.0.9

新增功能：

1. 新增“道路名称”高级功能，轨迹查询track/gettrack接口返回字段新增“road_name“高级字段，支持返回轨迹对应的道路名称。

2019年4月12日

鹰眼Web API v3.1.0

功能优化：

1. 鹰眼公共围栏性能升级，单service公共围栏数量上限由原1000个升级为10万个，满足大部分用户管理全国运营区和网点需求，极大提升公共围栏适用性和易用性。
   注意：1000个以上的公共围栏为高级付费服务，需通过反馈平台联系工作人员使用

2. 为配合公共围栏支持数量升级，fence/list、fence/querystatus、fence/querystatusbylocation三个接口请求字段新增page_size和page_index字段，满足列出超过1000个围栏需求。

2019年5月10日

鹰眼Android SDK v3.1.0

修改：

1. 自V3.1.0版本开始，SDK上传轨迹数据开始计算PV（即：日配额），之前版本不受影响，详见鹰眼权限和配额说明。

新增功能：

1. 缓存轨迹点信息查询新增查询指定时间段的缓存轨迹里程功能。接口调整如下：距离查询接口的CacheTrackInfo增加指定起止时间字段。

2. 轨迹查询与纠偏接口支持智能交通方式识别功能，支持对综合交通出行轨迹的智能纠偏（功能说明请点击）。接口调整如下：TransportMode增加自动识别字段Auto。

3. 轨迹查询与里程查询接口支持查询低速里程，即查询速度低于设定阈值的轨迹里程，可应用于网约车精细化计费。接口调整如下：请求参数新增低速里程阈值lowSpeedThreshold字段，返回参数新增低速里程lowSpeedDistance。

4. 公共地理围栏性能提升，支持创建公共围栏个数从1000升级至10万（功能说明请点击）。接口调整如下：新增服务端地理围栏添加(AddMonitoredPersonRequest/Response)、删除(DeleteMonitoredPersonRequest/Response)、查询(ListMonitoredPersonRequest/Response)监控对象等功能。围栏查询接口增加pageIndex和pageSize字段，支持分页检索。

功能优化：

1. 优化轨迹查询和轨迹上传性能。

2. 优化内存管理。

修复问题：

1. 修复当前GPS定位点为网络类型的错误。

2. 修复其它已知问题。

2019年5月10日

鹰眼iOS SDK v3.1.0

修改：

1. 自V3.1.0版本开始，SDK上传轨迹数据开始计算PV（即：日配额），之前版本不受影响，详见鹰眼权限和配额说明。

新增功能：

1.新增查询指定时间段缓存轨迹里程功能：BTKQueryTrackCacheInfoRequest中新增startTime和endTime，支持查询指定时间段内的缓存轨迹和里程。

2.公共地理围栏性能提升，支持创建公共围栏个数从1000升级至10万（功能说明请点击）。接口调整如下：新增BTKAddMonitoredObjectRequest，BTKDeleteMonitoredObjectRequest，BTKListMonitoredObjectRequest三个请求类，支持给服务端地理围栏添加、删除、查询监控对象。BTKQueryServerFenceStatusRequest，BTKQueryServerFenceStatusByCustomLocationRequest，BTKQueryServerFenceRequest请求类中，新增page_index和page_size字段，支持分页检索。

3.轨迹查询与纠偏接口支持智能交通方式识别功能，支持对综合交通出行轨迹的智能纠偏（功能说明请点击）。接口调整如下：交通方式选项BTKTrackProcessOptionTransportMode中新增自动方式，由鹰眼自动识别交通方式。

4.轨迹查询与里程查询接口支持查询低速里程，即查询速度低于设定阈值的轨迹里程，可应用于网约车精细化计费。接口调整如下：接口BTKQueryTrackDistanceRequest，BTKQueryHistoryTrackRequest请求类中，新增lowSpeedThreshold字段，支持筛选出低速里程。

2019年7月26日

鹰眼Web API v3.0.10

功能调整：

实时纠偏和轨迹查询接口道路属性高级字段控制方式调整：

1. 实时纠偏接口：
   请求字段：新增extensions，控制是否返回道路属性高级字段。
   返回字段：删除原道路限速limit_speed，由point结构体中新增的car_limit_speed小客车道路限速字段替代。

2. 轨迹查询接口：
   请求字段：新增extensions，控制是否返回道路属性高级字段。
   返回字段：新增car_limit_speed小客车道路限速。

2019年8月26日

鹰眼Web API v3.0.11

新增功能：

轨迹查询接口新增针对长距离中断区间补偿轨迹点的策略：请求字段新增supplement_content控制仅补偿里程还是同时补偿轨迹点，返回字段_supplement新增补偿轨迹点的标示。

2020年3月2日

鹰眼Web API v3.0.12

功能优化：

地理围栏性能升级，支持更大面积、更多形状点：

1. 多边形地理围栏的围栏面积由原来100平方公里升级至1000平方公里，可覆盖如"北京五环"这样的大地理范围。

2. 线型地理围栏 的路线形状点个数由最多100个升级至500个，支持更精准绘制线型围栏。

注：以上升级能力可通过反馈平台申请试用。

2020年04月27日

Android SDK:v3.1.6

优化：

定位成功率和准确率优化：支持5G等多种基站，支持双卡手机基站，提升手机端Wi-Fi刷新频率。

2020年05月14日

Android SDK:v3.1.7

优化：

修复使用网络定位模式且wifi环境较差的情况下，服务异常退出的问题。

2020年05月25日

鹰眼Web API v3.1.0

新增功能：

1. 鹰眼上线经验行为分析模块，一期支持经验路线分析。该功能支持根据终端过去一段时间（如一个月、2周）的历史轨迹，分析得出终端的常走路线，并给出路线的出行频率。该功能目前处于试运行阶段，欢迎开发者申请试用。

2. 鹰眼线型围栏进一步升级，对于围栏边界点过多的情况，鹰眼支持进行适度地自动抽稀，降低进入计算的围栏点数。通过该升级，在路线偏离监控场景中开发者可传入更多地路线边界点个数。接口详见鹰眼线型围栏接口文档

3. 鹰眼轨迹管理台新增实时位置页面新增“行政区聚合”和“热力图”功能，可视化查看车辆/人员的地理分布

2020年09月8日

鹰眼配额统计与展示升级

新增功能：

新增鹰眼SDK并发统计：自V3.1.0版本起，鹰眼SDK通过startgather方法上传的轨迹将统计小时级并发，开发者可在控制台->我的额度页面查看SDK实际上传并发用量。鹰眼为企业级认证用户提供30QPS免费SDK上传并发额度，为不影响轨迹上传，超出免费额度不限制访问，但系统将统计配额超出情况，开发者需对超出免费额度部分支付费用。

2021年1月12日

鹰眼Web服务API V3.1.1

新增功能：

1. 鹰眼上线货车ETC费用计算服务，目前支持货车ETC费用计算（含高速ETC和过桥费）。该功能支持根据行驶轨迹实时或事后进行ETC费用，可应用于物流行业对车辆运输费用的校验。该功能目前处于试运行阶段，欢迎开发者申请试用。

2. 鹰眼地理围栏升级，支持创建乡镇级别的地理围栏，详见fence/createdistrictfence接口。

3. 鹰眼地理围栏查询升级，支持通过fence/list接口查询已创建的监控所有entity或部分entity的公共围栏，详见fence/list接口