您当前的位置: 鹰眼Web API v2.0 > 接口说明 > analysis
analysis

简介

鹰眼轨迹分析接口是一套开发者自有轨迹数据挖掘的接口服务,目前提供两个功能:

1. 停留点分析

2. 驾驶行为分析

坐标系的说明

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


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


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


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


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


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

staypoint——停留点查询

接口说明

查询entity在指定时间段内的停留点。

注:设备在半径20米范围内滞留10分钟以上,被认为是一次停留,将取一个代表性坐标作为停留点。

请求URI

http://api.map.baidu.com/trace/v2/analysis/staypoint

HTTP请求方式

GET

请求参数

参数名 参数含义 类型 备注
ak 用户的ak,授权使用 string 必选
service_id service的ID,作为其唯一标识 Int 必选
entity_name entity名称,作为其唯一标识。 string(128) 必选。
start_time 开始时间 UNIX时间戳 必选
end_time 结束时间 UNIX时间戳 必选

返回值说明

参数名 参数含义 类型 备注
status 状态码 int 返回状态,0为成功
message 响应信息 string 对status的中文描述
staypoint_num 停留次数 int 本段行程中停留次数
stay_points 停留记录列表 array 数组中每个元素代表一次停留,记录一个停留点坐标
start_time 停留开始时间 UNIX时间戳
end_time 停留结束时间 UNIX时间戳
duration 停留时长 int 单位:秒
stay_point 停留点 dict
longitude 经度 double
latitude 纬度 double
coord_type 坐标类型 int(1-3) 1:GPS经纬度坐标2:国测局加密经纬度坐标 3:百度加密经纬度坐标。对于国内的轨迹返回的都是3:百度加密经纬度坐标

请求示例

http://api.map.baidu.com/trace/v2/analysis/staypoint?ak=用户的ak&service_id=用户的service_id&entity_name=car_plate&start_time=1467734400&end_time=1467817200

返回值示例

JSON

响应实例
 {
   status: 0,
   message: "成功",
   staypoint_num: 3,
   stay_points: [
  {
   start_time: 1464164829,
   end_time: 1464166832,
   duration: 2003,
   stay_point: {
       longitude: 113.22167932597,
       latitude: 23.411219209009,
       coord_type: 3
    }
  },
  {
   start_time: 1464170138,
   end_time: 1464171664,
   duration: 1526,
   stay_point: {
       longitude: 113.20923398543,
       latitude: 23.411707425027,
       coord_type: 3
   }
  },
  {
   start_time: 1464172067,
   end_time: 1464172952,
   duration: 885,
   stay_point: {
       longitude: 113.207836,
       latitude: 23.40664,
       coord_type: 3
    }
  }
 ]
}

drivingbehavior——驾驶行为分析

接口说明

查询entity在指定时间段内的驾驶行为。

驾驶行为包括:

1. 总体信息:起终点信息、里程、耗时、平均速度、最高速度

2. 异常信息:超速、急加速、急刹车、急转弯

请求URI

http://api.map.baidu.com/trace/v2/analysis/drivingbehavior

HTTP请求方式

GET

请求参数

参数名 参数含义 类型 备注
ak 用户的ak,授权使用 string 必选
service_id service的ID,作为其唯一标识 Int 必选
entity_name entity名称,作为其唯一标识。 string(128) 必选。
start_time 开始时间 UNIX时间戳 必选
end_time 结束时间 UNIX时间戳 必选

返回值

参数名 参数含义 类型 备注
status 状态码 int 返回状态,0为成功
message 响应信息 string 对status的中文描述
distance 行程里程 double 单位:米
duration 行程耗时 int 单位:秒
average_speed 平均时速 double 单位:km/h
max_speed 最高时速 double 单位:km/h
speeding_num 超速次数 int
harsh_acceleration_num 急加速次数 int
harsh_breaking_num 急刹车次数 int
harsh_steering_num 急转弯次数 int
start_point 起点信息
longitude 经度 double
latitude 纬度 double
coord_type 坐标类型 int(1-3) 1:GPS经纬度坐标2:国测局加密经纬度坐标 3:百度加密经纬度坐标。

对于国内的轨迹返回的都是3:百度加密经纬度坐标

loc_time 定位时间 UNIX时间戳
address 起点地址
end_point 终点信息
longitude 经度 double
latitude 纬度 double
coord_type 坐标类型 int(1-3) 1:GPS经纬度坐标2:国测局加密经纬度坐标 3:百度加密经纬度坐标。

对于国内的轨迹返回的都是3:百度加密经纬度坐标

