车辆充电事件查询
- 接口地址:https://api.itink.com.cn/api/soc-summary/getSocEvent.json
- 返回格式:json
- 请求方式:GET
- 请求示例:https://api.itink.com.cn/api/soc-summary/getSocEvent.json?token=您的token&carId=车架号或车牌号&beginTime=2022-09-01 13:12:00&endTime=2022-09-02 03:35:00
-
接口描述:获取车辆充电时间、经纬度、里程、SOC等数据。
-
请求参数说明
| 名称 | 是否必填 | 数据类型 | 说明 |
|---|---|---|---|
| token | 是 | string | 访问凭据;由数据开放平台提供 |
| carId | 是 | string | 车辆VIN信息,必须输入完整的17位车架号或者车牌LPN信息 |
| beginTime | 是 | string | 开始时间,格式:YYYY-MM-DDHH:MM:SS,近6个自然月 |
| endTime | 是 | string | 结束时间,格式:YYYY-MM-DDHH:MM:SS,开始结束时间差小于3天 |
- 返回参数说明
| 名称 | 数据类型 | 说明 | |
|---|---|---|---|
| code | string | 返回值:1: 成功,-1:失败 | |
| msg | string | 接口请求后的返回的中文描述 | |
| data | mileage | Long | 充电开始时的累计里程(米) |
| └ | startSoc | Double | 充电开始时的电量(保留一位小数) |
| └ | endSoc | Double | 充电结束时的电量(保留一位小数) |
| └ | startLongitude | Double | 开始经度(wgs84坐标系) |
| └ | startLatitude | Double | 开始纬度(wgs84坐标系) |
| └ | endLongitude | Double | 结束经度(wgs84坐标系) |
| └ | endLatitude | Double | 结束纬度(wgs84坐标系) |
| └ | startTime | Date | 充电开始时间 |
| └ | endTime | Date | 充电结束时间 |
- 返回内容示例
正常返回示例: { { "startTime" : "2023-10-24 07:14:57", "endTime" : "2023-10-24 07:56:47", "startLongitude" : 116.417751, "startLatitude" : 40.127785, "endLongitude" : 116.417751, "endLatitude" : 40.127785, "startSoc" : 68.0, "endSoc" : 100.0, "startMileage" : 46623500 }, { "startTime" : "2023-10-24 16:44:16", "endTime" : "2023-10-24 17:32:31", "startLongitude" : 116.288864, "startLatitude" : 40.056344, "endLongitude" : 116.28879, "endLatitude" : 40.056345, "startSoc" : 64.0, "endSoc" : 100.0, "startMileage" : 46694000 }, { "startTime" : "2023-10-25 07:07:08", "endTime" : "2023-10-25 07:08:00", "startLongitude" : 116.417691, "startLatitude" : 40.127808, "endLongitude" : 116.417691, "endLatitude" : 40.127808, "startSoc" : 69.0, "endSoc" : 69.0, "startMileage" : 46753800 }, { "startTime" : "2023-10-25 07:08:31", "endTime" : "2023-10-25 08:03:21", "startLongitude" : 116.417691, "startLatitude" : 40.127808, "endLongitude" : 116.288793, "endLatitude" : 40.05616, "startSoc" : 69.0, "endSoc" : 100.0, "startMileage" : 46753800 }, { "startTime" : "2023-10-25 15:10:19", "endTime" : "2023-10-25 16:31:09", "startLongitude" : 116.288778, "startLatitude" : 40.05627, "endLongitude" : 116.28882, "endLatitude" : 40.056235, "startSoc" : 40.0, "endSoc" : 98.0, "startMileage" : 46885800 } ], "code" : 1, "msg" : "查询成功" }