您现在的位置: 开发 > 猎鹰轨迹服务 > 开发指南 > API文档 > 轨迹行为分析

轨迹行为分析 最后更新时间: 2021年02月07日

简介

猎鹰对轨迹数据进行分析和处理,产出深度、有实际应用价值的分析结果,通过此接口开放给开发者。轨迹分析目前包含三大块内容:

  • 驾驶行为分析:急加速、急减速(刹车)、急转弯、超速行为
  • 停留点分析:停留次数、停留坐标、停留点地址描述、停留起始时间、停留时长

驾驶行为分析

  • 服务地址

URL

http://tsapi.amap.com/v1/track/analysis/drivingbehavior

请求方式

GET

  • 请求参数

参数名

含义

规则

是否必填

缺省值

key

高德Key

用户在高德地图官网申请Web服务API类型Key

必填

sid

服务唯一编号

sid为终端所属service唯一编号

必填

tid

终端ID

终端唯一编号

必填

trid

轨迹ID

轨迹唯一编号

必填

startTime

起始时间

开始时间,Unix时间戳(轨迹点的定位时间),需要精准到毫秒 

轨迹的起始时间

endTime

结束时间

结束时间,Unix时间戳(轨迹点的定位时间),需要精准到毫秒

轨迹的结束时间

accelerationThres

加速的加速度阈值

与该阈值比较判定是否为急加速

高德策略

decelerationThres

减速的加速度阈值

与该阈值比较判定是否为急减速

高德策略

steeringThres

向心加速度阈值

与该阈值比较判定是否为急转弯

高德策略

speedLimitThres

限速阈值

与该阈值比较判定是否为超速。取值范围【30,120】

若不填,则默认以道路实际电子眼限速为准;如果传入的阈值超出道路的限速值时,以道路电子眼限速值为判断基准。单位km/h。

以道路实际限速为标准

  • 返回参数

参数名

含义

errcode

结果状态码

errmsg

返回结果状态码描述

errdetail

错误细节

data



distance

轨迹里程,m

duration

轨迹时长,ms

aveSpeed

平均速度,单位km/h

maxSpeed

最高时速,单位km/h

harshAccelerationCount

急加速次数

harshDecelerationCount

急减速次数

harshSteeringCount

急转弯次数

harshAcceleration

急加速详细信息


points

急加速点集合


location

急加速点坐标

locateTime

急加速点时间戳,ms

acceleration

实际加速度,m/s²

initialSpeed

加速前时速,km/h

endSpeed

加速后时速,km/h

harshDeceleration

急减速详细信息


points

急减速点集合


location

急减速点坐标

locateTime

急减速点时间戳,ms

acceleration

实际加速度,m/s²

initialSpeed

减速前时速,km/h

endSpeed

减速后时速,km/h

harshSteering

急转弯详细信息


points

急转弯点集合


location

急转弯点坐标

locateTime

急转弯点时间戳,ms

centripetalAcc

实际向心加速度,m/s²

speed

转弯时速

speedLimit

超速详细信息


points

超速点集合


location

超速点坐标

locateTime

超速点时间错,ms

speed

实际时速,km/h

speedLimit

道路限速,km/h

停留点分析

  • 服务地址

URL

http://tsapi.amap.com/v1/track/analysis/staypoint

请求方式

GET

  • 请求参数

参数名

含义含义

规则

是否必填

缺省值

key

高德Key

用户在高德地图官网申请Web服务API类型Key

必填

sid

服务唯一编号

sid为终端所属service唯一编号

必填

tid

终端id

终端唯一标识

必填

trid

轨迹id

轨迹唯一标识

必填

startTime

起始时间

开始时间,Unix时间戳(轨迹点的定位时间),需要精准到毫秒 

轨迹的起始时间

endTime

结束时间

结束时间,Unix时间戳(轨迹点的定位时间),需要精准到毫秒

轨迹的结束时间

stayRadius

停留半径

在半径为stay_radius的圆形范围内停留时间超过stay_time判定为一次停留,取值范围[5,500],单位:米

20

stayTime

停留时长

在半径为stay_radius的圆形范围内停留时间超过stay_time判定为一次停留,取值范围[60,∞),单位:秒

600

mode

交通方式

driving

driving

  • 返回参数

参数名

含义

errcode

结果状态码

errmsg

返回结果状态码描述

errdetail

错误细节

data



stayPointCount

停留次数

points

停留点信息


startTime

停留开始时间,Unix时间戳,ms

endTime

停留结束时间,Unix时间戳,ms

duration

停留时长,ms

location

停留点坐标,根据停留点的位置返回一个停留概率最大的坐标

addressaddress

停留点地址描述




新用户
福利
示例
中心
常见
问题