浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。

鹰眼轨迹服务

百度鹰眼是一套轨迹追踪开放服务,开发者在终端集成鹰眼API/SDK 后,可同时管理并追踪数千万终端设备的轨迹,适用于车队管理、共享出行、外勤人员管理、智能穿戴等领域。

简介

fence 类接口主要包括地理围栏的增删改查,以及报警信息的查询

坐标系的说明

目前中国主要有以下三种坐标系:


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


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


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


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


鹰眼 Web服务API v2.0的输入参数支持以上三种坐标系,可通过"coord_type"标明输入坐标类型。输出坐标仅支持百度经纬度坐标(bd09ll)。

create——创建地理围栏

接口说明

创建一个新的围栏实体,返回的是本围栏的fence_id,一个地理围栏实体的fence_id加上其所属轨迹服务的service _id,可以用来查找该围栏实体本身的详细信息以及该围栏的状态等。

请求URI

http://api.map.baidu.com/trace/v2/fence/create

HTTP请求方式

POST

请求参数

参数名 参数含义 类型 备注
ak 用户的ak,授权使用 string 必选
service_id service的唯一标识 int 必选
name 围栏名称 string(128) 必选。
desc 围栏描述 string(1024) 可选
creator 围栏创建者 string 必选,创建者的entity_name
monitored_persons 监控对象 string 必选,被监控者的entity_name,一个围栏仅支持监控一个对象。
observers 观察者列表 string,string… 必选,观察者的entity_name,使用英文逗号”,”分割,至少一个,最多五个。
valid_times 围栏生效时间列表 string,string;string,string;… 必选,一天中的几点几分到 几点几分生效。至少含有一段生效时间,多个时间段使用分号”;”分隔。比如:“0820,0930;1030,1130”
valid_cycle 围栏生效周期 int 必选,标识valid_times是否周期性生效,可以使用如下数值:

1:不重复 2:工作日循环 3:周末循环 4:每天循环 5:自定义 当为5时,需要定义valid_days,标识在周几生效。

valid_date 围栏生效日期 string 当valid_cycle为1时必选,例如:20150908。
valid_days 围栏生效日期列表 int,int... 1到7,分别表示周一到周日,当valid_cycle为5时必选。
shape 围栏的形状 int 必选,围栏有两种形状:1代表圆形和2代表多边形。
coord_type 坐标类型 int 必选,坐标类型定义如下:

1:GPS经纬度 2:国测局经纬度 3:百度经纬度

center 围栏圆心经纬度 double,double shape为1时必选。格式为:经度,纬度。示例:116.4321,38.76623
radius 围栏半径 double 当shape=1时必选。单位:米,取值范围(0,5000]
vertexes 多边形围栏顶点列表 double,double; double,double; double,double 当shape=2时必选。多边形需满足一下条件:

1. 顶点坐标:经度,纬度。多个顶点用分号相隔,如: 119.32,40.38;119.33,40.38;119.33,40.37

2. 顶点需按照顺时针或逆时针方向排列;

3. 顶点个数最少3个,最多20个;

4. 多边形的外接,长和宽均不超过10km

alarm_condition 围栏报警条件 int 可选。1:进入时触发提醒 2:离开时触发提醒 3:进入离开均触发提醒。默认值为3
precision 围栏去噪参数 int 可选。单位:米。每个轨迹点都有一个定位误差半径radius,这个值越大,代表定位越不准确,可能是噪点。围栏计算时,如果噪点也参与计算,会造成误报的情况。设置precision可控制,当轨迹点的定位误差半径大于设置的precision值时,就会把该轨迹点当做噪点,不参与围栏计算。presision默认值为0,不去噪。

返回值

参数名 参数含义 类型 备注
status 状态码 int 返回状态,0为成功
message 响应信息 string 对status的中文描述
fence_id 围栏的唯一标识 int

请求示例

fencecreate1.png

返回格式

JSON

响应实例
{
   "status": 0,
   "message": "成功",
   "fence_id":1

}

delete——删除围栏

接口说明

根据fence_id删除围栏

请求URI

http://api.map.baidu.com/trace/v2/fence/delete

HTTP请求方式

POST

请求参数

参数名 参数含义 类型 备注
ak 用户的ak,授权使用 string 必须
service_id 该track所属的service服务的唯一标识 Int 必选
fence_id 地理围栏的唯一标识 int 必选

返回值

参数名 参数含义 类型 备注
status 状态码 int 返回状态,0为成功
message 响应信息 string 对status的中文描述

请求示例

fencedelete.png

返回格式

JSON

响应实例
{

"status": 0,

"message": "成功"

}

update——更新围栏

接口说明

更新一个围栏实体的详细信息。围栏属性信息中各个可选字段如果不填,则不更新相关属性值。

请求URI

http://api.map.baidu.com/trace/v2/fence/update

HTTP请求方式

POST

请求参数

