Skip to content

驾驶行为评分 OpenAPI

接口说明

查询用户驾驶行为评分

1
GET /v1/org-user/{org_user_id}/safety-score

说明

查询用户最新的驾驶行为评分。

注意

用户的驾驶行为评分每天更新一次,当天可查询到使用昨日用户数据更新的评分。

参数

位置 名称 类型 说明
Query interval * integer 统计周期,30 或 90

响应

HTTP 状态码 类型 说明
200 SafetyScoreResult 用户驾驶评分
404 ErrorResult 未找到该用户的驾驶行为评分
500 ErrorResult 系统错误

示例

请求 path
1
GET /v1/org-user/12345678/safety-score?interval=30
响应

HTTP 200 OK

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
{
  "appId": "110852088",
  "orgUserId": "12345678",
  "userId": 307243629769,
  "score": {
    "evaluationTime": "2022-01-03 03:15:00",
    "startTime": "2021-12-04 00:00:00",
    "endTime": "2022-01-03 00:00:00",
    "safetyScore": 100
  }
}

数据类型说明

SafetyScoreResult

名称 类型 说明
appId * string APP ID
userId * long UBI SDK 用户的唯一标识
orgUserId * string 用户在接入方的账户体系中的唯一标识
score * SafetyScore 用户驾驶行为评级

SafetyScore

名称 类型 说明
evaluationTime * string 用户驾驶行为评分的计算时间
startTime * long 统计周期的开始时间
endTime * string 统计周期的结束时间
safetyScore * double 驾驶行为评分 (0 ~ 100),评分越高驾驶习惯越好
tripCount int 用户在统计周期内的行程数目
distractedDriving double 分心驾驶(打电话,玩手机)占比
eveningRushHour double 晚高峰(17点到20点)驾驶时长占比
acclongAbs1 double 驾驶过程中,纵向加速度的绝对值>1m/s的占比
weekdayDriving double 工作日(周一到周五)驾驶时长占比
lowSpeed double 低速驾驶(0-20km/h)占比