鹰眼Android SDK

简介

鹰眼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”实现。