2015年10月16日

Android SDK v2.0

2015年10月27日

Android SDK:v2.0.1

2015年11月19日

Android SDK:v2.1.0

2015年12月17日

Android SDK:v2.1.1

2015年12月29日

Android SDK:v2.1.2

2016年1月8日

Android SDK:v2.1.3

2016年2月19日

Android SDK:v2.1.4

2016年3月11日

Android SDK:v2.1.5

2016年3月16日

Android SDK:v2.1.6

2016年3月23日

Android SDK:v2.1.7

2016年5月3日

Android SDK:v2.1.9

2016年5月13日

Android SDK:v2.1.10

2016年6月6日

Android SDK:v2.1.11

2016年7月13日

Android SDK v2.1.12

2016年8月1日

Android SDK v2.1.14

2016年9月22日

Android SDK v2.1.15

2017年2月22日

Android SDK:v2.1.16

2017年4月18日

Android SDK v3.0.1

2017年5月17日

Android SDK v3.0.2

2017年6月9日

Android SDK:v3.0.3

2017年6月30日

Android SDK:v3.0.4

2017年9月22日

Android SDK:v3.0.5

2017年10月23日

Android SDK:v3.0.6

2017年11月28日

Android SDK:v3.0.7

2019年1月2日

Android SDK:v3.0.8

2019年5月10日

Android SDK:v3.1.0

2019年07月05日

Android SDK:v3.1.1

2019年08月09日

Android SDK:v3.1.2

2019年10月25日

Android SDK:v3.1.3

2019年11月21日

Android SDK:v3.1.4

2019年12月25日

Android SDK:v3.1.5

2020年04月27日

Android SDK:v3.1.6

2020年05月14日

Android SDK:v3.1.7

2021年1月25日

Android SDK:v3.1.8

2021年08月25日

Android SDK:v3.1.9

2021年12月24日

Android SDK:v3.1.10

2022年4月01日

Android SDK:v3.1.11

2022年12月07日

Android SDK:v3.2.0

2023年02月24日

Android SDK:v3.2.1

新增功能：

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

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

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

新增功能：

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

arm64-v8a

armeabi

armeabi-v7a

x86

x86_64

修复问题：

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

新增功能：

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

功能改进：

减小so文件体积

修复问题：

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

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

新增功能：

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

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

功能改进：

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

修复问题：

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

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

修复问题：

修复实时定位接口已知 bug

修复问题：

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

功能改进：

优化室内漂移问题

新增功能：

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

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

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

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

功能改进：

1.兼容android 6.0

修复问题：

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

功能改进：

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

新增功能：

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

功能优化：

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

修复问题：

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

修复问题：

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

新增功能：

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

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

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

功能改进：

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

修复问题：

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

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

新增功能：

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

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


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

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


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


4. 新增里程补充功能

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

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

straight：使用直线距离补充

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

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

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

默认值为：no_supplement，不补充

删除功能：

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

新增功能：

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

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

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

状态信息获取方式：

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

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

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

statusCode     statusMessage

      0            已通过卫星定位

      1            正在搜索卫星

      2            已关闭卫星定位

      3            未授予卫星定位所需权限

功能优化：

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

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

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

修复问题：

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

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

新增功能：

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

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

3.新增轨迹分析接口

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

5. 新增设备管理接口

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

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

功能优化：

1. 拆分服务控制接口：

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

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

startGather()负责开启采集；

stopGather()负责停止采集。

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

新增功能：

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中图片大小，图标过大时会导致服务开启失败。谷歌关于该功能的说明请见：<a href="https://developer.android.google.cn/about/versions/oreo/background-location-limits" alt="https://developer.android.google.cn/about/versions/oreo/background-location-limits" title="https://developer.android.google.cn/about/versions/oreo/background-location-limits">后台位置限制</a> 和 <a href="https://developer.android.google.cn/about/versions/pie/android-9.0-changes-all" alt="https://developer.android.google.cn/about/versions/pie/android-9.0-changes-all" title="https://developer.android.google.cn/about/versions/pie/android-9.0-changes-all">Android O行为变更中关于后台执行限制的说明</a>

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

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

功能优化：

1. 启服务监听器（OnTraceListener），增加bindService()回调接口OnBindServiceCallback()，用于通告鹰眼服务是否已成功运行。开发者需在收到OnBindServiceCallback()回调成功后才可调用开启采集 startGather() 或停止采集stopGather()等操作，否则会返回【服务未开启】
2. 优化删除缓存数据接口，支持删除entity指定时间段内的缓存轨迹信息

