浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。

鹰眼轨迹服务

百度鹰眼是一套轨迹追踪开放服务,开发者在终端集成鹰眼API/SDK 后,可同时管理并追踪数千万终端设备的轨迹,适用于车队管理、共享出行、外勤人员管理、智能穿戴等领域。

简介
为 entity 上传轨迹点,支持为一个 entity上传一个或多个轨迹点,也支持为多个 entity 上传多个轨迹点。
接口列表
模块 接口名称 功能说明
track addpoint 上传单个轨迹点
addpoints 批量上传多个 entity 的多个轨迹点。与 v2版接口不同的是:

1. 轨迹点列表采用 json格式,而非.csv 文件;

2.一次请求可上传多个 entity 的轨迹点;

坐标系说明

目前中国主要有以下三种坐标系:


WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系


GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系


BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标


非中国地区地图,统一使用WGS84坐标
高并发上传轨迹点示例
为便于开发者从服务端上传轨迹,鹰眼提供了Java版批量上传轨迹示例Demo,供开发者参考。请前往:相关下载
接口说明
addpoint——上传单个轨迹点
为一个entity上传一个轨迹点
请求URI
http://yingyan.baidu.com/api/v3/track/addpoint //POST请求
请求参数
参数名 参数含义 类型 是否必填 备注
ak 用户的ak,授权使用 string
service_id servicede ID,作为其唯一标识 int
entity_name entity唯一标识 string(0-128) 标识轨迹点所属的 entity
latitude 纬度 double(-90.0 , +90.0)
longitude 经度 double(-180.0 , +180.0)
loc_time 定位时设备的时间 Unix时间戳 输入的loc_time不能大于当前服务端时间10分钟以上,即不支持存未来的轨迹点。
coord_type_input 坐标类型 string 默认值:bd09ll

该字段用于描述上传的坐标类型。可选值为:

wgs84:GPS 坐标

gcj02:国测局加密坐标

bd09ll:百度经纬度坐标

speed 速度 double 单位:km/h
direction 方向 int 取值规则:

范围为[0,359],0度为正北方向,顺时针

height 高度 double 单位米
radius 定位精度,GPS或定位SDK返回的值 double 单位米
object_name 对象数据名称 string 通过鹰眼 SDK 上传的图像文件名称
<column-key> track的自定义字段 此处值的类型须与用户自定义的column的类型一致 随轨迹点上传开发者自定义字段的值


返回值
参数名 参数含义 类型 备注
status 状态码 int 返回状态,0为成功
message 响应信息 string 对status的中文描述
请求示例
addpoint.png
返回示例
 
{
"status": 0,

"message": "成功"

}


addpoints——批量添加轨迹点
一次上传多个轨迹点.可上传一个 entity 的多个轨迹点,或多个entity的多个轨迹点,并且可以携带自定义字段的信息。
请求URI
http://yingyan.baidu.com/api/v3/track/addpoints //POST请求
请求参数
参数名 参数含义 类型 是否必填 备注
ak 用户的ak,授权使用 string
service_id service唯一标识 int
point_list 轨迹点列表 string(1-10000) 轨迹点总数不超过100个,json 格式。轨迹点字段描述参见 addpoint 接口,其中 entity_name,latitude,longitude,loc_time,coord_type5个字段必填,其他字段可选
point_list 格式参考:(假设这个service已通过track/addcolumn添加过city和province两个自定义字段)
  [
    {
        "entity_name": "entity1",
        "loc_time": 123,
        "latitude": 23.34,
        "longitude": 134.43,
        "coord_type_input": "wgs84",
        "speed":27.23,
        "direction":178,
        "height":173.3,
        "radius":32,
        "object_name":"12836",
        "city": "guangzhou",
        "province": "guangdong",
    },
    {
        "entity_name": "entity2",
        "loc_time": "321",
        "latitude": "23.34",
        "longitude": "135.43",
        "coord_type_input": "wgs84",
        "speed" :28.82,
        "direction":174,
        "height":173.6,
        "radius":32,
        "object_name":"12837",
        "city": "guangzhou",
        "province": "guangdong"
    }
  ]
返回值
参数名 参数含义 类型 备注
status 状态码 int 返回状态,0为成功
message 响应信息 string 对status的中文描述
success_num 上传成功的点个数 int
fail_info 上传失败的点信息 dict
param_error 输入参数不正确导致的上传失败的点 array 上传的point_list中,参数不符合规范的点,以及该点的错误信息(在"error"字段中返回)
internal_error 服务器内部错误导致上传失败的点 array 鹰眼服务端内部失败导致的上传失败的点
请求示例
addpoints.png
返回示例
{
  "status": 0,
  "message": "成功"
  "success_num": 1,
  "fail_info": {
    "param_error": [
      {
        "entity_name": 37286234,
        "loc_time": 123,
        "latitude": 23.34,
        "longitude": 134.43,
        "coord_type_input": "wgs84",
        "speed":27.23,
        "direction":178,
        "height":173.3,
        "radius":32,
        "object_name":"12836",
        "city": "guangzhou",
        "province": "guangdong",
        "error":"entity_name 类型不匹配"    
      }
    ],
    "internal_error": []
  }

}