浅谈Android集成百度鹰眼服务

鹰眼轨迹是百度开放平台最新推出的一套高性能轨迹存储和查询服务。上个月在二手房媒体平台项目里集成了这一服务，所以今天结合百度开发文档来跟大家分享一下具体的流程。

首先来看一下百度鹰眼服务的简介

下面是开发步骤：

一、申请密钥

根据应用的包名和安全码SHA1值可以申请到一个ak值，其中SHA1氛围开发版和发布版，分别对应开发版和发布版的ak，详细步骤参照http://lbsyun.baidu.com/index.php?title=android-yingyan/guide/key

注：1. 每个Key仅且唯一对于1个应用验证有效，即对该Key配置环节中使用的包名匹配的应用有效。因此，多个应用【包括多个包名】需申请多个Key，或者对1个Key进行多次配置；

2.若你需要在同一个工程中同时使用百度地图、定位、导航SDK、鹰眼SDK可以共用同一个key；

二、在百度开发者平台创建鹰眼轨迹服务

进入轨迹管理台创建鹰眼服务，获得serviceId

创建成功后会得到一个serviceid。

三、配置工程

导入jar包和库文件并在项目的清单文件里进行配置ak和添加鹰眼服务组件并添加相应的权限

四、开启轨迹追踪

1.初始化Trace和LBSTraceClient

初始化LBSTraceClient时最好使用getApplicationContext，以保证服务的全局使用

定位周期：多久定位一次，在定位周期大于15s时，SDK会将定位周期设置为5的倍数（如设置采集周期为18s，SDK会调整为15s；设置为33s，SDK会调整为30s）

回传周期：鹰眼为节省电量和流量，并不是定位一次就回传一次数据，而是隔段时间将一批定位数据打包压缩回传。（回传周期最大不要超过定位周期的10倍，例如，定位周期为10s，则回传周期最好不要大于60s）

鹰眼SDK支持开发者动态设置定位周期和回传周期（2s到5分钟），可以在开启服务前设置，也可以在服务运行过程中动态设置，随时生效。开发者可自行判断终端的运动速度和状态，动态调整定位周期。

2.开启服务

client.startTrace(trace);

或者

client.startTrace(trace，onStartTraceListener); //startTrace()对应的回调接口为onStartTraceListener中的onTraceCallback()接口

3.结束轨迹追踪

client.stopTrace(trace, onStopTraceListener); //stopTrace()对应的回调接口为onStopTraceListener中的onTraceCallback()接口

***复杂网络状态下，SDK的连接与轨迹回传策略***

在网络状态持续良好的情况下，SDK将按照指定频率回传轨迹。如果在开启轨迹追踪时、追踪过程中、或结束轨迹追踪时遇到网络不稳定或断网的情况，SDK也有相应处理策略:

①开启追踪追踪，调用startTrace()时

只要调用startTrace()，不论网络状态和startTrace()回调的状态码是什么，SDK都将立即开始采集并缓存轨迹，若此时网络连接正常，将实时回传轨迹；若连上不可上网的Wi-Fi或网络断开，则将缓存轨迹在手机数据库中，并自动监听网络，待联网时自动回传缓存数据（处于缓存状态时，因为轨迹在设备端，实时位置、历史轨迹和里程都不能获取到最新的轨迹信息）。

②轨迹追踪过程中

若追踪过程中，出现网络中断、连上不可上网的Wi-Fi，或网络频繁切换时，SDK都将自动开启缓存模式，将采集的轨迹数据保存到数据库中，并自动监听网络，待联网时自动回传缓存数据。

③停止轨迹追踪，调用stopTrace()时

只要调用stopTrace()，无论网络状态和返回值如何，SDK都将立即停止轨迹采集。

若此时网络连接正常，SDK将加快上传已缓存的轨迹，上传成功后在回调用返回停止服务成功；

若此时已断网或回传过程中断网，将立即停止回传，缓存数据存储至手机数据库中，返回停止服务成功，再次startTrace时才会继续回传缓存数据。

五、查询轨迹点的记录

所有轨迹点均上传到了百度的服务后台，所以查询时根据百度提供的接口来查询即可。

接口总览---鹰眼Web API v2.0

http://lbsyun.baidu.com/index.php?title=yingyan/api/all

1.动态实时更新轨迹

api