com.baidu.trace

类 LBSTraceClient

java.lang.Object

com.baidu.trace.LBSTraceClient

public class LBSTraceClient
extends java.lang.Object

trace服务client，每个开发者需要创建

构造器概要

构造器

构造器和说明
LBSTraceClient(Context context)

方法概要

限定符和类型	方法和说明
void	addEntity(long serviceId, java.lang.String entityName, java.lang.String columnKey, OnEntityListener listener) 添加Entity
void	createCircularFence(long serviceId, java.lang.String creator, java.lang.String fenceName, java.lang.String fenceDesc, java.lang.String monitoredPersons, java.lang.String observers, java.lang.String validTimes, int validCycle, java.lang.String validDate, java.lang.String validDays, int coordType, java.lang.String center, double radius, int alarmCondition, OnGeoFenceListener listener) 创建圆形围栏
void	createVertexesFence(long serviceId, java.lang.String creator, java.lang.String fenceName, java.lang.String fenceDesc, java.lang.String monitoredPersons, java.lang.String observers, java.lang.String validTimes, int validCycle, java.lang.String validDate, java.lang.String validDays, int coordType, java.lang.String vertexes, int alarmCondition, OnGeoFenceListener listener) 创建多边形围栏
void	delayFenceAlarm(long serviceId, int fenceId, java.lang.String observer, int delayTime, OnGeoFenceListener listener) 延迟报警
void	deleteFence(long serviceId, int fenceId, OnGeoFenceListener listener) 删除围栏
void	onDestroy() 销毁client对象
void	queryEntityList(long serviceId, java.lang.String entityNames, java.lang.String columnKey, int returnType, int activeTime, int pageSize, int pageIndex, OnEntityListener listener) 查询Entity列表
void	queryFenceHistoryAlarmInfo(long serviceId, int fenceId, java.lang.String monitoredPersons, int beginTime, int endTime, OnGeoFenceListener listener) 查询围栏内监控对象的历史报警信息
void	queryFenceList(long serviceId, java.lang.String creator, java.lang.String fenceIds, OnGeoFenceListener listener) 查询围栏列表
void	queryHistoryTrack(long serviceId, java.lang.String entityName, int simpleReturn, int startTime, int endTime, int pageSize, int pageIndex, OnTrackListener listener) 查询历史轨迹
void	queryMonitoredStatus(long serviceId, int fenceId, java.lang.String monitoredPersons, OnGeoFenceListener listener) 查询围栏内监控对象的状态
void	queryProcessedHistoryTrack(long serviceId, java.lang.String entityName, int simpleReturn, int isProcessed, int startTime, int endTime, int pageSize, int pageIndex, OnTrackListener listener) 查询纠偏后的历史轨迹
boolean	setInterval(int gatherInterval, int packInterval) 设置采集和打包位置数据的时间间隔
void	setOnEntityListener(OnEntityListener entityListener) 设置Entity监听器
void	setOnGeoFenceListener(OnGeoFenceListener geofenceListener) 设置地理围栏监听器
void	setOnStartTraceListener(OnStartTraceListener onTraceListener) 设置开启轨迹服务监听器
void	setOnTrackListener(OnTrackListener trackListener) 设置轨迹监听器
void	setProtocolType(int type) 设置HTTP请求协议类型
void	startTrace(Trace trace) 开启轨迹服务
void	startTrace(Trace trace, OnStartTraceListener onTraceListener) 开启轨迹服务
void	stopTrace(Trace trace, OnStopTraceListener onStopTraceListener) 停止轨迹服务
void	updateCircularFence(long serviceId, java.lang.String fenceName, int fenceId, java.lang.String fenceDesc, java.lang.String monitoredPersons, java.lang.String observers, java.lang.String validTimes, int validCycle, java.lang.String validDate, java.lang.String validDays, int coordType, java.lang.String center, double radius, int alarmCondition, OnGeoFenceListener listener) 更新圆形围栏
void	updateEntity(long serviceId, java.lang.String entityName, java.lang.String columnKey, OnEntityListener listener) 更新Entity
void	updateVertexesFence(long serviceId, java.lang.String fenceName, int fenceId, java.lang.String fenceDesc, java.lang.String monitoredPersons, java.lang.String observers, java.lang.String validTimes, int validCycle, java.lang.String validDate, java.lang.String validDays, int coordType, java.lang.String vertexes, int alarmCondition, OnGeoFenceListener listener) 更新多边形围栏

从类继承的方法 java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

LBSTraceClient

public LBSTraceClient(Context context)

方法详细资料

addEntity

public void addEntity(long serviceId,
                      java.lang.String entityName,
                      java.lang.String columnKey,
                      OnEntityListener listener)

添加Entity

参数:

serviceId - 轨迹服务标识

entityName - entity标识