修复问题：

1.修复同时收到多条服务端围栏报警推送时，解析异常的bug

修复问题：

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

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

3. 修复其他已知bug

新增功能：

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

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

修复问题：

1. 修复鉴权失败bug。

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

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

4. 修复其他已知bug

新增功能：

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

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

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

功能优化：

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

修复问题：

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

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

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

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

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

6. 修复其他已知bug

修复问题：

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

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

功能优化：

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

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

新增功能：

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

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

QueryCacheTrackRequest.java中增加卫星定位点去噪阈值参数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. 修复空指针异常等问题；

修改：

1. 自V3.1.0版本开始，SDK上传轨迹数据开始计算PV（即：日配额），之前版本不受影响，详见<a href="http://lbsyun.baidu.com/index.php?title=yingyan/guide/quota" alt="http://lbsyun.baidu.com/index.php?title=yingyan/guide/quota" title="http://lbsyun.baidu.com/index.php?title=yingyan/guide/quota">鹰眼权限和配额说明</a>。

新增功能：

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

2. 轨迹查询与纠偏接口支持智能交通方式识别功能，支持对综合交通出行轨迹的智能纠偏（功能说明请<a href="http://lbsyun.baidu.com/index.php?title=yingyan/guide/transportmode" alt="http://lbsyun.baidu.com/index.php?title=yingyan/guide/transportmode" title="http://lbsyun.baidu.com/index.php?title=yingyan/guide/transportmode">点击</a>）。接口调整如下：TransportMode增加自动识别字段Auto。

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

4. 公共地理围栏性能提升，支持创建公共围栏个数从1000升级至10万（功能说明请<a href="http://lbsyun.baidu.com/index.php?title=yingyan/guide/geo-fence" alt="http://lbsyun.baidu.com/index.php?title=yingyan/guide/geo-fence" title="http://lbsyun.baidu.com/index.php?title=yingyan/guide/geo-fence">点击</a>）。接口调整如下：新增服务端地理围栏添加(AddMonitoredPersonRequest/Response)、删除(DeleteMonitoredPersonRequest/Response)、查询(ListMonitoredPersonRequest/Response)监控对象等功能。围栏查询接口增加pageIndex和pageSize字段，支持分页检索。

功能优化：

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

2. 优化内存管理。

修复问题：

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

2. 修复其它已知问题。

修改

bug修复

修改

废弃设置SDK请求协议为Http/Https的接口，强制使用Https请求。

修复问题

修复已知的空指针及其他问题

更新内容：

该版本起全面适配Android Q。

Android O之后，使用前台服务，需要申请权限：
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />

Android Q之后，开启后台定位，需要申请权限：
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

修复问题：

1、修复queryRealTimeLoc接口查询实时位置时，有GPS信号的情况下依然返回定位类型为网络定位、影响配额统计的问题。
2、修复其他已知问题。

优化：

优化了实时定位接口的卫星定位状态问题。

修复问题：

1、修复注册多个卫星定位 LocationListener的问题。
2、修复entity_name为中文字符时查询不到轨迹的问题。

新增：

支持通过Gradle依赖方式集成鹰眼SDK。
e.g：在工程的build.gradle文件中增加如下依赖命令集成SDK：

 implementation 'com.baidu.lbs:trace:3.1.5'

修复问题：

1、修复某些Android低版本系统的不兼容问题。
2、修复其他已知问题。

优化：

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

优化：

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

新增：

1.轨迹查询接口对齐web api，新增对长距离终端区间补偿轨迹点的策略：请求字段新增设置supplementContent接口，控制仅
补偿里程还是同时补偿轨迹点。
2.返回结果新增supplement字段，用于标识结果中补偿了轨迹点。

修复问题：

修复已知问题

新增：

轨迹查询接口对齐web api.纠偏配置ProcessOption新增设置去燥力度(setDenoiseStrength)、抽稀力度(setVacuateStrength)接口。

修复问题：

1.修复查询缓存里程错误问题。
2.修复其他已知问题。

修复问题：

1.优化内部逻辑；
2.修复其他已知问题。

新增：

为了进一步加强对最终用户个人信息的安全保护措施，增加了隐私合规接口setAgreePrivacy。

更新：

1.鹰眼SDK升级数据协议4.0。
2.修复上传位置点和数据不匹配问题。
3.增加轨迹上传回调接口onTraceDataUploadCallBack；

更新：

1.优化内部逻辑修复已知crash问题。