浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。
接口说明
 
(未显示1个用户的39个中间版本)
第1行: 第1行:
{{yingyan-sidebar}}
+
{{yingyan-sidebar}}<div class="bluetitle"><div class="services-title-text service-page-anchor">简介</div></div><div class="serve-explain-text">为 entity 上传轨迹点,支持为一个 entity上传一个或多个轨迹点,也支持为多个 entity 上传多个轨迹点。</div><div class="bluetitle"><div class="services-title-text service-page-anchor">接口列表</div></div>
==简介==
+
 
+
轨迹点上传类接口支持开发者实时上传单个或批量轨迹点,主要包括两个接口:
+
 
{| border="1" cellspacing="0" cellpadding="0"
 
{| border="1" cellspacing="0" cellpadding="0"
!width="100"| 模块
+
|-
!width="200"| 接口名称
+
! width="100" | 模块
!width="700"| 功能说明
+
! width="200" | 接口名称
 
+
! width="700" | 功能说明
 
|-
 
|-
 
| rowspan="3" | track
 
| rowspan="3" | track
 
| addpoint
 
| addpoint
| 上传单个轨迹点
+
| 上传单个轨迹点
 
|-
 
|-
 
| addpoints
 
| addpoints
 
| 批量上传多个 entity 的多个轨迹点。与 v2版接口不同的是:
 
| 批量上传多个 entity 的多个轨迹点。与 v2版接口不同的是:
 
 
1. 轨迹点列表采用 json格式,而非.csv 文件;
 
1. 轨迹点列表采用 json格式,而非.csv 文件;
  
2.一次请求可上传多个 entity 的轨迹点,而非一个 entity 的多个轨迹点;
+
2.一次请求可上传多个 entity 的轨迹点;
 +
 
 +
<span style="color:#FF0000;">注:开发者可参照示例代码实现高并发批量上传轨迹点:</span>[http://lbsyun.baidu.com/index.php?title=yingyan/download 批量上传轨迹点的Java源码和示例]
 +
 
 
|}
 
|}
 +
<div class="bluetitle"><div class="services-title-text service-page-anchor">坐标系说明</div></div><div class="serve-explain-text">
 +
目前中国主要有以下三种坐标系:
  
注:鹰眼 v3.0使用全新域名[http://yingyan.baidu.com/api/v3 http://yingyan.baidu.com/api/v3],请开发者注意。
+
WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系
  
==addpoint——上传单个轨迹点==
+
GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系
===接口说明===
+
为一个entity上传一个轨迹点
+
  
===请求URI===
+
BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标
URI:http://yingyan.baidu.com/api/v3/track/addpoint
+
 
===HTTP请求方式===
+
 
POST
+
非中国地区地图,统一使用WGS84坐标</div><div class="bluetitle"><div class="services-title-text service-page-anchor">数据合规性说明</div></div><div class="serve-explain-text">
===请求参数===
+
开发者在百度地图鹰眼自行上传数据与百度地图开放平台无关,开发者应对上传数据的合法性负责,并确保不侵犯他人合法权益。若上传数据包含用户隐私信息,包括但不限于用户名、手机号、身份ID等,请开发者确保已获取用户的授权同意并由开发者自行加密以保障用户隐私安全,百度地图开放平台不对开发者自行上传的用户数据进行校验和加密。
 +
</div><div class="bluetitle"><div class="services-title-text service-page-anchor">高并发上传轨迹点示例</div></div><div class="serve-explain-text">为便于开发者从服务端上传轨迹,鹰眼提供了Java版批量上传轨迹示例Demo,供开发者参考。请前往:[http://lbsyun.baidu.com/index.php?title=yingyan/download 相关下载]</div><div class="bluetitle"><div class="services-title-text service-page-anchor">接口说明</div></div><div class="separate-title service-page-anchor">addpoint——上传单个轨迹点</div><div class="serve-explain-text">为一个entity上传一个轨迹点</div><div class="serve-explain-text"><div class="serveintoor-title">请求URI</div><div class="code-template"><pre class="get-url-pre">https://yingyan.baidu.com/api/v3/track/addpoint //POST请求
 +
</pre>
 +
</div></div><div class="separate-title">请求参数</div>
 
{| border="1" cellspacing="0" cellpadding="0"
 
{| border="1" cellspacing="0" cellpadding="0"
!width="100"| 参数名
+
|-
!width="200"| 参数含义
+
! width="100" | 参数名
!width="100"| 类型
+
! width="200" | 参数含义
!width="100"| 是否必填
+
! width="100" | 类型
!width="200"| 备注
+
! width="100" | 是否必填
 +
! width="200" | 备注
 
|-
 
|-
 
| ak
 
| ak
| 用户的ak,授权使用
+
| 用户的'''AK''',授权使用
 
| string
 
| string
 
| 是
 
| 是
|
+
|  
 
|-
 
|-
 
| service_id
 
| service_id
| servicede ID,作为其唯一标识
+
| service的ID,service 的唯一标识
|int
+
| int
 
| 是
 
| 是
|
+
| 在轨迹管理台创建鹰眼服务时,系统返回的 service_id
 
|-
 
|-
 
| entity_name
 
| entity_name
第61行: 第64行:
 
| double(-90.0 , +90.0)
 
| double(-90.0 , +90.0)
 
| 是
 
| 是
|
+
|  
 
|-
 
|-
 
| longitude
 
| longitude
第67行: 第70行:
 
| double(-180.0 , +180.0)
 
| double(-180.0 , +180.0)
 
| 是
 
| 是
|
+
|  
 
|-
 
|-
 
| loc_time
 
| loc_time
第73行: 第76行:
 
| Unix时间戳
 
| Unix时间戳
 
| 是
 
| 是
|输入的loc_time不能大于当前服务端时间10分钟以上,即不支持存未来的轨迹点。
+
| 输入的loc_time不能大于当前服务端时间10分钟以上,即不支持存未来的轨迹点。<br/>且输入的loc_time不能小于当前服务端时间1年以上,即不支持存1年以前的轨迹点。<br/>
 
|-
 
|-
 
| coord_type_input
 
| coord_type_input
第79行: 第82行:
 
| string
 
| string
 
| 是
 
| 是
|默认值:bd09ll
+
| 默认值:bd09ll
 
+
 
该字段用于描述上传的坐标类型。可选值为:
 
该字段用于描述上传的坐标类型。可选值为:
  
第88行: 第90行:
  
 
bd09ll:百度经纬度坐标
 
bd09ll:百度经纬度坐标
 +
 
|-
 
|-
 
| speed
 
| speed
第93行: 第96行:
 
| double
 
| double
 
| 否
 
| 否
|单位:km/h
+
| 单位:km/h
 
|-
 
|-
 
| direction
 
| direction
第100行: 第103行:
 
| 否
 
| 否
 
| 取值规则:
 
| 取值规则:
 
 
范围为[0,359],0度为正北方向,顺时针
 
范围为[0,359],0度为正北方向,顺时针
 +
 
|-
 
|-
 
| height
 
| height
第107行: 第110行:
 
| double
 
| double
 
| 否
 
| 否
|单位米
+
| 单位:米
 
|-
 
|-
 
| radius
 
| radius
 
| 定位精度,GPS或定位SDK返回的值
 
| 定位精度,GPS或定位SDK返回的值
 
| double
 
| double
|否
+
| 否
|单位米
+
| 单位:米
 
|-
 
|-
 
| object_name
 
| object_name
第119行: 第122行:
 
| string
 
| string
 
| 否
 
| 否
|通过鹰眼 SDK 上传的图像文件名称
+
| 通过鹰眼 SDK 上传的图像文件名称
 
|-
 
|-
| <column-key>
+
| column-key
 
| track的自定义字段
 
| track的自定义字段
 
| 此处值的类型须与用户自定义的column的类型一致
 
| 此处值的类型须与用户自定义的column的类型一致
 
| 否
 
| 否
|随轨迹点上传开发者自定义字段的值
+
| 随轨迹点上传开发者自定义字段的值
 +
|-
 +
| sn
 +
| 用户的权限签名,'''若用户所用AK的校验方式为SN校验时该参数必须。'''<br/>[http://lbsyun.baidu.com/index.php?title=webapi/appendix#service-page-anchor2 SN计算规则]
 +
| string
 +
| 否
 +
|
 
|}
 
|}
  
===返回值===
+
 
 +
<div class="separate-title">返回值</div>
 
{| border="1" cellspacing="0" cellpadding="0"
 
{| border="1" cellspacing="0" cellpadding="0"
!width="100"| 参数名
+
|-
!width="200"| 参数含义
+
! width="100" | 参数名
!width="100"| 类型
+
! width="200" | 参数含义
!width="400"| 备注
+
! width="100" | 类型
 +
! width="400" | 备注
 
|-
 
|-
 
| status
 
| status
第145行: 第156行:
 
| 对status的中文描述
 
| 对status的中文描述
 
|}
 
|}
 
+
<div class="separate-title">请求示例</div><div class="serve-explain-text">https://lbsyun.baidu.com/cms/yingyan/addpoint.png</div><div class="separate-title">返回示例</div><pre class="prettyprint codestyle">
===请求示例===
+
{
http://wiki.lbsyun.baidu.com/cms/yingyan/addpoint.png
+
 
+
===返回示例===
+
JSON
+
{| border="1" cellspacing="0" cellpadding="0"
+
!width="1000"| 返回示例
+
|-
+
| {
+
 
"status": 0,
 
"status": 0,
  
第160行: 第163行:
  
 
}
 
}
|}
+
</pre>
  
==addpoints——批量添加轨迹点==
 
  
===接口说明===
+
<div class="separate-title service-page-anchor">addpoints——批量添加轨迹点</div><div class="serve-explain-text">一次上传多个轨迹点.可上传一个 entity 的多个轨迹点,或多个entity的多个轨迹点,并且可以携带自定义字段的信息。</div><div class="serve-explain-text"><div class="serveintoor-title">请求URI</div><div class="code-template"><pre class="get-url-pre">https://yingyan.baidu.com/api/v3/track/addpoints //POST请求
一次上传多个轨迹点,可上传一个 entity 的多个轨迹点,或多个entity的多个轨迹点,并且可以携带自定义字段的信息。
+
</pre>
 
+
</div></div><div class="separate-title">请求参数</div>
===请求URI===
+
http://yingyan.baidu.com/api/v3/track/addpoints
+
===HTTP请求方式===
+
POST
+
 
+
===请求参数===
+
 
{| border="1" cellspacing="0" cellpadding="0"
 
{| border="1" cellspacing="0" cellpadding="0"
!width="100"| 参数名
 
!width="200"| 参数含义
 
!width="100"| 类型
 
!width="100"| 是否必填
 
!width="200"| 备注
 
 
|-
 
|-
|ak
+
! width="100" | 参数名
|用户的ak,授权使用
+
! width="200" | 参数含义
|string
+
! width="100" | 类型
|是
+
! width="100" | 是否必填
|
+
! width="200" | 备注
 +
|-
 +
| ak
 +
| 用户的'''AK''',授权使用
 +
| string
 +
| 是
 +
|  
 
|-
 
|-
 
| service_id
 
| service_id
| service唯一标识
+
| service的ID,service 的唯一标识
 
| int
 
| int
| |是
+
| 是
|
+
| 在轨迹管理台创建鹰眼服务时,系统返回的 service_id
 
|-
 
|-
 
| point_list
 
| point_list
第196行: 第193行:
 
| string(1-10000)
 
| string(1-10000)
 
| 是
 
| 是
| 轨迹点总数不超过100个,json 格式。轨迹点字段描述参见 addpoint 接口,其中 entity_name,latitude,longitude,loc_time,coord_type5个字段必填,其他字段可选
+
| 轨迹点总数不超过100个,json 格式。轨迹点字段描述参见 addpoint 接口,其中 entity_name,latitude,longitude,loc_time,coord_type_input5个字段必填,其他字段可选
 +
|-
 +
| sn
 +
| 用户的权限签名,'''若用户所用AK的校验方式为SN校验时该参数必须。'''<br/>[http://lbsyun.baidu.com/index.php?title=webapi/appendix#service-page-anchor2 SN计算规则]
 +
| string
 +
| 否
 +
|
 
|}
 
|}
 
+
<div class="serve-explain-text">point_list 格式参考:(假设这个service已通过[http://lbs.baidu.com/trace/admin/service 轨迹管理台的service设置]添加过city和province两个自定义字段)</div><pre class="prettyprint codestyle"> [
<p>point_list 格式参考:(假设这个service已通过track/addcolumn添加过city和province两个自定义字段)</p>
+
 
+
  [
+
 
     {
 
     {
         "entity_name": “entity1”,
+
         "entity_name": "京Q8374W",
         "loc_time": 123,
+
         "loc_time": 1525232703,
         "latitude": 23.34,
+
         "latitude": 39.989715,
         "longitude": 134.43,
+
         "longitude": 116.437039,
         "coord_type_input": “wgs84”,
+
         "coord_type_input": "wgs84",
         “speed”:27.23,
+
         "speed":27.23,
         “direction”:178,
+
         "direction":178,
         “height”:173.3,
+
         "height":173.3,
         “radius”:32,
+
         "radius":32,
         “object_name":"12836”,
+
         "object_name":"12836",
         "city": "guangzhou",
+
         "city": "beijing",
         "province": "guangdong",
+
         "province": "beijing",
 
     },
 
     },
 
     {
 
     {
         "entity_name": “entity2”,
+
         "entity_name": 37286234,
         "loc_time": "321",
+
         "loc_time": 1525232703,
         "latitude": "23.34",
+
         "latitude": 39.895895,
         "longitude": "135.43",
+
         "longitude": 116.235244,
 
         "coord_type_input": "wgs84",
 
         "coord_type_input": "wgs84",
         “speed”:28.82,
+
         "speed":28.82,
         “direction”:174,
+
         "direction":174,
         “height”:173.6,
+
         "height":173.6,
         “radius”:32,
+
         "radius":32,
         “object_name":"12837”,
+
         "object_name":"12837",
         "city": "guangzhou",
+
         "city": "beijing",
         "province": "guangdong"
+
         "province": "beijing"
 
     }
 
     }
 
   ]
 
   ]
 
+
</pre>
===返回值===
+
<div class="separate-title">返回值</div>
 
{| border="1" cellspacing="0" cellpadding="0"
 
{| border="1" cellspacing="0" cellpadding="0"
!width="100" colspan="2"| 参数名
 
!width="200"| 参数含义
 
!width="100"| 类型
 
!width="500"| 备注
 
 
|-
 
|-
| colspan="2"|status
+
! width="100" colspan="2" | 参数名
 +
! width="200" | 参数含义
 +
! width="100" | 类型
 +
! width="500" | 备注
 +
|-
 +
| colspan="2" | status
 
| 状态码
 
| 状态码
 
| int
 
| int
 
| 返回状态,0为成功
 
| 返回状态,0为成功
 
|-
 
|-
| colspan="2"|message
+
| colspan="2" | message
 
| 响应信息
 
| 响应信息
 
| string
 
| string
 
| 对status的中文描述
 
| 对status的中文描述
 
|-
 
|-
|colspan="2"| success_num
+
| colspan="2" | success_num
 
| 上传成功的点个数
 
| 上传成功的点个数
 
| int
 
| int
|
+
|  
 
|-
 
|-
|colspan="2"| fail_info
+
| colspan="2" | fail_info
 
| 上传失败的点信息
 
| 上传失败的点信息
 
| dict
 
| dict
|
+
|  
 
|-
 
|-
|
+
|  
 
| param_error
 
| param_error
 
| 输入参数不正确导致的上传失败的点
 
| 输入参数不正确导致的上传失败的点
 
| array
 
| array
|上传的point_list中,参数不符合规范的点
+
| 上传的point_list中,参数不符合规范的点,以及该点的错误信息(在"error"字段中返回)
 
|-
 
|-
|
+
|  
 
| internal_error
 
| internal_error
 
| 服务器内部错误导致上传失败的点
 
| 服务器内部错误导致上传失败的点
 
| array
 
| array
|鹰眼服务端内部失败导致的上传失败的点
+
| 鹰眼服务端内部失败导致的上传失败的点
 
+
 
|}
 
|}
 
+
<div class="separate-title">请求示例</div><div class="serve-explain-text">https://lbsyun.baidu.com/cms/yingyan/addpoints.png</div><div class="separate-title">返回示例</div><pre class="prettyprint codestyle">{
===请求示例===
+
 
+
http://wiki.lbsyun.baidu.com/cms/yingyan/addpoints.png
+
 
+
===返回示例===
+
JSON
+
{| border="1" cellspacing="0" cellpadding="0"
+
!width="1000"| 响应示例
+
|-
+
| {
+
 
   "status": 0,
 
   "status": 0,
 
   "message": "成功"
 
   "message": "成功"
第289行: 第279行:
 
     "param_error": [
 
     "param_error": [
 
       {
 
       {
         "entity_name": "entity1",
+
         "entity_name": 37286234,
         "loc_time": "146597196ss1",
+
        "loc_time": 1525232703,
         "latitude": "123.34",
+
         "latitude": 39.895895,
         "longitude": "234.43",
+
        "longitude": 116.235244,
         "coord_type_input": "3",
+
         "coord_type_input": "wgs84",
      “error”:”entity_name 类型不匹配”
+
         "speed":28.82,
 +
        "direction":174,
 +
        "height":173.6,
 +
        "radius":32,
 +
         "object_name":"12837",
 +
        "city": "beijing",
 +
        "province": "beijing",
 +
        "error":"entity_name 类型不匹配"   
 
       }
 
       }
 
     ],
 
     ],
 
     "internal_error": []
 
     "internal_error": []
 
   }
 
   }
 +
 
}
 
}
|}
+
</pre>

2022年7月22日 (五) 19:18的最后版本

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

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

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

注:开发者可参照示例代码实现高并发批量上传轨迹点:批量上传轨迹点的Java源码和示例

坐标系说明

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

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

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

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


非中国地区地图,统一使用WGS84坐标
数据合规性说明

开发者在百度地图鹰眼自行上传数据与百度地图开放平台无关,开发者应对上传数据的合法性负责,并确保不侵犯他人合法权益。若上传数据包含用户隐私信息,包括但不限于用户名、手机号、身份ID等,请开发者确保已获取用户的授权同意并由开发者自行加密以保障用户隐私安全,百度地图开放平台不对开发者自行上传的用户数据进行校验和加密。

高并发上传轨迹点示例
为便于开发者从服务端上传轨迹,鹰眼提供了Java版批量上传轨迹示例Demo,供开发者参考。请前往:相关下载
接口说明
addpoint——上传单个轨迹点
为一个entity上传一个轨迹点
请求URI
https://yingyan.baidu.com/api/v3/track/addpoint //POST请求
请求参数
参数名 参数含义 类型 是否必填 备注
ak 用户的AK,授权使用 string
service_id service的ID,service 的唯一标识 int 在轨迹管理台创建鹰眼服务时,系统返回的 service_id
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分钟以上,即不支持存未来的轨迹点。
且输入的loc_time不能小于当前服务端时间1年以上,即不支持存1年以前的轨迹点。
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的类型一致 随轨迹点上传开发者自定义字段的值
sn 用户的权限签名,若用户所用AK的校验方式为SN校验时该参数必须。
SN计算规则
string


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

"message": "成功"

}


addpoints——批量添加轨迹点
一次上传多个轨迹点.可上传一个 entity 的多个轨迹点,或多个entity的多个轨迹点,并且可以携带自定义字段的信息。
请求URI
https://yingyan.baidu.com/api/v3/track/addpoints //POST请求
请求参数
参数名 参数含义 类型 是否必填 备注
ak 用户的AK,授权使用 string
service_id service的ID,service 的唯一标识 int 在轨迹管理台创建鹰眼服务时,系统返回的 service_id
point_list 轨迹点列表 string(1-10000) 轨迹点总数不超过100个,json 格式。轨迹点字段描述参见 addpoint 接口,其中 entity_name,latitude,longitude,loc_time,coord_type_input5个字段必填,其他字段可选
sn 用户的权限签名,若用户所用AK的校验方式为SN校验时该参数必须。
SN计算规则
string
point_list 格式参考:(假设这个service已通过轨迹管理台的service设置添加过city和province两个自定义字段)
  [
    {
        "entity_name": "京Q8374W",
        "loc_time": 1525232703,
        "latitude": 39.989715,
        "longitude": 116.437039,
        "coord_type_input": "wgs84",
        "speed":27.23,
        "direction":178,
        "height":173.3,
        "radius":32,
        "object_name":"12836",
        "city": "beijing",
        "province": "beijing",
    },
    {
        "entity_name": 37286234,
        "loc_time": 1525232703,
        "latitude": 39.895895,
        "longitude": 116.235244,
        "coord_type_input": "wgs84",
        "speed":28.82,
        "direction":174,
        "height":173.6,
        "radius":32,
        "object_name":"12837",
        "city": "beijing",
        "province": "beijing"
    }
  ]
返回值
参数名 参数含义 类型 备注
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": 1525232703,
        "latitude": 39.895895,
        "longitude": 116.235244,
        "coord_type_input": "wgs84",
        "speed":28.82,
        "direction":174,
        "height":173.6,
        "radius":32,
        "object_name":"12837",
        "city": "beijing",
        "province": "beijing",
        "error":"entity_name 类型不匹配"    
      }
    ],
    "internal_error": []
  }

}
  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

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

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消