columnKey - 属性名称（格式 : "key1=value1,columnKey2=columnValue2......."）

listener - 轨迹监听器

createCircularFence

public void createCircularFence(long serviceId,
                                java.lang.String creator,
                                java.lang.String fenceName,
                                java.lang.String fenceDesc,
                                java.lang.String monitoredPersons,
                                java.lang.String observers,
                                java.lang.String validTimes,
                                int validCycle,
                                java.lang.String validDate,
                                java.lang.String validDays,
                                int coordType,
                                java.lang.String center,
                                double radius,
                                int alarmCondition,
                                OnGeoFenceListener listener)

创建圆形围栏

参数:

serviceId - 轨迹服务标识

creator - 创建者（轨迹服务中的entityName）

fenceName - 围栏名称 （最长128个字节）

fenceDesc - 围栏描述 （最长1024个字节）

monitoredPersons - 监控对象列表 （每个监控对象都是轨迹服务中的entityName，使用英文逗号”,”分割）

observers - 观察者列表 （每个观察者都是轨迹服务中的entityName，使用英文逗号”,”分割）

validTimes - 生效时间列表 （一天中的几点几分到 几点几分生效。多个时间段使用分号”;”分隔。比如：“0820,0930;1030,1130”）

validCycle - 生效周期 （参数validTimes是否周期性生效，可以使用如下数值：1：不重复，2：工作日循环，3：周末循环，4：每天循环，5：自定义。当为5时，需要定义validDays，标识在周几生效）

validDate - 围栏生效日期 （当validCycle为1时必选，例如："20150908"）

validDays - 生效日期列表 （1到7，分别表示周一到周日，格式 : "int,int…"）

coordType - 坐标类型 （1：GPS经纬度，2：国测局经纬度，3：百度经纬度）

center - 围栏圆心（圆心位置, 格式 : "经度,纬度"）

radius - 围栏半径（单位米）

alarmCondition - 报警条件（1：进入时触发提醒，2：离开时触发提醒，3：进入离开均触发提醒）

listener - 围栏监听器

createVertexesFence

public void createVertexesFence(long serviceId,
                                java.lang.String creator,
                                java.lang.String fenceName,
                                java.lang.String fenceDesc,
                                java.lang.String monitoredPersons,
                                java.lang.String observers,
                                java.lang.String validTimes,
                                int validCycle,
                                java.lang.String validDate,
                                java.lang.String validDays,
                                int coordType,
                                java.lang.String vertexes,
                                int alarmCondition,
                                OnGeoFenceListener listener)

创建多边形围栏

参数:

serviceId - 轨迹服务标识

creator - 创建者（轨迹服务中的entityName）

fenceName - 围栏名称

fenceDesc - 围栏描述

monitoredPersons - 监控对象列表（每个监控对象都是轨迹服务中的entityName，使用英文逗号”,”分割）

observers - 观察者列表（每个观察者都是轨迹服务中的entityName，使用英文逗号”,”分割）

validTimes - 生效时间列表（一天中的几点几分到 几点几分生效。多个时间段使用分号”;”分隔。比如：“0820,0930;1030,1130”）

validCycle - 生效周期（参数validTimes是否周期性生效，可以使用如下数值：1：不重复，2：工作日循环，3：周末循环，4：每天循环，5：自定义。当为5时，需要定义validDays，标识在周几生效）

validDate - 围栏生效日期 （当validCycle为1时必选，例如："20150908"）

validDays - 生效日期列表（1到7，分别表示周一到周日，格式 : "int,int…"）

coordType - 坐标类型 （1：GPS经纬度，2：国测局经纬度，3：百度经纬度）

vertexes - 多边形顶点列表（顶点为多边形顺时针或逆时针顺序，格式 : "经度,纬度;...."）

alarmCondition - 报警条件（1：进入时触发提醒，2：离开时触发提醒，3：进入离开均触发提醒）

listener - 围栏监听器

delayFenceAlarm

public void delayFenceAlarm(long serviceId,
                            int fenceId,
                            java.lang.String observer,
                            int delayTime,
                            OnGeoFenceListener listener)

延迟报警

参数:

serviceId - 轨迹服务标识

fenceId - 围栏标识

observer - 观察者（轨迹服务中的entityName）

delayTime - 延迟时间（Unix时间戳，表示在此时间之前不再提醒）

listener - 围栏监听器

deleteFence

public void deleteFence(long serviceId,
                        int fenceId,
                        OnGeoFenceListener listener)

删除围栏

参数:

serviceId - 轨迹服务标识

fenceId - 围栏标识

listener - 围栏监听器

onDestroy

public void onDestroy()

销毁client对象

queryEntityList

public void queryEntityList(long serviceId,
                            java.lang.String entityNames,
                            java.lang.String columnKey,
                            int returnType,
                            int activeTime,
                            int pageSize,
                            int pageIndex,
                            OnEntityListener listener)

