调用百度鹰眼api实现实时轨迹绘制

自己想做一个跑步路径轨迹记录的app，刚好百度地图有鹰眼api，就拿过来调用了，这里给出鹰眼api调用的一个完整实现的例子HelloTrace，放在了完整包的下载链接为：http://download.csdn.net/detail/sinat_22013331/9323045

最近缺下载积分，所以需要一个下载币。。只要一个。。

百度鹰眼api接口的实现，在实现之前要进行工程配置，这是第一步，在AndroidManifest.xml文件中配置的信息是：

        <meta-data        android:name="com.baidu.lbsapi.API_KEY"        android:value="百度接入AK" />    <service        android:name="com.baidu.trace.LBSTraceService"        android:enabled="true"        android:exported="true" >    </service>

这个配置信息要放在<application>的子项里。其中的AK值是需要在百度开发者中心自己做申请的。ak的申请地址是：点击打开链接

在这个申请的时候需要注意，ak申请的设置里面，安全码的实现是用SHA1和应用的包名组合在一起的，这里要注意packet的名称，一个包名只能对应一个ak值，如果对应的包名不对，就会出现errcode为230的情况，scode有误。

配置过后要把相关的JAR包导进工程里。

第二步：要申请一个鹰眼服务帐号，获得service_id，在主线程中定义这个service_id。

第三步：设置输出界面，在输出界面中包含一个MapView，用来展示实时的trace信息

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"    xmlns:tools="http://schemas.android.com/tools"    android:layout_width="match_parent"    android:layout_height="match_parent"    tools:context="com.blyang.MainActivity" >    <com.baidu.mapapi.map.MapView        android:id="@+id/mapView"        android:layout_width="match_parent"        android:layout_height="match_parent"        android:clickable="true"        /></LinearLayout>

第四步：定义初始的变量

    int gatherInterval = 3;  //位置采集周期 (s)    int packInterval = 10;  //打包周期 (s)    String entityName = null;  // entity标识    long serviceId = 你的service_id;// 鹰眼服务ID   int traceType = 2;  //轨迹服务类型    private static OnStartTraceListener startTraceListener = null;  //开启轨迹服务监听器    private static MapView mapView = null;private static BaiduMap baiduMap = null;private static OnEntityListener entityListener = null;private RefreshThread refreshThread = null;  //刷新地图线程以获取实时点private static MapStatusUpdate msUpdate = null;private static BitmapDescriptor realtimeBitmap;  //图标private static OverlayOptions overlay;  //覆盖物private static List<LatLng> pointList = new ArrayList<LatLng>();  //定位点的集合private static PolylineOptions polyline = null;  //路线覆盖物    private Trace trace;  // 实例化轨迹服务    private LBSTraceClient client;  // 实例化轨迹服务客户端

第五步：onCreate方法的实现

@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);SDKInitializer.initialize(getApplicationContext());setContentView(R.layout.activity_main);  //设置主界面init();  //相关变量初始化initOnEntityListener();  //初始化实体监听器initOnStartTraceListener();  //初始化轨迹追踪监听器client.startTrace(trace, startTraceListener);  // 开启轨迹服务}

其中init（）方法为相关变量的初始化，这个方法体如下：

