车辆行驶数据
车辆行驶数据¶
- 描述:
获取车辆历史基础行驶信息,包含运行里程、时长、停车、油耗等信息。 - 接口地址:
https://api.itink.com.cn/api/vehicle/getRunSummary.json - 请求方式:
GET - 请求参数说明:
| 名称 | 是否必填 | 数据类型 | 说明 | |
|---|---|---|---|---|
| token | 是 | string | 访问凭据;由车联网平台提供 | |
| carId | 是 | string | 车辆VIN信息,必须输入完整的17位车架号或者车牌LPN信息 |
- 请求示例:
https://api.itink.com.cn/api/vehicle/getRunSummary.json?token=您的token&carId=车架号或车牌号 - 返回格式:
Json - 返回参数说明:
| 名称 | 数据类型 | 说明 | |
|---|---|---|---|
| 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, "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, "avg_per_days_mileage":299.86, "total_run_days":1125, "avg_per_fuel_consumption":39.81, "valid_avg_per_fuel_consumption":"true" }, "code":1, "msg":"" }