查询Entity列表

参数:

serviceId - 轨迹服务标识

entityNames - entity标识列表（多个entityName，以英文逗号"," 分割）

columnKey - 属性名称（格式为 : "key1=value1,key2=value2,....."）

returnType - 返回结果的类型（0 : 返回全部结果，1 : 只返回entityName的列表）

activeTime - 活跃时间（指定该字段时，返回从该时间点之后仍有位置变动的entity的实时点集合）

pageSize - 分页大小

pageIndex - 分页索引

listener - Entity 查询监听器

queryFenceHistoryAlarmInfo

public void queryFenceHistoryAlarmInfo(long serviceId,
                                       int fenceId,
                                       java.lang.String monitoredPersons,
                                       int beginTime,
                                       int endTime,
                                       OnGeoFenceListener listener)

查询围栏内监控对象的历史报警信息

参数:

serviceId - 轨迹服务标识

fenceId - 围栏标识

monitoredPersons - 监控对象列表（轨迹服务中的entityName，多个对象用英文逗号","分隔，最多五个）

beginTime - 开始时间（Unix时间戳）

endTime - 结束时间（Unix时间戳）

listener - 围栏监听器

queryFenceList

public void queryFenceList(long serviceId,
                           java.lang.String creator,
                           java.lang.String fenceIds,
                           OnGeoFenceListener listener)

查询围栏列表

参数:

serviceId - 轨迹服务标识

creator - 创建者（轨迹服务中的entityName）

fenceIds - 查询的围栏列表（格式 : "int,int…"）

listener - 围栏监听器

queryHistoryTrack

public void queryHistoryTrack(long serviceId,
                              java.lang.String entityName,
                              int simpleReturn,
                              int startTime,
                              int endTime,
                              int pageSize,
                              int pageIndex,
                              OnTrackListener listener)

查询历史轨迹

参数:

serviceId - 轨迹服务标识

entityName - entity标识

simpleReturn - 是否返回精简的结果（0 : 否，1 : 是）

startTime - 开始时间（Unix时间戳）

endTime - 结束时间（Unix时间戳，不能超过当前时间，结束时间和开始时间最大间隔为24小时）

pageSize - 分页大小

pageIndex - 分页索引

listener - 轨迹查询监听器

queryMonitoredStatus

public void queryMonitoredStatus(long serviceId,
                                 int fenceId,
                                 java.lang.String monitoredPersons,
                                 OnGeoFenceListener listener)

查询围栏内监控对象的状态

参数:

serviceId - 轨迹服务标识

fenceId - 围栏标识

monitoredPersons - 监控对象列表（轨迹服务中的entityName，多个对象用英文逗号","分隔）

listener - 围栏监听器

queryProcessedHistoryTrack

public void queryProcessedHistoryTrack(long serviceId,
                                       java.lang.String entityName,
                                       int simpleReturn,
                                       int isProcessed,
                                       int startTime,
                                       int endTime,
                                       int pageSize,
                                       int pageIndex,
                                       OnTrackListener listener)

查询纠偏后的历史轨迹

参数:

serviceId - 轨迹服务标识

entityName - entity标识

simpleReturn - 是否返回精简的结果（0 : 否，1 : 是）

isProcessed - 是否返回纠偏后轨迹（0 : 否，1 : 是）注意 : 轨迹纠偏功能包括去噪、抽稀、绑路三个步骤，当isProcessed=1时，默认仅进行去噪和抽稀处理，并不作绑路处理。 若应用为车辆和外勤人员轨迹追踪类型 ，需要开通绑路操作，可发邮件至：baiduyingyan@baidu.com申请开通

startTime - 开始时间（Unix时间戳）

endTime - 结束时间（Unix时间戳，不能超过当前时间，结束时间和开始时间最大间隔为24小时）

pageSize - 分页大小

pageIndex - 分页索引

listener - 轨迹查询监听器

setInterval

public boolean setInterval(int gatherInterval,
                           int packInterval)

设置采集和打包位置数据的时间间隔

参数:

gatherInterval - 采集时间间隔，单位：秒。最小为2秒，最大为1分钟，否则设置不成功

packInterval - 打包时间间隔，单位：秒。打包时间间隔必须为采集时间间隔的整数倍，且最大不能超过1分钟，否则设置不成功

返回:

setOnEntityListener

public void setOnEntityListener(OnEntityListener entityListener)

设置Entity监听器

参数:

entityListener -

setOnGeoFenceListener

public void setOnGeoFenceListener(OnGeoFenceListener geofenceListener)

设置地理围栏监听器

参数:

geofenceListener -

setOnStartTraceListener

public void setOnStartTraceListener(OnStartTraceListener onTraceListener)