参数名 参数含义 类型 备注
ak 用户的ak,授权使用 string 必选
service_id service的唯一标识 int 必选
fence_id 围栏ID,作为其唯一标识 int) 必选
name 围栏名称 string(128) 可选。
desc 围栏描述 string(1024) 可选
monitored_persons 监控对象 string 可选,被监控者的entity_name,一个围栏仅支持监控一个对象。
observers 观察者列表 string,string… 可选,观察者的entity_name,使用英文逗号”,”分割,至少一个,最多五个。
valid_times 围栏生效时间列表 string,string;string,string;… 可选,一天中的几点几分到 几点几分生效。至少含有一段生效时间,多个时间段使用分号”;”分隔。比如:“0820,0930;1030,1130”
valid_cycle 围栏生效周期 int 可选,标识valid_times是否周期性生效,可以使用如下数值:

1:不重复 2:工作日循环 3:周末循环 4:每天循环 5:自定义 当为5时,需要定义valid_days,标识在周几生效。

valid_date 围栏生效日期 string 当valid_cycle为1时必选,例如:20150908。
valid_days 围栏生效日期列表 int,int... 1到7,分别表示周一到周日,当valid_cycle为5时必选。
shape 围栏的形状 int 可选。围栏有两种形状:1代表圆形和2代表多边形。
coord_type 坐标类型 int 当指定圆心或顶点的时候,必须明确指定坐标类型。

坐标类型定义如下: 1:GPS经纬度 2:国测局经纬度 3:百度经纬度

center 围栏圆心经纬度 double,double 可选。格式为:经度,纬度。示例:116.4321,38.76623
radius 围栏半径 double 可选。单位:米,取值范围(0,5000]
vertexes 多边形围栏顶点列表 double,double; double,double; double,double 可选。多边形需满足一下条件:

1. 顶点坐标:经度,纬度。多个顶点用分号相隔,如: 119.32,40.38;119.33,40.38;119.33,40.37

2. 顶点需按照顺时针或逆时针方向排列;

3. 顶点个数最少3个,最多20个;

4. 多边形的外接,长和宽均不超过10km

alarm_condition 围栏报警条件 int 可选。1:进入时触发提醒

2:离开时触发提醒 3:进入离开均触发提醒 不填时默认为3

precision 围栏去噪参数 int 可选。单位:米。当轨迹点定位误差半径(radius)大于precision时,将不进行围栏计算。默认值为0,不去噪。

返回值

参数名 参数含义 类型 备注
status 状态码 int 返回状态,0为成功
message 响应信息 string 对status的中文描述

请求示例

fenceupdate1.png

返回格式

JSON

响应实例
{

"status": 0,

"message": "成功"

}

list——查询围栏

接口说明

根据fence_id查询围栏

请求URI

http://api.map.baidu.com/trace/v2/fence/list

HTTP请求方式

GET

请求参数

参数名 参数含义 类型 备注
ak 用户的ak,授权使用 string 必须
service_id service的唯一标识 Int 必选
creator 围栏创建者的entity_name string creator和fence_ids二者至少选一个
fence_ids 查询的地理围栏ID列表,最多10个 int,int... creator和fence_ids二者至少选一个

返回值

参数名 参数含义 类型 备注
status 状态码
message 响应信息 string 对status的中文描述
size 返回的结果条数 Int 代表返回了多少条符合条件的地理围栏
fences 地理围栏列表
fence_id 地理围栏唯一标识 int
name 地理围栏的名称 string
desc 地理围栏的描述 string
monitored_persons 围栏的监控对象 string
observers 围栏的观察者列表 string,string...
valid_times 围栏生效时间段列表 array 该时间为服务端时间
begin_time 开始时间 string 一天中的几点几分,如:0830
end_time 结束时间 string 一天中的几点几分,如:0930
valid_cycle 围栏生效周期 int 标识上面的valid_times是否周期性生效,可以使用如下数值:

1:不重复 2:工作日循环 3:周末循环 4:每天循环 5:自定义

valid_date 围栏生效日期 string 如:21050908
valid_days 一周中围栏生效日列表 int,int... 1到7,分别标识周一到周日
shape 围栏形状 int 围栏有两种形状:1代表圆形和2代表多边形。
center 围栏的圆心 object shape=1(即,圆形围栏)时返回,否则,不返回该值
longitude 经度 double shape=1(即,圆形围栏)时返回,否则,不返回该值
latitude 纬度 double shape=1(即,圆形围栏)时返回,否则,不返回该值
coord_type 坐标类型 int 1:GPS经纬度 2:国测局经纬度 3:百度经纬度
radius 围栏半径 double 单位:米。shape=1(即,圆形围栏)时返回,否则,不返回该值
vertexes 多边形围栏顶点列表 double,double; double,double; double,double shape=2(即,多边形围栏)时返回,否则,不返回该值
alarm_condition 围栏报警条件 int 1:进入时触发提醒

2:离开时触发提醒 3:进入离开均触发提醒

precision 围栏去噪参数 int 单位:米
create_time 创建时间 string 如:2015-08-19 10:23:20
modify_time 修改时间 string 如:2015-08-19 10:23:20

请求示例

fencelist.png

返回格式

JSON

