Skip to content

用户行程统计

接口说明

历史行程统计

1
GET /v1/org-user/{org_user_id}/statistics

说明

获取用户在给定统计周期内的行程统计信息。

参数

位置 名称 类型 说明
Query type string 统计周期类型
Query startTime * string 开始时间
Query endTime * string 结束时间

统计周期类型 type 的取值如下：

  • day: 天
  • week: 周
  • month: 月

响应

HTTP 状态码 类型 说明
200 StatisticsResult 统计信息
400 ErrorResult 请求参数不合法
500 ErrorResult 系统错误

示例

请求 path
1
GET /v1/org-user/100001/statistics?type=week&startTime=2021-10-01&endTime=2022-01-01
响应

HTTP 200 OK

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
{
  "userId": 307243629796,
  "orgUserId": "100001",
  "appId": "110852088",
  "statistics": [
    {
      "startTime": "2021-12-10 00:00:00",
      "endTime": "2021-12-16 23:59:59",
      "mileageInMeters": 64852,
      "eventCount": 6,
      "avgSpeedInKmh": 23.6,
      "maxSpeedInKmh": 88.6,
      "durationInSeconds": 10467,
      "score": 96.31
    },
    {
      "startTime": "2021-12-17 00:00:00",
      "endTime": "2021-12-23 23:59:59",
      "mileageInMeters": 14316,
      "eventCount": 5,
      "avgSpeedInKmh": 19.8,
      "maxSpeedInKmh": 68.9,
      "durationInSeconds": 2609,
      "score": 97.85
    }
  ]
}

数据类型说明

StatisticsResult

名称 类型 说明
appId * string APP ID
userId * long UBI SDK 用户的唯一标识
orgUserId * string 用户在接入方的账户体系中的唯一标识
statistics * [Statistics] 行程基本信息

Statistics

名称 类型 说明
startTime * string 统计周期开始时间
endTime * string 统计周期结束时间
mileageInMeters * integer 统计周期内的里程
eventCount * integer 统计周期内危险行为总数
avgSpeedInKmh * double 统计周期内平均速度
maxSpeedInKmh * double 统计周期内最高速度
durationInSeconds * integer 统计周期内行程总时长
score * double 统计周期内的综合评分