loc_time 定位时间 UNIX时间戳
address 终点地址
speeding 超速记录集合 array 超速记录集合是一个数组,数组中的每一项代表一次超速记录
超速记录 array 超速记录本身是一个数组,数组中包括此次超速的起点和终点两个轨迹点。
超速点 dict 一条超速记录中的超速起点或终点
longitude 经度 double
latitude 纬度 double
coord_type 坐标类型 string bd09ll(百度经纬度坐标)、gcj02(国测局加密坐标)、wgs84(gps设备获取的坐标)。目前对于国内的轨迹,返回的轨迹都是百度加密经纬度坐标。
loc_time 定位时间 UNIX时间戳
actual_speed 实际行驶时速 double 单位:km/h
limit_speed 所在道路限定最高时速 double 单位:km/h
harsh_acceleration 急加速记录集合
急加速记录 dict
longitude 经度 double
latitude 纬度 double
coord_type 坐标类型 string bd09ll(百度经纬度坐标)、gcj02(国测局加密坐标)、wgs84(gps设备获取的坐标)。目前对于国内的轨迹,返回的轨迹都是百度加密经纬度坐标。
loc_time 定位时间 UNIX时间戳
acceleration 实际加速度 double
initial_speed 加速前时速 double 单位:km/h
end_speed 加速后时速 double 单位:km/h
harsh_breaking 急刹车记录集合
急刹车记录 dict
longitude 经度 double
latitude 纬度 double
coord_type 坐标类型 string bd09ll(百度经纬度坐标)、gcj02(国测局加密坐标)、wgs84(gps设备获取的坐标)。目前对于国内的轨迹,返回的轨迹都是百度加密经纬度坐标。
loc_time 定位时间 UNIX时间戳
acceleration 实际加速度 double 单位:m/s^2
initial_speed 刹车前时速 double 单位:km/h
end_speed 刹车后时速 double 单位:km/h
harsh_steering 急转弯记录集合
急转弯记录 dict
longitude 经度 double
latitude 纬度 double
coord_type 坐标类型 string bd09ll(百度经纬度坐标)、gcj02(国测局加密坐标)、wgs84(gps设备获取的坐标)。目前对于国内的轨迹,返回的轨迹都是百度加密经纬度坐标。
loc_time 定位时间 UNIX时间戳
centripetal_acceleration 向心加速度 double 单位:m/s^2
turn_type 转向类型 string 取值范围:unknow(方向未知),left(左转),right(右转)
speed 转向时速 double 单位:km/h

请求示例

http://api.map.baidu.com/trace/v2/analysis/drivingbehavior?ak=用户的ak&service_id=用户的service_id&entity_name=car_plate&start_time=1467734400&end_time=1467817200

返回示例

JSON

响应示例

{

status: 0,
message: "成功",
distance: 61744.609006319,
duration: 23568,
average_speed: 9.4314575875233,
max_speed: 54.9,
start_point: {
   longitude: 113.24471412903,
   latitude: 23.405204706192,
   coord_type: 3,
   loc_time: 1464149553,
   address: "马鞍山公园(地铁站)附近25米"
},
end_point: {
   longitude: 113.20774073303,
   latitude: 23.406671233485,
   coord_type: 3,
   loc_time: 1464173121,
   address: "新凤凰酒店东112米"
},
speeding_num: 2,
harsh_acceleration_num: 1,
harsh_breaking_num: 1,
harsh_steering_num: 3,
speeding: [
[
 {
    longitude: 113.24100205065,
    latitude: 23.412706344614,
    coord_type: 3,
    loc_time: 1464149867,
    actual_speed: 21.6,
    limit_speed: 15
 },
 {
    longitude: 113.24198745703,
    latitude: 23.412683720093,
    coord_type: 3,
    loc_time: 1464150340,
    actual_speed: 18.9,
    limit_speed: 15
 }
],
[
 {
    longitude: 113.2379268869,
    latitude: 23.419198232806,
    coord_type: 3,
    loc_time: 1464150995,
    actual_speed: 15.3,
    limit_speed: 15
 },
 {
    longitude: 113.23551855949,
    latitude: 23.420734738893,
    coord_type: 3,
    loc_time: 1464151486,
    actual_speed: 16.2,
    limit_speed: 15
 }
],
],
harsh_acceleration: [
 {
    longitude: 113.23505718408,
    latitude: 23.415670302452,
    coord_type: 3,
    loc_time: 1464151621,
    acceleration: 3.9347222222222,
    initial_speed: 5.4,
    end_speed: 33.73
 }
],
harsh_breaking: [
 {
    longitude: 113.21355843102,
    latitude: 23.410533082252,
    coord_type: 3,
    loc_time: 1464167499,
    acceleration: -3.75,
    initial_speed: 13.5,
    end_speed: 0
 }
],
harsh_steering: [
 {
    longitude: 113.23536366944,
    latitude: 23.415997495116,
    coord_type: 3,
    loc_time: 1464158361,
    centripetal_acceleration: 42.081624991152,
    turn_type: "left",
    speed: 19.8
 },
 {
    longitude: 113.24036159664,
    latitude: 23.415169028634,
    coord_type: 3,
    loc_time: 1464158512,
    centripetal_acceleration: 19.256219588206,
    turn_type: "left",
    speed: 19.8
 },
 {
    longitude: 113.22883765361,
    latitude: 23.409799328344,
    coord_type: 3,
    loc_time: 1464159414,
    centripetal_acceleration: 5.2597602426213,
    turn_type: "left",
    speed: 25.2
 }
]
}