简介
鹰眼Android SDK提供了实时位置查询和历史轨迹查询两个接口,查询指定被追踪者位置。
设置请求协议
查询轨迹接口提供了HTTP和HTTPS两种协议,可通过setProtocolType()方法设置。请注意使用HTTPS时,可能会降低请求效率,请开发者根据实际需要进行设置。
// 设置协议类型,0为http,1为https int protocoType = 1; client.setProtocolType(protocoType);
查询实时位置
查询一或多个被追踪者的实时位置。
//鹰眼服务ID long serviceId = <开发者创建的鹰眼服务的ID>; //entity标识列表(多个entityName,以英文逗号"," 分割) String entityNames = "mycar1,mycar2,mycar3"; //检索条件(格式为 : "key1=value1,key2=value2,.....") String columnKey = "car_team=1"; //返回结果的类型(0 : 返回全部结果,1 : 只返回entityName的列表) int returnType = 0; //活跃时间,UNIX时间戳(指定该字段时,返回从该时间点之后仍有位置变动的entity的实时点集合) int activeTime = (int) (System.currentTimeMillis() / 1000 - 12 * 60 * 60); //分页大小 int pageSize = 1000; //分页索引 int pageIndex = 1; //Entity监听器 OnEntityListener entityListener = new OnEntityListener() { // 查询失败回调接口 @Override public void onRequestFailedCallback(String arg0) { System.out.println("entity请求失败回调接口消息 : " + arg0); } // 查询entity回调接口,返回查询结果列表 @Override public void onQueryEntityListCallback(String arg0) { System.out.println("entity回调接口消息 : " + arg0); } }; //查询实时轨迹 client.queryEntityList(serviceId, entityNames, columnKey, returnType, activeTime, pageSize, pageIndex, entityListener);
查询轨迹
查询一个被追踪者某时间段的历史轨迹。
//鹰眼服务ID long serviceId = <开发者创建的鹰眼服务的ID>; //entity标识 String entityName = "mycar1"; //是否返回精简的结果(0 : 将只返回经纬度,1 : 将返回经纬度及其他属性信息) int simpleReturn = 0; //开始时间(Unix时间戳) int startTime = (int) (System.currentTimeMillis() / 1000 - 12 * 60 * 60); //结束时间(Unix时间戳) int endTime = (int) (System.currentTimeMillis() / 1000); //分页大小 int pageSize = 1000; //分页索引 int pageIndex = 1; //轨迹查询监听器 OnTrackListener trackListener = new OnTrackListener() { //请求失败回调接口 @Override public void onRequestFailedCallback(String arg0) { System.out.println("track请求失败回调接口消息 : " + arg0); } // 查询历史轨迹回调接口 @Override public void onQueryHistoryTrackCallback(String arg0) { System.out.println("查询历史轨迹回调接口消息 : " + arg0); } }; //查询历史轨迹 client.queryHistoryTrack(serviceId, entityName, simpleReturn, startTime, endTime, pageSize, pageIndex,trackListener);
轨迹展示
查询获得历史轨迹后,可结合百度地图Android SDK绘制并展示轨迹。Marker沿轨迹平滑移动效果,可参考百度地图Android SDK Demo中的“小车轨迹平滑移动-TrackShowDemo”实现。
