度行·智能车辆云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协议接入