/** * 初始化各个参数 */ private void init() {  mapView = (MapView) findViewById(R.id.mapView); baiduMap = mapView.getMap(); mapView.showZoomControls(false);  entityName = getImei(getApplicationContext());  //手机Imei值的获取，用来充当实体名          client = new LBSTraceClient(getApplicationContext());  //实例化轨迹服务客户端                  trace = new Trace(getApplicationContext(), serviceId, entityName, traceType);  //实例化轨迹服务                  client.setInterval(gatherInterval, packInterval);  //设置位置采集和打包周期 }

实体监听器的初始化方法为initOnEntityListener（）方法，在这个方法中定义实体的相关操作，方法体如下：

 /**  * 初始化设置实体状态监听器  */ private void initOnEntityListener(){  //实体状态监听器 entityListener = new OnEntityListener(){@Overridepublic void onRequestFailedCallback(String arg0) {Looper.prepare();Toast.makeText(getApplicationContext(), "entity请求失败的回调接口信息："+arg0, Toast.LENGTH_SHORT).show();Looper.loop();}@Overridepublic void onQueryEntityListCallback(String arg0) {/** * 查询实体集合回调函数，此时调用实时轨迹方法 */showRealtimeTrack(arg0);  } }; } 

在其中的查询实体集合的回调方法中，要调用showRealtimeTrack方法，用来展示实时的路径信息，这个方法在下面会详细讲到。

接着，要初始化启动轨迹监听器initOnStartTraceListener，开启运动实体的轨迹追踪。这个监听器的内部方法体如下：

/** *  追踪开始  */private void initOnStartTraceListener() {// 实例化开启轨迹服务回调接口startTraceListener = new OnStartTraceListener() {// 开启轨迹服务回调接口（arg0 : 消息编码，arg1 : 消息内容，详情查看类参考）@Overridepublic void onTraceCallback(int arg0, String arg1) {Log.i("TAG", "onTraceCallback=" + arg1);if(arg0 == 0 || arg0 == 10006){startRefreshThread(true);}}// 轨迹服务推送接口（用于接收服务端推送消息，arg0 : 消息类型，arg1 : 消息内容，详情查看类参考）@Overridepublic void onTracePushCallback(byte arg0, String arg1) {Log.i("TAG", "onTracePushCallback=" + arg1);}};}

在这个监听器的轨迹回调方法中，要调用刷新线程，实现不断的采集用户的位置点。

刷新线程的实现如下：

/** * 启动刷新线程 * @param isStart */private void startRefreshThread(boolean isStart){if(refreshThread == null){refreshThread = new RefreshThread();}refreshThread.refresh = isStart;if(isStart){if(!refreshThread.isAlive()){refreshThread.start();}}else{refreshThread = null;}}

刷新线程的run方法如下：

/** * 轨迹刷新线程 * @author BLYang */private class RefreshThread extends Thread{ protected boolean refresh = true;  public void run(){while(refresh){queryRealtimeTrack();try{Thread.sleep(packInterval * 1000);}catch(InterruptedException e){System.out.println("线程休眠失败");}}}} /** * 查询实时线路 */private void queryRealtimeTrack(){String entityName = this.entityName;String columnKey = "";int returnType = 0;int activeTime = 0;int pageSize = 10;int pageIndex = 1;this.client.queryEntityList(serviceId, entityName, columnKey, returnType,activeTime, pageSize, pageIndex, entityListener);}

在run方法中要调用查询实时线路的方法，不断的查询用户的当前位置点

在onCreate（）方法的最后，启动轨迹追踪。

client.startTrace(trace, startTraceListener);  // 开启轨迹服务

在这个方法中调用startTraceListener，开启追踪服务。

这样就实现的轨迹追踪，但是只有这些方法并不能实时的显示追踪信息。

现在，再回去initOnEntityListener方法，在这个方法中要实现showRealtimeTrack（）方法，这个方法就是用来实时展示的方法

/** * 展示实时线路图 * @param realtimeTrack */protected void showRealtimeTrack(String realtimeTrack){if(refreshThread == null || !refreshThread.refresh){return;}//数据以JSON形式存取RealtimeTrackData realtimeTrackData = GsonService.parseJson(realtimeTrack, RealtimeTrackData.class);if(realtimeTrackData != null && realtimeTrackData.getStatus() ==0){LatLng latLng = realtimeTrackData.getRealtimePoint();if(latLng != null){pointList.add(latLng);drawRealtimePoint(latLng);}else{Toast.makeText(getApplicationContext(), "当前无轨迹点", Toast.LENGTH_LONG).show();}}}/** * 画出实时线路点 * @param point */private void drawRealtimePoint(LatLng point){baiduMap.clear();MapStatus mapStatus = new MapStatus.Builder().target(point).zoom(18).build();msUpdate = MapStatusUpdateFactory.newMapStatus(mapStatus);realtimeBitmap = BitmapDescriptorFactory.fromResource(R.drawable.icon_gcoding);overlay = new MarkerOptions().position(point).icon(realtimeBitmap).zIndex(9).draggable(true);if(pointList.size() >= 2  && pointList.size() <= 1000){polyline = new PolylineOptions().width(10).color(Color.RED).points(pointList);}addMarker();}

调用showRealtimeTrack方法，不断的将采集到的用户位置点增加到实体队列中，不断的重画出线路点，重画点需要调用drawRealtimePoint方法。

最后，在重画完成之后，将重画的点展示出来，调用addMarker方法，该方法的详细内容如下：

private void addMarker(){if(msUpdate != null){baiduMap.setMapStatus(msUpdate);}if(polyline != null){baiduMap.addOverlay(polyline);}if(overlay != null){baiduMap.addOverlay(overlay);}}

不断的刷新地图的状态，刷新结束之后将坐标点图片和线路覆盖上去，形成整个界面。

第六步：最后一步，增加user-permission，提升系统的权限。

    <!-- 这个权限用于进行网络定位--><uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> <!-- 这个权限用于访问GPS定位--><uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /><!-- 用于访问wifi网络信息，wifi信息会用于进行网络定位--><uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /><!-- 获取运营商信息，用于支持提供运营商信息相关的接口--><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /><!-- 这个权限用于获取wifi的获取权限，wifi信息会用来进行网络定位--><uses-permission android:name="android.permission.CHANGE_WIFI_STATE" /><!--允许程序连接到已配对的蓝牙设备--><uses-permission android:name="android.permission.BLUETOOTH"/><!--允许程序发现和配对蓝牙设备--><uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/><!-- 用于读取手机当前的状态--><uses-permission android:name="android.permission.READ_PHONE_STATE" /><!-- 写入扩展存储，向扩展卡写入数据，用于写入离线定位数据--><uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /><!-- 访问网络，网络定位需要上网--><uses-permission android:name="android.permission.INTERNET" /><!-- SD卡读取权限，用户写入离线定位数据--><uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" /><!--允许应用读取低级别的系统日志文件 --><uses-permission android:name="android.permission.READ_LOGS" /><!--允许访问振动设备--><uses-permission android:name="android.permission.VIBRATE" /><!--屏幕保持唤醒 不锁屏--><uses-permission android:name="android.permission.WAKE_LOCK" /><!--允许应用程序更改主屏幕中的设置和快捷方式--><uses-permission android:name="android.permission.WRITE_SETTINGS" />