接口总览

鹰眼Web服务API v3.0简介

鹰眼 Web 服务 API v3.0是一套REST 风格的API,以HTTP/HTTPS形式提供了轨迹上传/查询/分析和地理围栏等功能,是v2.0的升级版,兼容2.0的所有数据。Web 服务 API 主要用于开发者从后台服务端发起对鹰眼的请求。


Web 服务 API v3.0 于2016年12月1日开始陆续对外发布,使用全新域名http://yingyan.baidu.com/api/v3

目前已发布接口如下:

模块 接口名称 功能说明
终端管理 entity/add 创建entity,并赋属性信息
entity/delete 删除entity
entity/update 更新entity属性信息
entity/list 检索符合条件的entity,返回entity属性信息和最新位置。可用于列出entity,也可用于批量查询多个entitiy的位置
实时位置搜索 entity/search 根据关键字搜索entity
entity/boundsearch 根据矩形范围搜索entity
entity/aroundsearch 周边搜索,根据圆心和半径搜索 entity
轨迹上传 track/addpoint 上传单个轨迹点
track/addpoints 批量上传多个 entity 的多个轨迹点
轨迹纠偏和里程 track/getlatestpoint 查询某 entity 的实时位置,支持纠偏
track/getdistance 查询某 entity 一段时间内的轨迹里程,支持纠偏和里程补偿
track/gettrack 查询某 entity 一段时间内的轨迹点以及相关信息,支持纠偏和里程补偿
轨迹分析 analysis/staypoint 停留点分析
analysis/drivingbehavior 驾驶行为分析
地理围栏管理 createcirclefence 创建圆形围栏
createpolygonfence 创建多边形围栏
createpolylinefence 创建线型围栏
createdistrictfence 创建行政区划围栏
updatecirclefence 更新圆形围栏
updatepolygonfence 更新多边形围栏
updatepolylinefence 更新线型围栏
updatedistrictfence 更新行政区划围栏
delete 删除围栏
list 查询围栏信息
地理围栏报警 querystatus 查询监控对象在围栏内或外
historyalarm 查询某监控对象的历史报警信息
batchhistoryalarm 批量查询某 service 下时间段以内的所有报警信息,用于服务端报警同步
entity自定义字段管理 entity 自定义字段的增删改查,接口已删除,改为在管理台中可视化设置 可创建最多5个 entity 的自定义字段用于描述业务属性,如:手机号、所属分组等。

操作方法:进入轨迹管理台 ->选中某个 service,点击"设置"->选择"entity属性字段"

track自定义字段管理 track自定义字段的增删改查,接口已删除,改为在管理台中可视化设置 可创建最多10个 track 的自定义字段用于描述业务属性,如:温度、油量、发动机转速等。

操作方法:进入轨迹管理台 ->选中某个 service,点击"设置"->选择"track属性字段"