车辆充电事件查询

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