浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。
请求参数
请求参数
第191行: 第191行:
 
| |是
 
| |是
 
|
 
|
|-
 
| entity_name
 
| entity唯一标识
 
| string(128)
 
|是
 
|<br>同一service服务中entity_name不可重复。一旦创建,entity_name 不可更新。<br>命名规则:仅支持中文、英文大小字母、英文下划线"_"、英文横线"-"和数字。 entity_name 和 entity_desc 支持联合模糊检索。
 
<br>
 
 
|-
 
|-
 
| point_list
 
| point_list

2017年3月13日 (一) 11:11的版本

简介

轨迹点上传类接口支持开发者实时上传单个或批量轨迹点,主要包括两个接口:

模块 接口名称 功能说明
track addpoint 上传单个轨迹点
addpoints 批量上传多个 entity 的多个轨迹点。与 v2版接口不同的是:

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

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

注:鹰眼 v3.0使用全新域名http://yingyan.baidu.com/api/v3,请开发者注意。

addpoint——上传单个轨迹点

接口说明

为一个entity上传一个轨迹点

请求URI

URI:http://yingyan.baidu.com/api/v3/track/addpoint

HTTP请求方式

POST

请求参数

参数名 参数含义 类型 是否必填 备注
ak 用户的ak,授权使用 string
service_id servicede ID,作为其唯一标识 int
entity_name entity唯一标识 string(0-128)
同一service服务中entity_name不可重复。一旦创建,entity_name 不可更新。
命名规则:仅支持中文、英文大小字母、英文下划线"_"、英文横线"-"和数字。 entity_name 和 entity_desc 支持联合模糊检索。


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

返回示例

JSON

返回示例
{

"status": 0,

"message": "成功"

}

addpoints——批量添加轨迹点

接口说明

一次上传多个轨迹点,多个轨迹点可以属于不同的entity,并且可以携带自定义字段的信息。

请求URI

http://yingyan.baidu.com/api/v3/track/addpoints

HTTP请求方式

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中,参数不符合规范的点
internal_error 服务器内部错误导致上传失败的点 array 鹰眼服务端内部失败导致的上传失败的点

请求示例

addpoints.png

返回示例

JSON

响应示例
{
 "status": 0,
 "message": "成功"
 "success_num": 1,
 "fail_info": {
   "param_error": [
     {
       "entity_name": "entity1",
       "loc_time": "146597196ss1",
       "latitude": "123.34",
       "longitude": "234.43",
       "coord_type_input": "3",
      “error”:”entity_name 类型不匹配”
     }
   ],
   "internal_error": []
 }

}

  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

如发现文档错误,或对此文档有更好的建议,请在下方反馈。问题咨询请前往反馈平台提交工单咨询。

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消