全部服务产品
开发者频道
定价
登录
空间搜索
下载开发文档
简介

实时查询entity最新位置、高度、速度、方向和相关属性信息。支持以下搜索方式:

周边搜索
矩形范围搜索
多边形搜索
行政区搜索
关键字搜索
终端列表
坐标系说明
目前中国主要有以下三种坐标系:

WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。

GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。

BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标

非中国地区地图,统一使用WGS84坐标

周边搜索接口

根据圆心和半径查询圆形范围内的终端。例如:查询用户周边5公里范围内的车辆。支持与FilterCondition筛选条件组合。

aroundsearcha.png
矩形搜索接口

根据矩形地理范围查询终端。例如:查询当前屏幕范围内的车辆。支持与FilterCondition筛选条件组合。

boundsearcha.png
多边形搜索

查询多边形范围内的终端。例如:查询划定运营区域内的车辆。支持与FilterCondition筛选条件组合。

polygonsearchsdk.png
行政区搜索

根据行政区的名称,查询中国、省、市、区范围内的终端。例如:查询海淀区内的车辆。支持与FilterCondition筛选条件组合。

districtsearchsdk.png
entity列表接口
queryEntityList()方法用于根据筛选条件(FilterCondition)查找符合条件的entity列表,常用于以下场景:

1. 查询某一个 entity 的详细信息,包括实时位置

2. 查询所有设备信息和实时位置,如轨迹管理台的entity列表面板

3. 查询在线和离线设备

类似Web轨迹管理台中的在线和离线 entity 列表功能,在 Android APP内可用该方法实现。若判断在线的条件为:当前5分钟内定位且上传了轨迹点的 entity,则可按如下示例实现:
// 请求标识
int tag = 5;
// 轨迹服务ID
long serviceId = 0;
//设置活跃时间
long activeTime = System.currentTimeMillis() / 1000 - 5*60;
// 过滤条件
FilterCondition filterCondition = new FilterCondition();
// 查找当前时间5分钟之内有定位信息上传的entity
filterCondition.setActiveTime(activeTime);
// 返回结果坐标类型
CoordType coordTypeOutput = CoordType.bd09ll;
// 分页索引
int pageIndex = 1;
// 分页大小
int pageSize = 100;
// 创建Entity列表请求实例
EntityListRequest request = new EntityListRequest(tag, serviceId, filterCondition, coordTypeOutput, pageIndex, pageSize);
// 初始化监听器
OnEntityListener entityListener = new OnEntityListener() {
@Override
public void onEntityListCallback(EntityListResponse response) {}
};
// 查询Entity列表
mTraceClient.queryEntityList(request, entityListener);
entitylist1.png
关键字搜索接口

通过 keyword(搜索 entityName 和 entityDesc)模糊搜索 entity,并支持与FilterCondition筛选条件组合

keywords.png
FilterCondition过滤条件的说明
在以上4种实时位置搜索接口中均支持通过FilterCondition进行过滤。目前,FilterCondition 支持以下筛选条件,均为精确匹配:

1. entityNames - 支持传入多个 entityName

2. activeTime - 活跃时间,在此时间之后有定位信息上传的entity,即 locTime>=activeTime(注意:activeTime和inActiveTime二者不可同时设置)

3. inActiveTime - 不活跃时间,在此时间之后无定位信息上传的entity,即 locTime<inActiveTime(注意:activeTime和inActiveTime二者不可同时设置)

4. columns - 开发者创建的可检索的entity属性字段

上一篇

缓存轨迹处理

下一篇

轨迹查询

本篇文章对您是否有帮助?