响应实例
{
   "status": 0,
   "size": 1,
   "fences": [
       {
           "fence_id": 51,
           "name": "上地南路",
           "desc": "北京市海淀区信息路36号",
           "creator": "track",
           "monitored_persons": [“track_00”,”track_01”],
           “observers”: [”track_02”,”track_03”],
           "valid_times":[
                  {“begin_time”:”0830”,”end_time”:”0930”},
                  {“begin_time”:”1030”,”end_time”:”1130”}
             ],
             “valid_cycle”: 5,
              “valid_days”: [1,3,5,7]
              "shape": 1,
              "center": {
              “longitude”:116.31974792399,
              “latitude”:40.034391217421
               } 
             “coord_type”:1,
             "radius": 620.5,
             “alarm_condition”: 1
             "create_time": 2015-08-19 10:23:20,
             "modify_time": 2015-08-19 10:23:20
        }
    ],
   "message": "成功"

}

querystatus——查询围栏内监控对象状态

接口说明

根据fence_id查询围栏内监控对象是在围栏内还是在围栏外

请求URI

http://api.map.baidu.com/trace/v2/fence/querystatus

HTTP请求方式

GET

请求参数

参数名 参数含义 类型 备注
ak 用户的ak,授权使用 string 必须
service_id service的唯一标识 Int 必选
fence_id 地理围栏的唯一标识 int 必选
monitored_persons 围栏监控对象列表 string,string… 多个对象用逗号分隔。表示查询那些监控对象的状态。不填时,查询所有监控对象的状态

返回值

参数名 参数含义 类型 备注
status 状态码 int 返回状态,0为成功
message 响应信息 string 对status的中文描述
size 返回的结果条数 int
monitored_person_statuses 被监控对象当前的状态列表 Array
monitored_person 被监控对象的entity_name string
monitored_status 被监控对象的状态列表 int 0:未知状态 1:在围栏内 2:在围栏外

请求示例

fencequerystatus.png

返回结果示例

JSON

响应实例
{
   "status": 0,
   “size”:2
    "monitored_person_statuses": [
          {
                   “monitored_person”:”track1”,
                   “monitored_status”:1
          },
          {
                   “monitored _monitor”:”track2”,
                    “monitored _status”:2
          }
      ], 
      "message": "成功"

}

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

接口说明

查询围栏的监控对象的历时报警信息。只提供7天以内(包含7天)的数据查询,7天以外的数据不提供查询服务。

请求URI

http://api.map.baidu.com/trace/v2/fence/historyalarm

HTTP请求方式

GET

请求参数

参数名 参数含义 类型 备注
ak 用户的ak,授权使用 string 必须
service_id service的唯一标识 Int 必选
fence_id 地理围栏的唯一标识 int 必选
monitored_persons 监控对象列表 string,string 可选。监控对象列表,表示查询哪些监控对象的历史动作,如果为空,则查询所有监控对象的历史动作。

最多五个

begin_time 开始时间 UNIX时间戳 可选
end_time 结束时间 UNIX时间戳 可选

返回值

参数名 参数含义 类型 备注
status 状态码 int 返回状态,0为成功
message 响应信息 string 对status的中文描述
size 返回的结果条数 int
monitored_person_alarms 被监控对象当前历史报警列表 Array
monitored_person 被监控对象的entity_name string
alarm_size 报警列表大小 int
alarms 报警列表大小 int
action 动作信息 int 1:进入围栏 2:离开围栏
time 触发报警时间 UNIX时间戳
fence_id 围栏 id int
fence_name 围栏名称 string
longitude 经度 double
latitude 纬度 double
coord_type 坐标系 string 国内为百度坐标系:bdll90;国外均为 wgs84坐标系:wgs84
radius 定位精度,单位:米 int
pre_point 上一个定位点的信息
longitude 经度 double
latitude 纬度 double
coord_type 坐标系 string 国内为百度坐标系:bdll90;国外均为 wgs84坐标系:wgs84
time 定位时间 UNIX 时间戳
radius 定位精度,单位:米 int

请求示例

fencehistoryalarm.png

返回结果示例

JSON

响应实例
 "status": 0,
 "message": "成功",
 "size": 1,
 "monitored_person_alarms": [
   {
     "monitored_person": "test01",
     "alarm_size": 2,
     "alarms": [
       {
         "action": 2,
         "time": 1481520436,
         "fence_id": 18,
         "fence_name": "test_fence",
         "longitude": 116.31320859445,
         "latitude": 40.047834383455,
         "coord_type": 3,
         "create_time": 1481520478,
         "radius": 15,
         "pre_point": {
           "longitude": 116.31320859445,
           "latitude": 40.047834383455,
           "time": 1481520431,
           "radius": 15
         }
       },
       {
         "action": 1,
         "time": 1481520538,
         "fence_id": 18,
         "fence_name": "test_fence",
         "longitude": 116.31320859445,
         "latitude": 40.047834383455,
         "coord_type": 3,
         "create_time": 1481520581,
         "radius": 15,
         "pre_point": {
           "longitude": 116.31320859445,
           "latitude": 40.047834383455,
           "coord_type":bdll90,
           "time": 1481520533,
           "radius": 15
         }
       }
     ]
   }
 ]

}