车辆充电事件查询

  • 接口地址: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" : "查询成功"
    }