HTTP协议接入
所有文档

          度行·智能车辆云 DuGo

          HTTP协议接入

          如果您创建新项目时选择HTTP协议作为车辆设备连接DuGo的接入方式,可以根据本文档构造HTTP请求,使用HTTP协议连接DuGo并快速上报车辆数据到DuGo平台。

          请求

          鉴权和认证

          使用HTTP协议上报数据需要请求发起人具有合法的权限,您可以参考[鉴权和认证]((Reference/鉴权认证机制/简介.md)在您的HTTP请求中加入百度智能云鉴权认证字符串(Authorization)。

          请求方式

          方法 URL
          POST https://ivc.gz.baidubce.com/v1/data

          请求参数

          参数名 参数含义 类型 是否必填 备注
          points 点数组 array point结构体

          说明:您可以同时为多个vehicle上传多个数据点,每个vehicle的数据是数据列表(points)里的一项。

          Point结构体

          参数名 参数含义 参数类型 是否必填 备注
          locTime 定位时设备的时间 Unix时间戳 输入的locTime不能大于当前服务端时间10分钟以上,即不支持存未来的轨迹点
          vehicleId 车辆唯一标识 String(0-128) 车辆的唯一标识,如vin码、车机终端手机号等
          data 需要上传的车辆数据 Map<String, Object> key、value对, value 可以是String, Integer 或 Double latitude, longitude 为GPS信息

          预定义字段

          如果您需要使用地图服务,相关参数名(即data数据结构里map的key)必须使用下述预定义字段。

          字段名 意义 类型 备注
          latitude 纬度 Double(-90.0 , +90.0)
          longitude 经度 Double(-180.0 , +180.0)
          speed 速度 Double 单位:km/h
          direction 方向 Integer 取值规则:范围为[0,359],0度为正北方向,顺时针
          height 高度 Double 单位米
          radius 定位精度,GPS或定位SDK返回的值 Double 单位米
          coordTypeInput 坐标类型 String 该字段用于描述上传的坐标类型。可选值为: wgs84:GPS 坐标 gcj02:国测局加密坐标 bd09ll:百度经纬度坐标,不传则默认百度坐标系

          自定义字段

          您上传的数据(data) 中,除了预定义字段,还可以填写自定义字段,并且可以自定义字段名和信号长度,例:上传车速信息 "data" : {"XX_speed" : 31.20},车速的字段名定义为XX_speed, 上传的车速的值为31.20,但因为没用到预定义字段“speed”,故不会将这个值作为地图服务的参考数据,仅作为普通数据保存。 详情请参考请求示例。

          请求示例

          POST /v1/data HTTP/1.1
          HOST: ivc.gz.baidubce.com
          Authorization: {authorization}
          Content-Type: application/json;
          x-bce-date: 2018-06-08T16:49:51Z
          {
              "points": [
                  {
                      "locTime": 1497578785,
                      "vehicleId": "13288886666",
                      "data": {
                          "ppp": 1,
                          "ddd": 1.2,
                          "latitude": 31.20374,
                          "longitude": 121.546963
                      }
                  },
                  {
                      "locTime": 1497578786,
                      "vehicleId": "13266668888",
                      "data": {
                          "ccc": 1.2,
                          "latitude": 31.20374,
                          "longitude": 121.546963
                      }
                  }
              ]
          }

          返回示例

          HTTP/1.1 204 No Content
          x-bce-request-id: af7b11b0-814f-4a33-bd11-f7a2138ca3b5

          接口限制

          请求车辆数限制

          一个请求当中车辆总数不能超过5000辆。

          请求大小限制

          一个请求大小不能超过1MB。

          上一篇
          概述
          下一篇
          MQTT协议接入