车辆行驶数据查询
- 接口地址:https://api.itink.com.cn/api/vehicle/getRunSummary.json
- 返回格式:json
- 请求方式:GET
- 请求示例:https://api.itink.com.cn/api/vehicle/getRunSummary.json?token=您的token&carId=车架号或车牌号
-
接口描述:获取车辆历史基础行驶信息,包含运行里程、时长、停车、油耗等信息。
-
请求参数说明
| 名称 | 是否必填 | 数据类型 | 说明 |
|---|---|---|---|
| token | 是 | string | 访问凭据;由数据开放平台提供 |
| carId | 是 | string | 车辆VIN信息,必须输入完整的17位车架号或者车牌LPN信息 |
| - 返回参数说明 |
| 名称 | 数据类型 | 说明 | |
|---|---|---|---|
| code | string | 返回值:1: 成功,-1:失败 | |
| msg | string | 接口请求后的返回的中文描述 | |
| data | |||
| └ | total_work_time | double | 总行驶时长(H,2位小数) |
| └ | avg_per_days_runtime | double | 日平均运行时长(H,2位小数) |
| └ | total_fuel_consumption | double | 总耗油量(L) |
| └ | total_stop_time | double | 总停车时长(H,1位小数) |
| └ | total_run_time | double | 总运行时长(H,2位小数) |
| └ | avg_velocity | double | 平均速度(KM/H,2位小数) |
| └ | total_offline_time | double | 总离线时长(H,2位小数) |
| └ | end_mileage | double | 总公里数(KM,2位小数) |
| └ | total_work_days | double | 累计行驶天数 |
| └ | avg_per_days_mileage | double | 日平均行驶里程(KM,2位小数) |
| └ | total_run_days | double | 总运行天数 |
| └ | avg_per_fuel_consumption | double | 平均百公里耗油(L,2位小数) |
| └ | valid_avg_per_fuel_consumption | boolean | 平均耗油是否有效 |
- 返回内容示例
正常返回示例: { "data" : { "total_work_time" : 11958.24, "avg_per_days_runtime" : 10.73, "total_fuel_consumption" : 134301.0, "total_stop_time" : 14782.6, "total_run_time" : 12070.18, "avg_velocity" : 28.21, "total_offline_time" : 35.88, "end_mileage" : 337343.81, "total_work_days" : 1034.0, "avg_per_days_mileage" : 299.86, "total_run_days" : 1125.0, "avg_per_fuel_consumption" : 39.81, "valid_avg_per_fuel_consumption" : "true" }, "code" : 1, "msg" : "" }