度行·智能车辆云DuGo

    数据查询接口

    概述

    欢迎使用百度智能云车联网车载设备、分组、地图、车辆数据、轨迹查询服务。

    查询服务是一套设备、分组、车辆数据、地图、轨迹数据管理服务,提供WebAPI供开发者便捷接入,对设备、设备分组、车辆(包括车影子)、地图地址正逆解析以及轨迹进行查询。基于查询服务提供的接口和云端服务,开发者可以迅速构建一套完全属于您自己的完整、精准且高性能的数据查询系统

    您可以使用本文档介绍的API对查询服务进行灵活的操作。

    接口概览

    接口类型 描述
    设备查询接口 设备查询支持对设备的实时和历史信息查询。该组接口包括设备信息查询、按关键字查询用户的设备列表、设备实时状态查询 、分组设备实时状态查询
    分组查询接口 分组查询支持对当前所有合法的分组信息进行查询。该组接口包括查询分组
    车辆数据管理接口 车辆数据查询支持对车辆以及车影子的实时、历史信息查询。该组接口包括静态数据上报、动态数据上报、查询车辆在线状态、单个影子查询、多个影子查询、车辆历史数据查询
    地图服务管理接口 地图服务支持对地址的正逆编码、地理信息查询。该组接口包括:地理位置编码、地理位置解码、查询gps对应地理信息、查询批量gps对应地理信息
    轨迹管理接口 轨迹管理支持对车辆轨迹的具体信息进行查询。该组接口包括:查询车辆实时轨迹点 查询车辆轨迹、查询轨迹里程、停留点查询、驾驶行为分析

    数据查询错误码

    错误码 错误消息 HTTP状态码 描述
    vehicleNotExist 车辆id不存在,请确认是否已经绑定成功 400 车辆id不存在,请确认是否已经绑定成功
    InvalidRequestParam 请求参数有误:{message} 400 请求参数有误:{message}
    NotAuthorizedException 授权不足 403 授权不足
    InvalidParam 传入数据不符合规范:{message} 400 传入数据不符合规范:{message}
    ServerInternalError 服务内部错误:{message} 500 服务内部错误:{message}
    deviceShadowNotExist 设备影子不存在 400 设备影子不存在
    groupNotExist 分组不存在 400 分组不存在
    DataError 数据异常:{message} 500 数据异常:{message}
    NotAuthorized 抱歉,您的授权不足 403 抱歉,您的授权不足
    SomeVehicleNotBindInstance 抱歉,您的车辆没有绑定已购买的实例 403 抱歉,您的车辆没有绑定已购买的实例
    AttributeQuotaNotEnough 抱歉,您的属性配额不足 400 抱歉,您的属性配额不足
    VehicleIdsInMultiProjects 车辆ID列表属于不同项目 400 车辆ID列表属于不同项目
    MapServiceError 地图服务异常,请稍后重试 500 地图服务异常,请稍后重试

    设备查询接口

    设备信息查询

    接口描述:本接口用于设备信息查询

    • 查询当前账号的设备信息

    请求结构

    GET /v1/device/?aliasName={aliasName}&groupId={groupId}&deviceId={deviceId}&pk={pk}&dn={dn}&activateStatus={activateStatus}&pageNo={pageNo}&pageSize={pageSize}
    Host: ivc.gz.baidubce.com
    Authorization: authorization string
    Content-Type: application/json
    x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
    x-bce-date: 2019-03-06T03:39:34Z

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    aliasName String Query参数 设备别名
    groupId String Query参数 分组ID
    deviceId String Query参数 设备ID,格式pk_dn
    pk String Query参数 设备型号
    dn String Query参数 设备名称
    activateStatus String Query参数 设备激活状态,非激活 INACTIVE 激活 ACTIVE
    pageNo int Query参数 页码,默认值为1
    pageSize int Query参数 页面偏移量,取值范围0~100,默认值为10

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    参数名称 类型 描述
    data List<Device> 设备数据列表
    totalCount int 设备总数
    pageNo int 页码,默认值为1
    pageSize int 页码偏移量,默认值为10

    错误码

    无。

    请求示例

    GET /v1/device/?aliasName=a0a440fb9ea5&groupId=group123&deviceId=QGON_10000&pk=QGON&dn=10000&activateStatus=ACTIVE&pageNo=1&pageSize=100
    Host: ivc.gz.baidubce.com
    Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
    Content-Type: application/json;charset=utf-8
    x-bce-request-id: 074c5c9a-36c3-4558-9fa1-0b3b27813af3
    x-bce-date: 2019-11-25T404:02:05Z

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Date: Tus, 28 Nov 2019 03:28:11 GMT
    X-Bce-Request-Id: 275e986f-ed77-4cbc-b505-64325cdef399
    Server: BWS
    {
           "data":[
          {
            "deviceId":"QGON_10000",
            "pk":"QGON",
            "dn":"10000",
            "endpoint":"endpoint11",
            "aliasName":"erg",
            "schemaId":"schema121",
            "groupId":"group0",
            "activateStatus":"ACTIVE",
            "joinGroupTime":2018-12-01T08:00:00Z,
            "createTime":2018-12-01T08:00:00Z,
            "updateTime":2019-11-01T08:00:00Z
         }
        ],
            "totalCount":1,
            "pageNo":1,
            "pageSize":1000
    }

    按关键字查询用户的设备列表

    接口描述:本接口用于根据在设备别名、PK、DN、分组别名中出现的关键字查询用户的设备列表

    注意事项

    本接口用于按设备名,PK,DN或分组名查询设备列表

    • 查询的设备需要已被绑定,否则查找的设备id为空
    • 查询的设备ID若输入格式不合法,则查找失败

    请求结构

    GET /v1/device/keywords?keywords={keywords}&pageNo={pageNo}&pageSize={pageSize}
    Host: ivc.gz.baidubce.com
    Authorization: authorization string
    Content-Type: application/json
    x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
    x-bce-date: 2019-11-28T09:02:05Z

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    keywords String Query参数 在设备别名、PK、SN、分组别名中出现的关键字
    pageNo int Query参数 页码,默认值为1
    pageSize int Query参数 页面偏移量,取值范围0~100,默认值为10

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    参数名称 类型 描述
    data List<Device> 设备数据列表
    totalCount int 设备总数
    pageNo int 页码,默认值为1
    pageSize int 页码偏移量,默认值为10

    错误码

    错误码 错误描述 HTTP状态码 中文解释
    vehicleNotExist 车辆id不存在,请确认是否已经绑定成功 400 车辆id不存在,请确认是否已经绑定成功
    InvalidRequestParam ID格式不合法 400 ID格式不合法
    NotAuthorizedException 授权不足 403 授权不足
    InvalidParam 传入数据不符合规范 400 传入数据不符合规范
    ServerInternalError 无默认分组 500 无默认分组
    deviceShadowNotExist 设备影子不存在 400 设备影子不存在

    请求示例

    GET /v1/device/keywords?keywords=9psk&pageNo=1&pageSize=2
    Host: ivc.gz.baidubce.com
    Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
    Content-Type: application/json
    x-bce-request-id: 074c5c9a-36c3-4558-9fa1-0b3b27813af3
    x-bce-date: 2019-11-25T404:02:05Z

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Date: Tus, 28 Nov 2019 03:28:11 GMT
    X-Bce-Request-Id: d8752367-38e8-45e4-b4c7-e53be3137ce5
    Server: BWS
    {
              "data":[
              {
                      "deviceId":"QGON_10000",
                      "pk":"QGON",
                      "dn":"10000",
                      "aliasName":"erg",
                      "groupId":"9216bcff6be5427a840dde2806a908f0",
                      "groupName":"groupname",
                      "status":"INACTIVE",
                      "batchId":"batchId111",
                      "createTime":2018-12-01T08:00:00Z,
                      "expireTime":2018-12-01T08:00:00Z
          
              }
              ],
             "totalCount":1,
             "pageNo":1,
             "pageSize":100
    }
    
       

    设备实时状态查询

    接口描述:本接口用于查询指定设备的实时数据(设备影子)。

    注意事项

    本接口用于查询指定设备得实时数据

    • 指定的设备需要已经绑定,否则查询失败

    请求结构

    GET v1/device/shadow?deviceId={deviceId}&needUpdateTime={needUpdateTime}
    Host: ivc.gz.baidubce.com
    Authorization: authorization string
    Content-Type: application/json; charset=utf-8 
    x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
    x-bce-date: 2019-03-06T03:39:34Z

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    deviceId String Query参数 设备ID
    needUpdateTime boolean Query参数 是否查询设备数据最后更新时间

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    参数名称 类型 描述
    data JsonNode 设备实时数据
    lastUpdatedTime JsonNode 设备数据每个属性最后更新时间,只有当needUpdateTime设置为true才会返回该字段

    错误码

    错误码 错误描述 HTTP状态码 中文解释
    vehicleNotExist 车辆id不存在,请确认是否已经绑定成功 400 车辆id不存在吗,请确认是否已经绑定成功
    deviceShadowNotExist 设备影子不存在 400 设备影子不存在

    请求示例

    GET /v1/device/shadow?deviceId=QGON_10000&needUpdateTime=true
    Host: ivc.gz.baidubce.com
    Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
    Content-Type: application/json;charset=utf-8
    x-bce-request-id: 074c5c9a-36c3-4558-9fa1-0b3b27813af3
    x-bce-date: 2019-11-25T404:02:05Z

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Date: Tus, 28 Nov 2019 03:28:11 GMT
    X-Bce-Request-Id: 275e986f-ed77-4cbc-b505-64325cdef399
    Server: BWS
    {
       "data":{
             "vehicleId":"QGON_10000",
             "groupId":"c1c8b048472c436f85c8981466913b93",
             "speed":103.55,
             "latitude":73.58,
             "longitude":40.10,
             "height":62.62
              },
        "lastUpdatedTime":{
             "speed":103.55,
             "latitude":73.58,
             "longitude":40.10,
             "height":62.62
            }
    }

    分组设备实时状态查询

    接口描述:本接口用于根据分组ID查询分组设备的实时状态。

    注意事项

    本接口用于根据分组ID查询分组设备的实时状态

    • 输入的分组ID信息必须存在,否则查询信息失败

    请求结构

    GET v1/device/shadow/group?groupId={groupId}&needUpdateTime={needUpdateTime}&pageNo={pageNo}&pageSize={pageSize}
    Host: ivc.gz.baidubce.com
    Authorization: authorization string
    Content-Type: application/json; charset=utf-8 
    x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
    x-bce-date: 2019-03-06T03:39:34Z

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    groupId String Query参数 分组ID
    needUpdateTime boolean Query参数 是否查询设备数据最后更新时间
    pageNo int Query参数 页号
    pageSize int Query参数 页大小

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    参数名称 类型 描述
    amount long 数据量
    pageNo int 页号
    pageSize int 页大小
    list List<DeviceShadow> 设备数据列表

    错误码

    错误码 错误描述 HTTP状态码 中文解释
    groupNotExist 分组不存在 400 分组不存在

    请求示例

    GET /v1/device/shadow/group?groupId=a469877aaaa44ae1a91473e9ee936d6a&needUpdateTime=true&pageNo=1&pageSize=3
    Host: ivc.gz.baidubce.com
    Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
    Content-Type: application/json;charset=utf-8
    x-bce-request-id: 074c5c9a-36c3-4558-9fa1-0b3b27813af3
    x-bce-date: 2019-11-25T404:02:05Z

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Date: Tus, 28 Nov 2019 03:28:11 GMT
    X-Bce-Request-Id: 275e986f-ed77-4cbc-b505-64325cdef399
    Server: BWS
    {
       "amount":100,
       "pageNo":1,
       "pageSize":3,
       "list":[
        {
            "data":{
                "vehicleId":"QGON_10000",
                "groupId":"a469877aaaa44ae1a91473e9ee936d6a",
                "speed":103.55,
                "latitude":73.58,
                "longitude":40.17,
                "height":62.62
            },
            "lastUpdatedTime":{
                "speed":103.55,
                "latitude":73.58,
                "longitude":40.17,
                "height":62.62
            }
        },
        {
            "data":{
                "vehicleId":"QGON_10020",
                "groupId":"a469877aaaa44ae1a91473e9ee936d6a",
                "speed":103.55,
                "latitude":73.58,
                "longitude":40.10,
                "height":62.62
            },
            "lastUpdatedTime":{
                "speed":103.55,
                "latitude":73.58,
                "longitude":40.10,
                "height":62.62
            }
        },
        {
            "data":{
                "vehicleId":"QGON_10234",
                "groupId":"a469877aaaa44ae1a91473e9ee936d6a",
                "speed":103.09,
                "latitude":73.49,
                "longitude":40.07,
                "height":62.84
            },
            "lastUpdatedTime":{
                "speed":103.09,
                "latitude":73.49,
                "longitude":40.07,
                "height":62.84
            }
        }
     ]
    }

    分组查询接口

    查询分组

    接口描述:本接口用于查询当前账号中的分组表

    请求结构

    GET /v1/group?groupName={groupName}&pageNo={pageNo}&pageSize={pageSize}
    Host: ivc.gz.baidubce.com
    Authorization: authorization string
    Content-Type: application/json;charset=utf-8
    x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
    x-bce-date: 2019-03-06T03:39:34Z

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    groupName String Query参数 分组名称
    pageNo int Query参数 页码,大于0
    pageSize int Query参数 页面偏移量,取值范围0~1000

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    参数名 参数类型 说明
    totalCount int 总数
    pageNo int 页码,大于0
    pageSize int 页面偏移量,取值范围0~1000
    data List<Group> 设备数据列表

    错误码

    无。

    请求示例

    GET /v1/group?groupName=50bb81103f0e496c9f50015b04a6f9ac&pageNo=1&pageSize=2
    Host: ivc.gz.baidubce.com
    Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
    Content-Type: application/json;charset=utf-8
    x-bce-request-id: 074c5c9a-36c3-4558-9fa1-0b3b27813af3
    x-bce-date: 2019-11-25T404:02:05Z

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Content-Length: 0
    Date: Tus, 28 Nov 2019 03:28:11 GMT
    X-Bce-Request-Id:7eb57c78-6d0f-4770-96ca-7013ee5d20ca
    Server: BWS
    {
        "data":[
            {
                "userId":"f56360960f15478c8a0933fbcded5496",
                "groupId":"289bc56dad9f4e4d930c1b6e1f17f705",
                "groupName":"887401e434744f6b854bda56a51696b9",
                "count":0,
                "createTime":2018-12-01T08:00:00Z,
                "updateTime":2019-12-01T08:00:00Z
            },
            {
                "userId":"f56360960f15478c8a0933fbcded5496",
                "groupId":"1a0dc3660df640fd9488f0e69f347d80",
                "groupName":"662207125bb14b99a70415813d3b24cc",
                "count":0,
                "createTime":2019-10-01T08:00:00Z,
                "updateTime":2019-11-11T08:00:00Z
            }
        ],
        "totalCount":2,
        "pageNo":1,
        "pageSize":1000
    }

    车辆数据管理接口

    查询车辆在线状态

    接口描述:本接口用于车辆在线状态查询。

    请求结构

    POST /v1/ivc/data/shadow/onlinequery
    Host: ivc.gz.baidubce.com
    Authorization: authorization string
    Content-Type: application/json;charset=utf-8
    x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
    x-bce-date: 2019-03-06T03:39:34Z
    {
       "vehicleIds":vehicleIds
    }

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    vehicleIds List RequestBody参数 车辆ID列表

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    参数名 参数类型 说明
    data List<Vehicle> 车辆状态数据

    错误码

    错误码 错误描述 HTTP状态码 中文解释
    VehicleIdsInMultiProjects 车辆ID列表属于不同项目 400 车辆ID列表属于不同项目

    请求示例

    POST /v1/ivc/data/shadow/onlinequery
    Host: ivc.gz.baidubce.com
    Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
    Content-Type: application/json;charset=utf-8
    x-bce-request-id: 074c5c9a-36c3-4558-9fa1-0b3b27813af3
    x-bce-date: 2019-11-25T404:02:05Z
    {
       "vehicleIds": ["QGON_10000", "QGON_10880"]
    }

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Content-Length: 0
    Date: Tus, 28 Nov 2019 03:28:11 GMT
    X-Bce-Request-Id:c3d25695-697f-4b2b-a540-18f77907f486
    Server: BWS   
    {
       "data": [{
           "vehicleId": "QGON_10002",
           "status": "CONNECT"
             }, {
           "vehicleId": "QGON_10000",
           "status": "UNCONNECT"
        }]
    }

    单个车影子查询

    接口描述:本接口用于单个车影子查询

    注意事项

    本接口用于查询单个车影子。

    • 若输入的车辆ID不存在,则无法查询该车影子的信息。

    请求结构

    POST /v1/ivc/data/shadow/query
    Host: ivc.gz.baidubce.com
    Authorization: authorization string
    Content-Type: application/json;charset=utf-8
    x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
    x-bce-date: 2019-03-06T03:39:34Z
    {
       "vehicleId":vehicleId,
       "fields":fields,
       "needUpdateTime":needUpdateTime
    }

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    vehicleId String RequestBody参数 车辆ID
    fields List RequestBody参数 查询属性域,如果fields为空或者size=0默认返回全部属性
    needUpdateTime boolean RequestBody参数 是否查询车影子数据最后更新时间

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    参数名 参数类型 说明
    vehicleId String 车辆ID
    data JsonNode 车影子数据
    lastUpdatedTime JsonNode 车影子数据每个属性最后更新时间,只有当needUpdateTime设置为true才会返回该字段

    错误码

    错误码 错误描述 HTTP状态码 中文解释
    VehicleIdNotExist 车辆ID不存在 400 车辆ID不存在
    NotAuthorized 抱歉,您的授权不足 403 抱歉,您的授权不足
    ServerInternalError 系统内部错误,请稍后重试 500 系统内部错误,请稍后重试
    InvalidParam 参数不合法 400 参数不合法
    dataError 数据异常 500 数据异常

    请求示例

    POST /v1/ivc/data/shadow/query
    Host: ivc.gz.baidubce.com
    Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
    Content-Type: application/json;charset=utf-8
    x-bce-request-id: 074c5c9a-36c3-4558-9fa1-0b3b27813af3
    x-bce-date: 2019-11-25T404:02:05Z
    {
       "vehicleId" :  "QGON_10000" , 
       "fields" : [ 
        "speed" ,  "longitude" ,  "latitude" ,  "height" 
                  ] ,
        "needUpdateTime":true
    }

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Content-Length: 0
    Date: Tus, 28 Nov 2019 03:28:11 GMT
    X-Bce-Request-Id:c3d25695-697f-4b2b-a540-18f77907f486
    Server: BWS   
    {
       "vehicleId" :  "QGON_10000" , 
       "data" : { 
          "speed" : 103.55, 
          "longitude" : 73.58, 
          "latitude" : 40.10, 
          "height" : 62.62 
       } 
       "lastUpdatedTime" : {
          "vehicleId": "QGON_10000",
          "status": "UNCONNECT"
       }
    }

    多个影子查询

    接口描述:本接口用于车影子批量查询。

    注意事项

    本接口用于批量查询车影子信息。

    • 若输入的车辆ID不存在,则无法查询该车影子的信息。
    • 未经授权的用户无法进行查询操作。

    请求结构

    POST /v1/ivc/data/shadow/batchquery
    Host: ivc.gz.baidubce.com
    Authorization: authorization string
    Content-Type: application/json;charset=utf-8
    x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
    x-bce-date: 2019-03-06T03:39:34Z
    {
       "vehicleIds":vehicleIds,
       "fields":fields
    }

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    vehicleIds List RequestBody参数 车辆ID列表,要求所有车辆id属于一个项目,Size(min = 1, max = 1000)
    fields List RequestBody参数 查询属性域,如果fields为空或者size=0默认返回全部属性

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    参数名 参数类型 说明
    data JsonNode 车影子数据,默认会含有vehicleId

    错误码

    错误码 错误描述 HTTP状态码 中文解释
    VehicleIdNotExist 车辆ID不存在 400 车辆ID不存在
    NotAuthorized 抱歉,您的授权不足 403 抱歉,您的授权不足
    ServerInternalError 系统内部错误,请稍后重试 500 系统内部错误,请稍后重试
    InvalidParam 参数不合法 400 参数不合法
    dataError 数据异常 500 数据异常
    VehicleIdsInMultiProjects 车辆ID列表属于不同项目 400 车辆ID列表属于不同项目

    请求示例

    POST /v1/ivc/data/shadow/batchquery
    Host: ivc.gz.baidubce.com
    Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
    Content-Type: application/json;charset=utf-8
    x-bce-request-id: 074c5c9a-36c3-4558-9fa1-0b3b27813af3
    x-bce-date: 2019-11-25T404:02:05Z
    {
        "vehicleIds" : [ "QGON_10000" ,  "QGON_10001" ],    
        "fields" : [ 
        "speed" ,  "longitude" ,  "latitude" ,  "height" 
        ] 
    }

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Content-Length: 0
    Date: Tus, 28 Nov 2019 03:28:11 GMT
    X-Bce-Request-Id:72492aee-1470-46d0-8a4d-0dab7b8e67b7 
    Server: BWS   
    {
        "data" : [{ 
            "vehicleId" :  "QGON_10000" , 
            "speed" : 103.55, 
            "longitude" : 73.58, 
            "latitude" : 40.10, 
            "height" : 62.62 
         }, 
        { 
            "vehicleId" :  "QGON_10002" , 
            "speed" : 103.55, 
            "longitude" : 73.58, 
            "latitude" : 40.10, 
            "height" : 62.62 
        }] 
    }

    车辆历史数据查询

    接口描述:本接口用于查询车辆历史数据。

    注意事项

    本接口用于查询车辆历史数据

    • 指定的设备车辆已经绑定,否则查询失败

    请求结构

    POST v1/device/history
    Host: ivc.gz.baidubce.com
    Authorization: authorization string
    Content-Type: application/json; charset=utf-8 
    x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
    x-bce-date: 2019-03-06T03:39:34Z
    {
         "deviceId":deviceId,
         "fields":fields,
         "groupId":groupId,
         "start":start,
         "end":end,
         "order":order,
         "limit":limit,
         "marker":marker
    }

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    deviceId String RequestBody参数 设备ID
    fields List RequestBody参数 需要查询的metric的field的动态属性。fields=size must be between 1 and 1000
    groupId String RequestBody参数 分组ID
    start long RequestBody参数 起始时间,ms
    end long RequestBody参数 结束时间,ms
    order String RequestBody参数 排序方式,支持Asc和Desc,默认值为Asc
    limit int RequestBody参数 返回的结果数量限制,默认值为0
    marker String RequestBody参数 用于分页查询,从marker开始返回,应使用上一次查询返回的marker值

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    参数名称 类型 描述
    truncated boolean 是否所有数据都返回了,true表示后面还有数据,false表示后面已经没有数据,默认是false,当使用了groupBy或aggregators时,没有此项
    marker String 用于分页查询,获取下一批数据所需要传递的marker值,当truncated为true时才有此项
    dataList List<IvcTsdbDataNode> 历史数据列表

    错误码

    错误码 错误描述 HTTP状态码 中文解释
    InvalidRequestParam limit参数不能为负数;end参数不得小于start参数 400 limit参数不能为负数;end参数不得小于start参数
    deviceNotExist 设备不存在 400 设备不存在
    vehicleNotExist 车辆id不存在,请确认是否已经绑定成功 400 车辆id不存在,请确认是否已经绑定成功

    请求示例

    POST v1/device/history
    Host: ivc.gz.baidubce.com
    Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
    Content-Type: application/json;charset=utf-8
    x-bce-request-id: 074c5c9a-36c3-4558-9fa1-0b3b27813af3
    x-bce-date: 2019-11-25T404:02:05Z
    {
          "deviceId" : "QGON_10000",
          "fields" : [ "radius", "latitude", "longitude", "height", "speed"              ],
          "groupId" : "6ae26b9f20ec40b08e98255c73ef8229",
          "start" : 1575547309000,
          "end" : 1575547369000,
          "order" : "Asc",
          "limit" : 10,
          "marker" : "testMarker"
    }

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Date: Tus, 28 Nov 2019 03:28:11 GMT
    X-Bce-Request-Id: 275e986f-ed77-4cbc-b505-64325cdef399
    Server: BWS
    {
        "truncated":false,
        "dataList":[
        {
            "timestamp":1575547309000,
            "vehicleId":"QGON_10000",
            "data":{
                "radius":12.2,
                "latitude":23.34,
                "longitude":113.34,
                "height":3.5,
                "speed":67.67
            }
         },
        {
            "timestamp":1575547309000,
            "vehicleId":"QGON_10001",
            "data":{
                "radius":12.5,
                "latitude":23.45,
                "longitude":113.23,
                "height":6.4,
                "speed":58.99
            }
        }
       ]
    }

    地图服务-正逆编码

    地理位置编码

    接口描述:本接口用于地理位置编码

    • 此接口的主要功能是可以根据地址信息查询对应的经度和纬度。

    注意事项

    此接口用于地理位置查询

    • 若地址信息不符合规范,则无法查询地址具体的经度、纬度信息

    请求结构

    POST /v1/ivc/data/geocoder
    Host: ivc.gz.baidubce.com
    Authorization: authorization string
    Content-Type: application/json;charset=utf-8
    x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
    x-bce-date: 2019-03-06T03:39:34Z
    {
       "address":address
    }

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    address String RequestBody参数 地理位置

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    参数名 参数类型 说明
    latitude String 纬度
    longitude String 经度

    错误码

    错误码 错误描述 HTTP状态码 中文解释
    ServerInternalError 地图服务调用异常,请稍后重试 500 地图服务调用异常,请稍后重试
    InvalidRequestParam 地址不合法 400 地址不合法

    请求示例

    POST /v1/ivc/data/geocoder
    Host: ivc.gz.baidubce.com
    Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
    Content-Type: application/json;charset=utf-8
    x-bce-request-id: 074c5c9a-36c3-4558-9fa1-0b3b27813af3
    x-bce-date: 2019-11-25T404:02:05Z
    {
        "address": "北京市海淀区上地十街10号"
    }

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Content-Length: 0
    Date: Tus, 28 Nov 2019 03:28:11 GMT
    X-Bce-Request-Id:72492aee-1470-46d0-8a4d-0dab7b8e67b7 
    Server: BWS   
    {
        "latitude": "40.05703033345938",
        "longitude": "116.3084202915042"
    }

    地理位置解码

    接口描述:本接口用于地理位置解码

    • 此接口的主要功能是可以根据所给的经度和纬度查询到具体的地址信息。

    注意事项

    此接口用于地理位置查询

    • 若地址信息不符合规范,则无法查询地址具体的经度、纬度信息

    请求结构

    POST /v1/ivc/data/reversegeocoder
    Host: ivc.gz.baidubce.com
    Authorization: authorization string
    Content-Type: application/json;charset=utf-8
    x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
    x-bce-date: 2019-03-06T03:39:34Z
    {
       "longitude": longitude,
       "latitude": latitude
    }

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    latitude String RequestBody参数 纬度
    longitude String RequestBody参数 经度

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    参数名 参数类型 说明
    address String 地理位置

    错误码

    错误码 错误描述 HTTP状态码 中文解释
    ServerInternalError 地图服务调用异常,请稍后重试 500 地图服务调用异常,请稍后重试

    请求示例

    POST /v1/ivc/data/geocoder
    Host: ivc.gz.baidubce.com
    Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
    Content-Type: application/json;charset=utf-8
    x-bce-request-id: 074c5c9a-36c3-4558-9fa1-0b3b27813af3
    x-bce-date: 2019-11-25T404:02:05Z
    {
         "longitude": 116.3084202915042,
         "latitude": 40.05703033345938
    }

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Content-Length: 0
    Date: Tus, 28 Nov 2019 03:28:11 GMT
    X-Bce-Request-Id:72492aee-1470-46d0-8a4d-0dab7b8e67b7 
    Server: BWS   
    {
       "address": "北京市海淀区上地十街10号"
    }

    查询gps对应地理信息

    接口描述:本接口用于根据经纬度获取地址、详细地址、省市信息

    • 此接口的主要功能是可以根据所给的经度和纬度查询到具体的地址信息。

    请求结构

    GET /v1/ivc/data/reversegeocoder?coordtype={coordtype}&location={location}
    Host: ivc.gz.baidubce.com
    Authorization: authorization string
    Content-Type: application/json;charset=utf-8
    x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
    x-bce-date: 2019-03-06T03:39:34Z

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    location String Query参数 lat<纬度>,lng<经度>。 举例 "38.76623,116.43213"
    coordtype String Query参数 坐标的类型,目前支持的坐标类型包括:bd09ll(百度经纬度坐标)、bd09mc(百度米制坐标)、gcj02ll(国测局经纬度坐标,仅限中国)、wgs84ll( GPS经纬度)

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    参数名 参数类型 说明
    formattedAddress String 结构化地址信息
    addressComponent AddressComponent 行政区划信息
    location Location 地理位置

    错误码

    无。

    请求示例

    GET /v1/ivc/data/reversegeocoder?coordtype=wgs84ll&location=31.225696563611,121.49884033194
    Host: ivc.gz.baidubce.com
    Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
    Content-Type: application/json;charset=utf-8
    x-bce-request-id: 074c5c9a-36c3-4558-9fa1-0b3b27813af3
    x-bce-date: 2019-11-25T404:02:05Z

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Content-Length: 0
    Date: Tus, 28 Nov 2019 03:28:11 GMT
    X-Bce-Request-Id:72492aee-1470-46d0-8a4d-0dab7b8e67b7 
    Server: BWS   
    {
      "formatted_address": "百度上海研发中心",
      "addressComponent": [
        {
    
            "country":"中国",
            "province":"上海市",
            "city":"上海市",
            "district":"浦东新区",
            "town": "张江街道",
            "street": "纳贤路",
            "street_number":"纳贤路701号",
            "adcode": 310101
        }
       ],
       "location":{
             "lng":31.225696563611,
             "lat":121.49884033194
       }
    }

    查询批量gps对应地理信息

    接口描述:本接口用于根据经纬度批量获取地址、详细地址、省市信息

    • 此接口的主要功能是可以根据所给的经度和纬度查询到具体的地址信息,批量获取带行政区的逆地理编码

    请求结构

    GET /v1/ivc/data/reversegeocoder/batch?coordtype={coordtype}&locations={locations}
    Host: ivc.gz.baidubce.com
    Authorization: authorization string
    Content-Type: application/json;charset=utf-8
    x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
    x-bce-date: 2019-03-06T03:39:34Z

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    locations String Query参数 lat<纬度>,lng<经度>。 举例 "38.76623,116.43213"
    coordtype String Query参数 坐标的类型,目前支持的坐标类型包括:bd09ll(百度经纬度坐标)、bd09mc(百度米制坐标)、gcj02ll(国测局经纬度坐标,仅限中国)、wgs84ll( GPS经纬度)

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    参数名 参数类型 说明
    result List<Result> 结果列表

    错误码

    无。

    请求示例

    GET /v1/ivc/data/reversegeocoder?coordtype=wgs84ll&locations=31.225696563611,121.49884033194
    Host: ivc.gz.baidubce.com
    Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
    Content-Type: application/json;charset=utf-8
    x-bce-request-id: 074c5c9a-36c3-4558-9fa1-0b3b27813af3
    x-bce-date: 2019-11-25T404:02:05Z

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Content-Length: 0
    Date: Tus, 28 Nov 2019 03:28:11 GMT
    X-Bce-Request-Id:72492aee-1470-46d0-8a4d-0dab7b8e67b7 
    Server: BWS   
    {
      "result":[
         {
           "status":1,
           "msg":"sys"
           "location:"38.76623,116.43213"  
           "formatted_address“: "百度上海研发中心"
           "addressComponent": {
                "country":"中国",
                "province":"上海市",
                "city":"上海市",
                "district":"浦东新区",
                "town": "张江街道",
                "street": "纳贤路",
                "streetNumber":"纳贤路701号"
                "adcode": 310101,
               },{
           "status":1,
           "msg":"失败",
           "location:"40.8899,120.22884",
           "formatted_address": "绿地缤纷广场"
           "addressComponent": {
               "country":"中国",
               "province":"上海市",
               "city":"上海市",
               "district":"浦东新区",
               "town": "金科路",
               "street": "金科路",
               "street_number":"金科路788号"
               "adcode": 310101,
               }
           ]
     }

    轨迹管理接口

    查询车辆实时轨迹点

    接口描述:本接口用于查询纠偏后车辆实时轨迹点

    • 此接口的主要功能是查找某vehicleId实时位置,以及所在道路的限速信息,支持对实时位置进行纠偏。
    • 适用于持续追踪某一终端,展示纠偏后的实时位置,并实时判断车辆是否超速。

    请求结构

    POST /v1/ivc/data/track/getlatestpoint
    Host: ivc.gz.baidubce.com
    Authorization: authorization string
    Content-Type: application/json;charset=utf-8
    x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
    x-bce-date: 2019-03-06T03:39:34Z
    {
       "vehicleId": vehicleId,
       "processOption": processOption,
       "coordTypeOutput":coordTypeOutput
    }

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    vehicleId String RequestBody参数 车辆ID
    processOption String RequestBody参数 纠偏选项。
    默认值为:
    need_denoise=1,need_mapmatch=0,radius_threshold=0,transport_mode=driving
    取值规则为:
    1.去噪,示例:need_denoise =0:不去噪 need_denoise =1:去噪
    2.绑路,示例:need_mapmatch=0:不绑路 need_mapmatch=1:绑路
    3.定位精度过滤,用于过滤掉定位精度较差的轨迹点,示例:radius_threshold=0:不过滤radius_threshold=100:过滤掉定位精度 Radius 大于100的点,说明:当取值=0时,则不过滤;当取值大于0的整数时,则过滤掉radius大于设定值的轨迹点。例如:若只需保留 GPS 定位点,则建议设为:20;若需保留 GPS 和 Wi-Fi 定位点,去除基站定位点,则建议设为:100
    4.交通方式,鹰眼将根据不同交通工具选择不同的纠偏策略,目前支持:自动(即鹰眼自动识别的交通方式)、驾车、骑行和步行,示例
    transport_mode=auto
    transport_mode=driving
    transport_mode=riding
    transport_mode=walking
    coordTypeOutput String RequestBody参数 返回的坐标类型,默认值:
    bd09ll
    该字段用于控制返回结果中的坐标类型。可选值为:
    gcj02:国测局加密坐标
    bd09ll:百度经纬度坐标,该参数仅对国内(包含港、澳、台)轨迹有效,海外区域轨迹均返回 wgs84坐标系

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    参数名 参数类型 说明
    geoInfo GeoInfo 实时位置信息
    limitSpeed Double 道路限速,km/h

    错误码

    错误码 错误描述 HTTP状态码 中文解释
    InvalidRequestParam 车辆ID不能为空 400 车辆ID不能为空
    VehicleIdNotExist 车辆Id不存在 400 车辆Id不存在
    MapServiceError 地图服务异常,请稍后重试 500 地图服务异常,请稍后重试

    请求示例

    POST /v1/ivc/data/track/getlatestpoint
    Host: ivc.gz.baidubce.com
    Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
    Content-Type: application/json;charset=utf-8
    x-bce-request-id: 074c5c9a-36c3-4558-9fa1-0b3b27813af3
    x-bce-date: 2019-11-25T404:02:05Z
    {
         "vehicleId": "QGON_10000"
    }

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Content-Length: 0
    Date: Tus, 28 Nov 2019 03:28:11 GMT
    X-Bce-Request-Id:72492aee-1470-46d0-8a4d-0dab7b8e67b7 
    Server: BWS   
    {
        "geoInfo": {
        "latitude": 62.0,
        "longitude": 65.0,
        "speed": 0.0,
        "direction": 0,
        "locTime": 1575547309000
        }
    }

    查询车辆轨迹

    接口描述:本接口用于查询车辆轨迹

    • 实时查询某vehicleId一段时间内的行程信息:起终点、总里程、收费里程、轨迹点列表等。 支持进行轨迹去噪、抽稀、绑路、里程补偿等。

    请求结构

    POST /v1/ivc/data/track/gettrack
    Host: ivc.gz.baidubce.com
    Authorization: authorization string
    Content-Type: application/json;charset=utf-8
    x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
    x-bce-date: 2019-03-06T03:39:34Z
    {
       "vehicleId": vehicleId,
       "startTime":startTime,
       "endTime":endTime,
       "isProcessed":isProcessed,
       "processOption":processOption,
       "supplementMode":supplementMode,
       "coordTypeOutput":coordTypeOutput,
       "sortType":sortType,
       "pageIndex":pageIndex,
       "pageSize":pageSize
       
    }

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    vehicleId String RequestBody参数 车辆ID
    startTime Long RequestBody参数 UNIX时间戳,起始时间(起始的loc_time)
    endTime Long RequestBody参数 UNIX时间戳,结束时间不超过当前时间,不能早于起始时间,且与起始时间差在24小时之内。为提升响应速度,同时避免轨迹点过多造成请求超时(3s)失败,建议缩短每次请求的时间区间,将一天轨迹拆分成多段进行拼接
    isProcessed Integer RequestBody参数 默认值:0
    取值规则:
    0:关闭轨迹纠偏,返回原始轨迹
    1:打开轨迹纠偏,返回纠偏后轨迹。打开纠偏时,请求时间段内轨迹点数量不能超过2万,否则将返回错误。
    processOption String RequestBody参数 纠偏选项。
    默认值为:
    need_denoise=1,need_mapmatch=0,radius_threshold=0,transport_mode=driving
    取值规则为:
    1.去噪,示例:need_denoise =0:不去噪 need_denoise =1:去噪
    2.绑路,示例:need_mapmatch=0:不绑路 need_mapmatch=1:绑路
    3.定位精度过滤,用于过滤掉定位精度较差的轨迹点,示例:radius_threshold=0:不过滤radius_threshold=100:过滤掉定位精度 Radius 大于100的点,说明:当取值=0时,则不过滤;当取值大于0的整数时,则过滤掉radius大于设定值的轨迹点。例如:若只需保留 GPS 定位点,则建议设为:20;若需保留 GPS 和 Wi-Fi 定位点,去除基站定位点,则建议设为:100
    4.交通方式,鹰眼将根据不同交通工具选择不同的纠偏策略,目前支持:自动(即鹰眼自动识别的交通方式)、驾车、骑行和步行,示例
    transport_mode=auto
    transport_mode=driving
    transport_mode=riding
    transport_mode=walking
    supplementMode String RequestBody参数 最大长度为128,默认值:no_supplement
    在里程计算时,两个轨迹点定位时间间隔5分钟以上,被认为是中断。中断轨迹提供以下5种里程估算方式。
    no_supplement:不补充,中断两点间距离不记入里程。
    straight:使用直线距离补充
    driving:使用最短驾车路线距离补充
    riding:使用最短骑行路线距离补充
    walking:使用最短步行路线距离补充
    coordTypeOutput String RequestBody参数 返回的坐标类型,
    默认值:bd09ll
    该字段用于控制返回结果中的坐标类型。可选值为:
    gcj02:国测局加密坐标
    bd09ll:百度经纬度坐标,该参数仅对国内(包含港、澳、台)轨迹有效,海外区域轨迹均返回 wgs84坐标系
    sortType String RequestBody参数 返回轨迹点的排序规则,默认值:asc
    pageIndex Integer RequestBody参数 分页索引,取值范围为1到2^21-1,默认值:1,与page_size一起计算从第几条结果返回,代表返回第几页。
    pageSize Integer RequestBody参数 分页大小,取值范围为1-5000,默认值:100。返回结果最大个数与page_index一起计算从第几条结果返回,代表返回结果中每页有几个轨迹点。

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    参数名 参数类型 说明
    total Integer 忽略掉page_index,page_size后的轨迹点数量,代表一共有多少条符合条件的track
    size Integer 返回的结果条数,代表本页返回了多少条符合条件的轨迹点数量
    distance Double 此段轨迹的里程数,单位:米,符合条件的所有轨迹点的总里程。注意:是total个轨迹点的里程,和分页及本页显示的size无关。
    tollDistance Double 此段轨迹的收费里程数,单位:米,收费道路包括高速等收费路段。
    startPoint LocationPoint 起点信息
    endPoint LocationPoint 终点信息
    points List<GeoInfo> 历史轨迹点列表

    错误码

    错误码 错误描述 HTTP状态码 中文解释
    InvalidRequestParam 车辆ID不能为空 400 车辆ID不能为空
    VehicleIdNotExist 车辆Id不存在 400 车辆Id不存在
    MapServiceError 地图服务异常,请稍后重试 500 地图服务异常,请稍后重试

    请求示例

    POST /v1/ivc/data/track/gettrack
    Host: ivc.gz.baidubce.com
    Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
    Content-Type: application/json;charset=utf-8
    x-bce-request-id: 074c5c9a-36c3-4558-9fa1-0b3b27813af3
    x-bce-date: 2019-11-25T404:02:05Z
    {
        "vehicleId": "QGON_10000",
        "startTime": 1575547309000,
        "endTime": 1575547369000,
        "isProcessed":1,
        "processOption":{
           "need_denoise":1,
           "radius_threshold":0,
           "need_vacuate":1,
           "need_mapmatch":0,
           "radius_threhold":0,
           "transport_mode":driving
           }
        "supplementMode":"no_supplement",
        "coordTypeOutput":"bd09ll",
        "sortType":"asc",
        "pageIndex":1,
        "pageSize":100
        
    }

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Content-Length: 0
    Date: Tus, 28 Nov 2019 03:28:11 GMT
    X-Bce-Request-Id:72492aee-1470-46d0-8a4d-0dab7b8e67b7 
    Server: BWS   
    {
        "total": 1,
        "size": 1,
        "distance": 0.0,
        "tollDistance": 0.0,
        "startPoint": {
           "latitude": 7.0,
           "longitude": 62.0,
           "coordType": "wgs84",
           "locTime": 1575547309000
        },
       "endPoint": {
          "latitude": 7.0,
          "longitude": 62.0,
          "coordType": "wgs84",
          "locTime": 1575547309000
        },
       "points": [{
          "latitude": 7.0,
          "longitude": 62.0,
          "radius":1.1,
          "speed":3.1,
          "direction":0,
          "height":7.0,
          "locTime": 1575547309000
       }]
    }

    查询轨迹里程

    接口描述:本接口用于查询某vehilceId一段时间内行驶里程,支持:

    • 计算总里程,支持计算纠偏后里程
    • 对于中断或丢失的轨迹区间进行补偿,支持使用直线或驾车/骑行/步行路线规划的里程进行补偿
    • 可应用于无需查询轨迹仅查询里程的场景,如:用车实时计费

    请求结构

    POST /v1/ivc/data/track/getdistance
    Host: ivc.gz.baidubce.com
    Authorization: authorization string
    Content-Type: application/json;charset=utf-8
    x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
    x-bce-date: 2019-03-06T03:39:34Z
    {
       "vehicleId": vehicleId,
       "startTime":startTime,
       "endTime":endTime,
       "isProcessed":isProcessed,
       "processOption":processOption,
       "supplementMode":supplementMode
       
    }

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    vehicleId String RequestBody参数 车辆ID
    startTime Long RequestBody参数 UNIX时间戳,起始时间(起始的loc_time)
    endTime Long RequestBody参数 UNIX时间戳,结束时间不超过当前时间,不能早于起始时间,且与起始时间差在24小时之内。为提升响应速度,同时避免轨迹点过多造成请求超时(3s)失败,建议缩短每次请求的时间区间,将一天轨迹拆分成多段进行拼接
    isProcessed Integer RequestBody参数 默认值:0
    取值规则:
    0:关闭轨迹纠偏,返回原始轨迹
    1:打开轨迹纠偏,返回纠偏后轨迹。打开纠偏时,请求时间段内轨迹点数量不能超过2万,否则将返回错误。
    processOption String RequestBody参数 纠偏选项。
    默认值为:
    need_denoise=1,need_mapmatch=0,radius_threshold=0,transport_mode=driving
    取值规则为:
    1.去噪,示例:need_denoise =0:不去噪 need_denoise =1:去噪
    2.绑路,示例:need_mapmatch=0:不绑路 need_mapmatch=1:绑路
    3.定位精度过滤,用于过滤掉定位精度较差的轨迹点,示例:radius_threshold=0:不过滤 radius_threshold=100:过滤掉定位精度 Radius 大于100的点,说明:当取值=0时,则不过滤;当取值大于0的整数时,则过滤掉radius大于设定值的轨迹点。例如:若只需保留 GPS 定位点,则建议设为:20;若需保留 GPS 和 Wi-Fi 定位点,去除基站定位点,则建议设为:100
    4.交通方式,鹰眼将根据不同交通工具选择不同的纠偏策略,目前支持:自动(即鹰眼自动识别的交通方式)、驾车、骑行和步行,示例
    transport_mode=auto
    transport_mode=driving
    transport_mode=riding
    transport_mode=walking
    supplementMode String RequestBody参数 最大长度为128,默认值:no_supplement
    在里程计算时,两个轨迹点定位时间间隔5分钟以上,被认为是中断。中断轨迹提供以下5种里程估算方式。
    no_supplement:不补充,中断两点间距离不记入里程。
    straight:使用直线距离补充
    driving:使用最短驾车路线距离补充
    riding:使用最短骑行路线距离补充
    walking:使用最短步行路线距离补充

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    参数名 参数类型 说明
    distance Double 此段轨迹的里程数,单位:米,符合条件的所有轨迹点的总里程。

    错误码

    错误码 错误描述 HTTP状态码 中文解释
    InvalidRequestParam 车辆ID不能为空 400 车辆ID不能为空
    VehicleIdNotExist 车辆Id不存在 400 车辆Id不存在
    MapServiceError 地图服务异常,请稍后重试 500 地图服务异常,请稍后重试

    请求示例

    POST /v1/ivc/data/track/getdistance
    Host: ivc.gz.baidubce.com
    Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
    Content-Type: application/json;charset=utf-8
    x-bce-request-id: 074c5c9a-36c3-4558-9fa1-0b3b27813af3
    x-bce-date: 2019-11-25T404:02:05Z
    {
        "vehicleId": "QGON_10000",
        "startTime": 1575547309000,
        "endTime": 1575547369000,
        "isProcessed":1,
        "processOption":{
           "need_denoise":1,
           "radius_threshold":0,
           "need_vacuate":1,
           "need_mapmatch":0,
           "radius_threhold":0,
           "transport_mode":driving
           }
        "supplementMode":"no_supplement"
        
    }

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Content-Length: 0
    Date: Tus, 28 Nov 2019 03:28:11 GMT
    X-Bce-Request-Id:72492aee-1470-46d0-8a4d-0dab7b8e67b7 
    Server: BWS   
    {
        
        "distance": 0.0
    }

    停留点查询

    接口描述:本接口用于轨迹分析停留点查询。

    • 查询vehicleId在指定时间段内的停留点

    注意事项

    本接口用于停留点查询。

    • 设备在半径20米范围内滞留设定时间(默认:10分钟)以上,被认为是一次停留,将取一个代表性坐标作为停留点。

    请求结构

    POST /v1/ivc/data/analysis/staypoint
    Host: ivc.gz.baidubce.com
    Authorization: authorization string
    Content-Type: application/json;charset=utf-8
    x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
    x-bce-date: 2019-03-06T03:39:34Z
    {
       "vehicleId": vehicleId,
       "startTime":startTime,
       "endTime":endTime,
       "stayTime":staryTime,
       "stayRadius":stayRadius,
       "processOption":processOption,
       "coordTypeOutput":coordTypeOutput
       
    }

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    vehicleId String RequestBody参数 车辆ID
    startTime Long RequestBody参数 UNIX时间戳,起始时间(起始的loc_time)
    endTime Long RequestBody参数 UNIX时间戳,结束时间不超过当前时间,不能早于起始时间,且与起始时间差在24小时之内。为提升响应速度,同时避免轨迹点过多造成请求超时(3s)失败,建议缩短每次请求的时间区间,将一天轨迹拆分成多段进行拼接
    stayTime Integer RequestBody参数 停留时间,单位:秒,默认值:600。该字段用于设置停留点判断规则,即若系统判断在半径为stay_radius的圆形范围内停留时间超过stay_time,则被认为是一次停留
    stayRadius Integer RequestBody参数 单位:米,取值范围:[1,500],默认值:20。该字段用于设置停留点判断规则,即若系统判断在半径为stay_radius的圆形范围内停留时间超过stay_time,则被认为是一次停留
    processOption String RequestBody参数 纠偏选项。
    默认值为:
    need_denoise=1,need_mapmatch=0,radius_threshold=0,transport_mode=driving
    取值规则为:
    1.去噪,示例:need_denoise =0:不去噪 need_denoise =1:去噪
    2.绑路,示例:need_mapmatch=0:不绑路 need_mapmatch=1:绑路
    3.定位精度过滤,用于过滤掉定位精度较差的轨迹点,示例:radius_threshold=0:不过滤radius_threshold=100:过滤掉定位精度 Radius 大于100的点,说明:当取值=0时,则不过滤;当取值大于0的整数时,则过滤掉radius大于设定值的轨迹点。例如:若只需保留 GPS 定位点,则建议设为:20;若需保留 GPS 和 Wi-Fi 定位点,去除基站定位点,则建议设为:100
    4.交通方式,鹰眼将根据不同交通工具选择不同的纠偏策略,目前支持:自动(即鹰眼自动识别的交通方式)、驾车、骑行和步行,示例:
    transport_mode=auto
    transport_mode=driving
    transport_mode=riding
    transport_mode=walking
    coordTypeOutput String RequestBody参数 返回的坐标类型。
    默认值:bd09ll
    该字段用于控制返回结果中的坐标类型。可选值为:
    gcj02:国测局加密坐标
    bd09ll:百度经纬度坐标。该参数仅对国内(包含港、澳、台)轨迹有效,海外区域轨迹均返回 wgs84坐标系

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    参数名 参数类型 说明
    staypointNum Integer 停留次数。本段行程中停留次数
    staypoints List<Staypoint> 停留记录列表,数组中每个元素代表一次停留,记录一个停留点坐标

    错误码

    错误码 错误描述 HTTP状态码 中文解释
    InvalidRequestParam 车辆ID不能为空 400 车辆ID不能为空
    VehicleIdNotExist 车辆Id不存在 400 车辆Id不存在
    MapServiceError 地图服务异常,请稍后重试 500 地图服务异常,请稍后重试

    请求示例

    POST /v1/ivc/data/analysis/staypoint
    Host: ivc.gz.baidubce.com
    Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
    Content-Type: application/json;charset=utf-8
    x-bce-request-id: 074c5c9a-36c3-4558-9fa1-0b3b27813af3
    x-bce-date: 2019-11-25T404:02:05Z
    {
        "vehicleId": "QGON_10000",
        "startTime": 1575547309000,
        "endTime": 1575547369000,
        "stayTime":60000,
        "staryRadius":20,
        "processOption":{
           "need_denoise":1,
           "radius_threshold":0,
           "need_vacuate":1,
           "need_mapmatch":0,
           "radius_threhold":0,
           "transport_mode":driving
           }
        "coordTypeOutput":"bd09ll"
        
    }

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Content-Length: 0
    Date: Tus, 28 Nov 2019 03:28:11 GMT
    X-Bce-Request-Id:72492aee-1470-46d0-8a4d-0dab7b8e67b7 
    Server: BWS   
    {
        
       "staypointNum": 1,
       "staypoints": [
          {
             "startTime":1575547309000,
             "endTime":1575547369000,
             "duration":60000,
             "point":{
                       "latitude":7.0,
                       "longitude":62.0,
                       "radius":1.0,
                       "coordType":"bd09ll"
             
              }
           }
       ]
    }

    驾驶行为分析

    接口描述:本接口用于查询指定设备在指定时间段内的驾驶行为。

    驾驶行为包括:

    • 总体信息:起终点信息、里程、耗时、平均速度、最高速度
    • 异常信息:超速、急加速、急刹车、急转弯

    支持的功能:

    • 超速:支持使用百度地图道路限速计算超速行为,也支持开发者设置固定的限速值,计算超速行为
    • 急加速、急减速、急转弯:支持使用默认值 或 开发者自定义的 加速度阈值,计算三急行为

    请求结构

    POST /v1/ivc/data/analysis/drivingbehavior
    Host: ivc.gz.baidubce.com
    Authorization: authorization string
    Content-Type: application/json;charset=utf-8
    x-bce-console-rpc-id: de9468eb-a30b-477e-a98a-b1bb14836e7e
    x-bce-date: 2019-03-06T03:39:34Z
    {
       "vehicleId": vehicleId,
       "startTime":startTime,
       "endTime":endTime,
       "speedingThreshold":speedingThreshold,
       "harshAccelerationThreshold":harshAccelerationThreshold,
       "harshBreakingThreshold":harshBreakingThreshold,
       "harshSteeringThreshold":harshSteeringThreshold,
       "processOption":processOption,
       "coordTypeOutput":coordTypeOutput
       
    }

    请求头域

    除公共头域外,无其它特殊头域。

    请求参数

    参数名称 类型 是否必需 参数位置 描述
    vehicleId String RequestBody参数 车辆ID
    startTime Long RequestBody参数 UNIX时间戳,起始时间(起始的loc_time)
    endTime Long RequestBody参数 UNIX时间戳,结束时间不超过当前时间,不能早于起始时间,且与起始时间差在24小时之内。为提升响应速度,同时避免轨迹点过多造成请求超时(3s)失败,建议缩短每次请求的时间区间,将一天轨迹拆分成多段进行拼接
    speedingThreshold Double RequestBody参数 固定限速值,单位:km/h,默认值:0
    取值规则:
    0:根据百度地图道路限速数据计算超速点
    其他数值:以设置的数值为阈值,轨迹点速度超过该值则认为是超速;示例: speeding_threshold=0,以道路限速数据计算 speeding_threshold=80,限速值为80km/h
    harshAccelerationThreshold Double RequestBody参数 急加速的加速度阈值,单位:m^2/s,默认值:1.67,仅支持正数
    harshBreakingThreshold Double RequestBody参数 急减速的加速度阈值,单位:m^2/s,默认值:-1.67,仅支持负数
    processOption String RequestBody参数 纠偏选项。
    默认值为:
    need_denoise=1,need_mapmatch=0,radius_threshold=0,transport_mode=driving
    取值规则为:
    1.去噪,示例:need_denoise =0:不去噪 need_denoise =1:去噪
    2.绑路,示例:need_mapmatch=0:不绑路 need_mapmatch=1:绑路
    3.定位精度过滤,用于过滤掉定位精度较差的轨迹点,示例:radius_threshold=0:不过滤radius_threshold=100:过滤掉定位精度 Radius 大于100的点,说明:当取值=0时,则不过滤;当取值大于0的整数时,则过滤掉radius大于设定值的轨迹点。例如:若只需保留 GPS 定位点,则建议设为:20;若需保留 GPS 和 Wi-Fi 定位点,去除基站定位点,则建议设为:100
    4.交通方式,鹰眼将根据不同交通工具选择不同的纠偏策略,目前支持:自动(即鹰眼自动识别的交通方式)、驾车、骑行和步行,示例:
    transport_mode=auto
    transport_mode=driving
    transport_mode=riding
    transport_mode=walking
    coordTypeOutput String RequestBody参数 返回的坐标类型。
    默认值:bd09ll
    该字段用于控制返回结果中的坐标类型。可选值为:
    gcj02:国测局加密坐标
    bd09ll:百度经纬度坐标。该参数仅对国内(包含港、澳、台)轨迹有效,海外区域轨迹均返回 wgs84坐标系

    响应头域

    除公共头域外,无其它特殊头域。

    响应参数

    参数名 参数类型 说明
    distance Double 行程里程,单位:米
    duration Integer 行程耗时,单位:秒
    averageSpeed Double 平均时速,单位:km/h
    maxSpeed Double 最高时速,单位:km/h
    speedingNum Integer 超速次数
    harshAccelerationNum Integer 急加速次数
    harshBreakingNum Integer 急刹车次数
    harshSteeringNum Integer 急转弯次数
    startPoint Point 起点信息
    endPoint Point 终点信息
    speeding List<Speeding> 超速记录集合,超速记录集合是一个数组,数组中的每一项代表一次超速记录
    harshAcceleration List<HarshAcceleration> 急加速记录集合
    harshBreaking List<HarshBreaking> 急刹车记录集合
    harshSteering List<HarshSteering> 急转弯记录集合

    错误码

    错误码 错误描述 HTTP状态码 中文解释
    InvalidRequestParam 车辆ID不能为空 400 车辆ID不能为空
    VehicleIdNotExist 车辆Id不存在 400 车辆Id不存在
    MapServiceError 地图服务异常,请稍后重试 500 地图服务异常,请稍后重试

    请求示例

    POST /v1/ivc/data/analysis/drivingbehavior
    Host: ivc.gz.baidubce.com
    Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
    Content-Type: application/json;charset=utf-8
    x-bce-request-id: 074c5c9a-36c3-4558-9fa1-0b3b27813af3
    x-bce-date: 2019-11-25T404:02:05Z
    {
        "vehicleId": "QGON_10000",
        "startTime": 1575547309000,
        "endTime": 1575547369000,
        "speedingThreshold":0
        "harshAccelerationThreshold":1.67
        "harshBreakingThreshold":-1.67
        "harshSteeringThreshold":5
        "processOption":{
           "need_denoise":1,
           "radius_threshold":0,
           "need_vacuate":1,
           "need_mapmatch":0,
           "radius_threhold":0,
           "transport_mode":driving
           }
        "coordTypeOutput":"bd09ll"
        
    }

    响应示例

    HTTP/1.1 200 OK
    Content-Type: application/json;charset=UTF-8
    Content-Length: 0
    Date: Tus, 28 Nov 2019 03:28:11 GMT
    X-Bce-Request-Id:72492aee-1470-46d0-8a4d-0dab7b8e67b7 
    Server: BWS   
    {
        
      "distance": 0.0,
      "duration": 0,
      "averageSpeed": 0.0,
      "maxSpeed": 0.0,
      "speedingNum": 0,
      "harshAccelerationNum": 0,
      "harshBreakingNum": 0,
      "harshSteeringNum": 0,
       "startPoint": {
          "latitude": 7.0,
          "longitude": 62.0,
          "coordType": "wgs84",
          "locTime": 1575547309000,
          "address": ""
        },
      "endPoint": {
          "latitude": 7.0,
          "longitude": 62.0,
          "coordType": "wgs84",
          "locTime": 1575547309000,
          "address": ""
        },
      "speeding":[ {
          "speedingDistance":0.0,
          "speedingPoints":{
              "latitude": 7.0,
              "longitude": 62.0,
              "coordType": "wgs84",
              "locTime": 1575547309000,
              "actualSpeed": 0.0,
              "limitSpeed":0.0
          }
       }],
      "harshAcceleration":[ {
              "latitude": 7.0,
              "longitude": 62.0,
              "coordType": "wgs84",
              "locTime": 1575547309000,
              "acceleration": 0.0,
              "initialSpeed":0.0,
              "endSpeed":0.0
        }],
      "harshBreaking": [{
              "latitude": 7.0,
              "longitude": 62.0,
              "coordType": "wgs84",
              "locTime": 1575547309000,
              "acceleration": 0.0,
              "initialSpeed":0.0,
              "endSpeed":0.0
      }],
      "harshSteering": [{
              "latitude": 7.0,
              "longitude": 62.0,
              "coordType": "wgs84",
              "locTime": 1575547309000,
              "centripetalAcceleration": 0.0,
              "turnType":"left,
              "speed":0.0
      }]
    }

    数据类型

    数据查询对象定义

    Device

    参数名称 类型 描述
    deviceId String 设备ID
    pk String 设备型号
    dn String 设备名称
    endpoint String 设备endpoint
    aliasName String 设备别名
    schemaId String 模型ID
    groupId String 分组ID
    activateStatus String 设备状态,非激活 INACTIVE 激活 ACTIVE
    joinGroupTime Date 设备加入分组时间
    createTime Date 设备添加时间
    expireTime Date 设备有效时间

    DeviceShadow

    参数名称 类型 描述
    Data JsonNode 数据
    lastUpdatedTime JsonNode 设备数据每个属性最后更新时间,只有当needUpdateTime设置为true才会返回该字段

    IvcTsdDataNode

    参数名称 类型 描述
    timestamp long 时间戳,单位为毫秒
    vehicleId String 车辆ID,即为设备ID
    data JsonNode 车辆状态信息

    Group

    参数名 参数类型 说明
    userId String 用户ID
    groupId String 分组ID
    groupName String 分组名称
    count int 分组下的设备数
    createTime Date 创建时间
    updateTime Date 更新时间

    Vehicle

    参数名称 类型 描述
    vehicleId String 车辆ID
    status String 需要上传的车辆数据,key、value对, value的类型可以为String、Integer 或 Double

    GeoInfo

    参数名称 类型 描述
    latitude Double 纬度
    longitude Double 经度
    redius Double 定位精度
    speed Double 速度,km/h
    direction Integer 方向,范围为[0,359],0度为正北方向,顺时针
    height Double 高度,只在GPS定位结果时才返回,单位米
    locTime Long 定位时间,时间戳,ms

    LocationPoint

    参数名称 类型 描述
    latitude Double 纬度
    longitude Double 经度
    coordType String 坐标类型,该字段仅在海外区域时返回,返回值为:wgs84。当坐标位于国内(含港、澳、台)时,返回坐标类型与请求参数 coord_type_output所设一致,因此不再返回该字段
    locTime Long 时间戳,定位时间,ms

    Staypoint

    参数名称 类型 描述
    startTime Long UNIX时间戳,停留开始时间
    endTime Long UNIX时间戳,停留结束时间
    duration Integer 停留时长,单位:秒
    point Point 停留点

    Point

    参数名称 类型 描述
    latitude Double 纬度
    longitude Double 经度
    radius Double 半径
    coordType String 坐标类型,该字段仅在海外区域时返回,返回值为:wgs84。当坐标位于国内(含港、澳、台)时,返回坐标类型与请求参数 coord_type_output 所设一致,因此不再返回该字段

    Speeding

    参数名称 类型 描述
    speedingDistance Double 超速里程,单位:米。本次超速的里程
    speedingPoints List<SpeedingPoint> 超速点,超速记录点集合,一条超速记录中的超速起点或终点

    SpeedingPoint

    参数名称 类型 描述
    latitude Double 纬度
    longtitude Double 经度
    coordType String 坐标类型,该字段仅在海外区域时返回,返回值为:wgs84。当坐标位于国内(含港、澳、台)时,返回坐标类型与请求参数 coord_type_output 所设一致,因此不再返回该字段
    locTime Long UNIX时间戳,定位时间
    actualSpeed Double 实际行驶时速,km/h
    limitSpeed Double 所在道路限定最高时速,km/h

    HarshAcceleration

    参数名称 类型 描述
    latitude Double 纬度
    longtitude Double 经度
    coordType String 坐标类型,该字段仅在海外区域时返回,返回值为:wgs84。当坐标位于国内(含港、澳、台)时,返回坐标类型与请求参数 coord_type_output 所设一致,因此不再返回该字段
    locTime Long UNIX时间戳,定位时间
    acceleration Double 实际加速度,单位:m/s^2
    initialSpeed Double 加速前时速,单位:km/h
    endSpeed Double 加速后时速,单位:km/h

    HarshBreaking

    参数名称 类型 描述
    latitude Double 纬度
    longtitude Double 经度
    coordType String 坐标类型,该字段仅在海外区域时返回,返回值为:wgs84。当坐标位于国内(含港、澳、台)时,返回坐标类型与请求参数 coord_type_output 所设一致,因此不再返回该字段
    locTime Long UNIX时间戳,定位时间
    acceleration Double 实际加速度,单位:m/s^2
    initialSpeed Double 加速前时速,单位:km/h
    endSpeed Double 加速后时速,单位:km/h

    HarshSteering

    参数名称 类型 描述
    latitude Double 纬度
    longtitude Double 经度
    coordType String 坐标类型,该字段仅在海外区域时返回,返回值为:wgs84。当坐标位于国内(含港、澳、台)时,返回坐标类型与请求参数 coord_type_output 所设一致,因此不再返回该字段
    locTime Long UNIX时间戳,定位时间
    centripetalAcceleration Double 向心加速度,单位:m/s^2
    turnType String 转向类型,取值范围:unknow(方向未知),left(左转),right(右转)
    speed Double 转向时速,单位:km/h

    AddressComponent

    参数名称 类型 描述
    country String 国家
    province String 省名
    city String 城市名
    district String 区县名
    town String 乡镇名
    street String 街道名
    streetNumber String 街道门牌号
    adcode Integer 行政区规划码

    Location

    参数名称 类型 描述
    lng double 经度
    lat double 纬度

    Result

    参数名称 类型 描述
    status int 状态
    msg String 提示信息
    location String lat<纬度>,lng<经度>。 举例"38.76623,116.43213;40.8899,120.22884",最多支持20个经纬度坐标
    formattedAddress String 结构化信息
    addressComponent AddressComponent 行政区划信息
    上一篇
    设备管理接口
    下一篇
    流媒体查询API