设置开启轨迹服务监听器

参数:

onTraceListener -

setOnTrackListener

public void setOnTrackListener(OnTrackListener trackListener)

设置轨迹监听器

参数:

onTrackListener -

setProtocolType

public void setProtocolType(int type)

设置HTTP请求协议类型

参数:

type（1为https类型，0为http类型） -

startTrace

public void startTrace(Trace trace)

开启轨迹服务

参数:

trace - 轨迹服务

startTrace

public void startTrace(Trace trace,
                       OnStartTraceListener onTraceListener)

开启轨迹服务

参数:

trace - 轨迹服务

onTraceListener - 回调接口

stopTrace

public void stopTrace(Trace trace,
                      OnStopTraceListener onStopTraceListener)

停止轨迹服务

参数:

trace - 轨迹服务

onAppLogoutListener - 停止轨迹服务(app登出)回调接口

updateCircularFence

public void updateCircularFence(long serviceId,
                                java.lang.String fenceName,
                                int fenceId,
                                java.lang.String fenceDesc,
                                java.lang.String monitoredPersons,
                                java.lang.String observers,
                                java.lang.String validTimes,
                                int validCycle,
                                java.lang.String validDate,
                                java.lang.String validDays,
                                int coordType,
                                java.lang.String center,
                                double radius,
                                int alarmCondition,
                                OnGeoFenceListener listener)

更新圆形围栏

参数:

serviceId - 轨迹服务标识

fenceName - 围栏名称

fenceId - 围栏标识

fenceDesc - 围栏描述

monitoredPersons - 监控对象列表（每个监控对象都是轨迹服务中的entityName，使用英文逗号”,”分割）

observers - 观察者列表（每个观察者都是轨迹服务中的entityName，使用英文逗号”,”分割）

validTimes - 生效时间列表（一天中的几点几分到 几点几分生效。多个时间段使用分号”;”分隔，比如：“0820,0930;1030,1130”）

validCycle - 生效周期（参数validTimes是否周期性生效，可以使用如下数值：1：不重复，2：工作日循环，3：周末循环，4：每天循环，5：自定义。当为5时，需要定义validDays，标识在周几生效）

validDate - 围栏生效日期 （当validCycle为1时必选，例如："20150908"）

validDays - 生效日期列表 （1到7，分别表示周一到周日，格式 : "int,int…"）

coordType - 坐标类型 （1：GPS经纬度，2：国测局经纬度，3：百度经纬度）

center - 围栏圆心（圆心位置, 格式 : "经度,纬度"）

radius - 围栏半径（单位米）

alarmCondition - 报警条件（1：进入时触发提醒，2：离开时触发提醒，3：进入离开均触发提醒）

listener - 围栏监听器

updateEntity

public void updateEntity(long serviceId,
                         java.lang.String entityName,
                         java.lang.String columnKey,
                         OnEntityListener listener)

更新Entity

参数:

serviceId - 轨迹服务标识

entityName - entity标识

columnKey - 属性名称

listener -

updateVertexesFence

public void updateVertexesFence(long serviceId,
                                java.lang.String fenceName,
                                int fenceId,
                                java.lang.String fenceDesc,
                                java.lang.String monitoredPersons,
                                java.lang.String observers,
                                java.lang.String validTimes,
                                int validCycle,
                                java.lang.String validDate,
                                java.lang.String validDays,
                                int coordType,
                                java.lang.String vertexes,
                                int alarmCondition,
                                OnGeoFenceListener listener)

更新多边形围栏

参数:

serviceId - 轨迹服务标识

fenceName - 围栏名称

fenceId - 围栏标识

fenceDesc - 围栏描述

monitoredPersons - 监控对象列表（每个监控对象都是轨迹服务中的entityName，使用英文逗号”,”分割）

observers - 观察者列表（每个观察者都是轨迹服务中的entityName，使用英文逗号”,”分割）

validTimes - 生效时间列表（一天中的几点几分到 几点几分生效。多个时间段使用分号”;”分隔。比如：“0820,0930;1030,1130”）

validCycle - 生效周期（参数validTimes是否周期性生效，可以使用如下数值：1：不重复2：工作日循环3：周末循环4：每天循环5：自定义当为5时，需要定义validDays，标识在周几生效）

validDate - 围栏生效日期 （当validCycle为1时必选，例如："20150908"）

validDays - 生效日期列表 （1到7，分别表示周一到周日，格式 : "int,int…"）

coordType - 坐标类型 （1：GPS经纬度，2：国测局经纬度，3：百度经纬度）

vertexes - 多边形顶点列表（顶点为多边形顺时针或逆时针顺，格式 : "经度,纬度;...."）

alarmCondition - 报警条件（1：进入时触发提醒，2：离开时触发提醒，3：进入离开均触发提醒）

listener - 围栏监听器