简介
鹰眼 web服务 api v3.0是一套rest 风格的api,以http/https形式提供了轨迹上传/查询/分析和地理围栏等功能,主要用于开发者从服务器端发起对鹰眼的请求。接口列表如下:
模块 | 接口名称 | 功能说明 |
---|---|---|
终端管理 | entity/add | 创建entity,并赋属性信息 |
entity/delete | 删除entity | |
entity/update | 更新entity属性信息 | |
entity/list | 检索符合条件的entity,返回entity属性信息和最新位置。可用于列出entity,也可用于批量查询多个entitiy的位置 | |
空间搜索 | entity/search | 根据关键字搜索entity |
entity/boundsearch | 根据矩形范围搜索entity | |
entity/aroundsearch | 周边搜索,根据圆心和半径搜索 entity | |
entity/polygonsearch | 多边形搜索,搜索多边形范围内的entity | |
entity/districtsearch | 行政区搜索,根据行政区名称搜索区域内的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 | 查询围栏信息 | |
addmonitoredperson | 增加监控对象 | |
deletemonitoredperson | 删除监控对象 | |
listmonitoredperson | 查询监控对象 | |
地理围栏报警 | querystatus | 查询监控对象在围栏内或外 |
querystatusbylocation | 查询坐标在围栏内/外 | |
historyalarm | 查询某监控对象的历史报警信息 | |
batchhistoryalarm | 批量查询某 service 下时间段以内的所有报警信息,用于服务端报警同步 | |
服务端报警推送 | 向开发者服务端推送围栏报警信息 | |
entity自定义字段管理 | entity 自定义字段的增删改查,接口已删除,改为在管理台中可视化设置 | 可创建最多5个 entity 的自定义字段用于描述业务属性,如:手机号、所属分组等。
操作方法:进入轨迹管理台 ->选中某个 service,点击"设置"->选择"entity属性字段" |
track自定义字段管理 | track自定义字段的增删改查,接口已删除,改为在管理台中可视化设置 | 可创建最多10个 track 的自定义字段用于描述业务属性,如:温度、油量、发动机转速等。
操作方法:进入轨迹管理台 ->选中某个 service,点击"设置"->选择"track属性字段" |