简介

开发者可通过关键字或地理范围搜索 entity，并查询其相关信息。目前支持以下搜索接口：

周边搜索

矩形范围搜索

多边形搜索

行政区搜索

关键字搜索

终端列表

周边搜索

根据圆心和半径查询圆形范围内的终端。例如：查询用户周边5公里范围内的车辆。

矩形范围搜索

根据矩形地理范围查询终端。例如：查询当前屏幕范围内的车辆。

多边形搜索

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

行政区搜索

根据行政区的名称，查询中国、省、市、区范围内的终端。例如：查询海淀区内的车辆。

关键字搜索

根据关键字模糊搜索匹配的终端。例如：查询entity_name中包含"899"的车辆。

终端列表

根据筛选条件精确查询终端。例如：

1. 查询根据entity_name精确查询某一个entity 的详细信息

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

3. 根据活跃时间筛选在线和离线设备

使用建议

以上接口除支持主要搜索条件外（如：关键字、矩形范围），还支持与 filter 字段组合搜索。filter 字段支持通过entity 自定义字段、活跃/非活跃时间进行筛选。基于以上组合，实时位置搜索接口可实现多种业务场景，如：

1. 查询周边5公里范围内的空闲车辆
开发者可创建一个标识车辆是否空闲的 entity 自定义字段，并设置为可检索。利用周边搜索接口设置圆心和半径，并设置 filter 字段过滤空闲车辆，即可实现。

2. 查询当前地图视野内的在线车辆，其中在线车辆定义为5分钟内有轨迹上传的车辆
利用矩形范围搜索接口，并在 filter 字段中设置 active_time 为当前时间减去5分钟，即可实现该场景。

在此不一一列举，开发者可参考Web服务API关于：实时位置搜索 接口的详细说明。