Skip to content

行程数据 OpenAPI

接口说明

行程列表

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

说明

查询用户在给定时间段的行程列表，列表按行程开始时间倒序排序。

参数

位置 名称 类型 说明
Query nextCursor string 滚动游标
Query limit integer 结果集最大记录数
Query startTime string 行程开始时间最小值
Query endTime string 行程开始时间最大值

响应

HTTP 状态码 类型 说明
200 TripListResult 行程列表
400 ErrorResult 请求参数不合法
500 ErrorResult 系统错误

示例

请求 path
1
GET /v1/org-user/100001/trips?limit=10&startTime=2021-10-01&endTime=2022-02-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
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
{
  "userId": 307243629858,
  "orgUserId": "100001",
  "appId": "110867896",
  "nextCursor": "1",
  "trips": [
    {
      "tripId": "1483656092746649600",
      "deviceId": "",
      "status": "normal",
      "eventCount": 0,
      "score": 100,
      "energy": 152,
      "mileageInMeters": 7441,
      "durationInSeconds": 962,
      "startTime": "2021-12-03 10:21:33",
      "endTime": "2021-12-03 10:37:35",
      "startPoint": {
        "lng": 119.976716,
        "lat": 31.708822
      },
      "endPoint": {
        "lng": 119.91828388297823,
        "lat": 31.68865975633168
      },
      "startPoi": "常州市达诚汽车维修有限公司",
      "endPoi": "武进中外名车维修有限公司"
    },
    {
      "tripId": "1483657391487717376",
      "deviceId": "",
      "status": "normal",
      "eventCount": 26,
      "score": 83.07,
      "energy": 2941,
      "mileageInMeters": 213808,
      "durationInSeconds": 13628,
      "startTime": "2021-10-01 15:07:12",
      "endTime": "2021-10-01 18:54:21",
      "startPoint": {
        "lng": 99.59161404079862,
        "lat": 30.283372667100693
      },
      "endPoint": {
        "lng": 100.99037407769097,
        "lat": 30.03845974392361
      },
      "startPoi": "318国道措普沟景区",
      "endPoi": "318国道"
    }
  ]
}

行程详情

1
GET /v1/org-user/{org_user_id}/trip/{trip_id}

说明

查询指定行程的详细信息，包括危险行为发生的时间与地点等。

参数

无

响应

HTTP 状态码 类型 说明
200 TripDetailResult 行程详情
400 ErrorResult 请求参数不合法
500 ErrorResult 系统错误

示例

请求 path
1
GET /v1/org-user/110852088/trip/1471465702513840128
响应

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
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
{
  "userId": 307243629858,
  "orgUserId": "100001",
  "appId": "110852088",
  "trip": {
    "tripId": "1471465702513840128",
    "deviceId": "BD772847-3352-409D-BFC9-0E181EAA",
    "status": "normal",
    "abnormalReason": "无异常",
    "os": "ios",
    "score": 90.33,
    "energy": 314,
    "mileageInMeters": 15433,
    "durationInSeconds": 2314,
    "avgSpeedInKmh": 24,
    "maxSpeedInKmh": 73.2,
    "startTime": "2021-12-16 21:02:16",
    "endTime": "2021-12-16 21:40:51",
    "coordinate": "GCJ02",
    "startPoint": {
      "lng": 116.47939778645834,
      "lat": 39.90812961154514
    },
    "endPoint": {
      "lng": 116.657734375,
      "lat": 39.90790608723958
    },
    "startPoi": "京通快速路佳兆业广场",
    "endPoi": "摩卡空间北京ONE",
    "isAutoStart": false,
    "isAutoEnd": false,
    "events": [
      {
        "startPoint": {
          "lng": 116.615562,
          "lat": 39.905227
        },
        "endPoint": {
          "lng": 116.618496,
          "lat": 39.905726
        },
        "type": "phone_usage",
        "startTime": "2021-12-16 21:28:47",
        "endTime": "2021-12-16 21:29:10",
        "description": "玩手机时长 22 秒"
      },
      {
        "startPoint": {
          "lng": 116.618775,
          "lat": 39.905781
        },
        "endPoint": {
          "lng": 116.632438,
          "lat": 39.906369
        },
        "type": "phone_usage",
        "startTime": "2021-12-16 21:29:22",
        "endTime": "2021-12-16 21:30:30",
        "description": "玩手机时长 01:08"
      }
    ]
  }
}

数据类型说明

TripListResult

名称 类型 说明
appId * string APP ID
userId * long UBI SDK 用户的唯一标识
orgUserId * string 用户在接入方的账户体系中的唯一标识
nextCursor string 用于获取下一页数据的滚动游标
trips * [TripBrief] 行程基本信息

TripBrief

名称 类型 说明
tripId * string 行程 ID
deviceId * string 设备唯一标识
status * string 行程状态
eventCount * integer 危险行为数量
score * double 行程评分
energy * integer 节能减排量，单位：克
mileageInMeters * integer 行驶里程，单位：米
durationInSeconds * integer 行驶时长，单位：秒
startTime * string 行程开始时间
startPoint * Coordinate 行程起点
endPoint * Coordinate 行程终点
startPoi string 行程起点地址
endPoi string 行程终点地址

Coordinate

名称 类型 说明
lng * double 经度
lat * double 纬度

TripDetailResult

名称 类型 说明
appId * string APP ID
userId * long UBI SDK 用户的唯一标识
orgUserId * string 用户在接入方的账户体系中的唯一标识
trip * TripDetail 行程详细信息

TripDetail

名称 类型 说明
tripId * string 行程 ID
deviceId * string 设备唯一标识
status * string 行程状态
abnormalReason * string 行程异常的原因
os * string 操作系统，android: Android ios: iOS
score * double 行程评分
energy * integer 节能减排量，单位：克
avgSpeedInKmh * double 平均速度
maxSpeedInKmh * double 最高速度
mileageInMeters * integer 行驶里程，单位：米
durationInSeconds * integer 行驶时长，单位：秒
startTime * string 行程开始时间
coordinate * string 坐标系统，WGS84 或 GCJ02
startPoint * Coordinate 行程起点
endPoint * Coordinate 行程终点
startPoi string 行程起点地址
endPoi string 行程终点地址
isAutoStart * boolean 行程是否自动开始
isAutoEnd * boolean 行程是否自动结束
events * [Event] 危险行为列表

Event

名称 类型 说明
startPoint * Coordinate 危险行为开始坐标
endPoint * Coordinate 危险行为结束坐标
type * string 危险行为类型
startTime * string 危险行为开始时间
endTime * string 危险行为结束时间
description * string 危险行为文字描述

危险行为类型 type 的定义如下:

  • brake: 急刹车
  • throttle: 急加速
  • corner_left: 急转弯（左转）
  • corner_right: 急转弯（右转）
  • speeding: 超速
  • phone_call: 打电话
  • phone_usage: 玩手机
  • night_driving: 夜间行驶
  • tired_driving: 疲劳驾驶