| （未显示1个用户的14个中间版本） | |||
| 第15行： | 第15行： | ||
2.一次请求可上传多个 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"> | <div class="bluetitle"><div class="services-title-text service-page-anchor">坐标系说明</div></div><div class="serve-explain-text"> | ||
目前中国主要有以下三种坐标系： | 目前中国主要有以下三种坐标系： | ||
| − | |||
WGS84：为一种大地坐标系，也是目前广泛使用的GPS全球卫星定位系统使用的坐标系 | WGS84：为一种大地坐标系，也是目前广泛使用的GPS全球卫星定位系统使用的坐标系 | ||
| − | |||
GCJ02：是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系 | GCJ02：是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系 | ||
| − | |||
BD09：为百度坐标系，在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托米制坐标 | BD09：为百度坐标系，在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托米制坐标 | ||
| − | 非中国地区地图，统一使用WGS84坐标</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"> | + | 非中国地区地图，统一使用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> | </pre> | ||
</div></div><div class="separate-title">请求参数</div> | </div></div><div class="separate-title">请求参数</div> | ||
| 第42行： | 第43行： | ||
|- | |- | ||
| ak | | ak | ||
| − | | | + | | 用户的'''AK'''，授权使用 |
| string | | string | ||
| 是 | | 是 | ||
| 第48行： | 第49行： | ||
|- | |- | ||
| service_id | | service_id | ||
| − | | | + | | service的ID，service 的唯一标识 |
| int | | int | ||
| 是 | | 是 | ||
| − | | | + | | 在轨迹管理台创建鹰眼服务时，系统返回的 service_id |
|- | |- | ||
| entity_name | | entity_name | ||
| 第75行： | 第76行： | ||
| Unix时间戳 | | Unix时间戳 | ||
| 是 | | 是 | ||
| − | | 输入的loc_time不能大于当前服务端时间10分钟以上，即不支持存未来的轨迹点。 | + | | 输入的loc_time不能大于当前服务端时间10分钟以上，即不支持存未来的轨迹点。<br/>且输入的loc_time不能小于当前服务端时间1年以上，即不支持存1年以前的轨迹点。<br/> |
|- | |- | ||
| coord_type_input | | coord_type_input | ||
| 第109行： | 第110行： | ||
| double | | double | ||
| 否 | | 否 | ||
| − | | | + | | 单位：米 |
|- | |- | ||
| radius | | radius | ||
| 第115行： | 第116行： | ||
| double | | double | ||
| 否 | | 否 | ||
| − | | | + | | 单位：米 |
|- | |- | ||
| object_name | | object_name | ||
| 第123行： | 第124行： | ||
| 通过鹰眼 SDK 上传的图像文件名称 | | 通过鹰眼 SDK 上传的图像文件名称 | ||
|- | |- | ||
| − | | | + | | column-key |
| track的自定义字段 | | track的自定义字段 | ||
| 此处值的类型须与用户自定义的column的类型一致 | | 此处值的类型须与用户自定义的column的类型一致 | ||
| 否 | | 否 | ||
| 随轨迹点上传开发者自定义字段的值 | | 随轨迹点上传开发者自定义字段的值 | ||
| + | |- | ||
| + | | sn | ||
| + | | 用户的权限签名，'''若用户所用AK的校验方式为SN校验时该参数必须。'''<br/>[http://lbsyun.baidu.com/index.php?title=webapi/appendix#service-page-anchor2 SN计算规则] | ||
| + | | string | ||
| + | | 否 | ||
| + | | | ||
|} | |} | ||
| 第149行： | 第156行： | ||
| 对status的中文描述 | | 对status的中文描述 | ||
|} | |} | ||
| − | <div class="separate-title">请求示例</div><div class="serve-explain-text"> | + | <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"> |
{ | { | ||
"status": 0, | "status": 0, | ||
| 第159行： | 第166行： | ||
| − | <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"> | + | <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请求 |
</pre> | </pre> | ||
</div></div><div class="separate-title">请求参数</div> | </div></div><div class="separate-title">请求参数</div> | ||
| 第171行： | 第178行： | ||
|- | |- | ||
| ak | | ak | ||
| − | | | + | | 用户的'''AK'''，授权使用 |
| string | | string | ||
| 是 | | 是 | ||
| 第177行： | 第184行： | ||
|- | |- | ||
| service_id | | service_id | ||
| − | | | + | | service的ID，service 的唯一标识 |
| int | | int | ||
| 是 | | 是 | ||
| − | | | + | | 在轨迹管理台创建鹰眼服务时，系统返回的 service_id |
|- | |- | ||
| point_list | | point_list | ||
| 第186行： | 第193行： | ||
| string(1-10000) | | string(1-10000) | ||
| 是 | | 是 | ||
| − | | 轨迹点总数不超过100个，json 格式。轨迹点字段描述参见 addpoint 接口，其中 entity_name,latitude,longitude,loc_time, | + | | 轨迹点总数不超过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 | + | <div class="serve-explain-text">point_list 格式参考：（假设这个service已通过[http://lbs.baidu.com/trace/admin/service 轨迹管理台的service设置]添加过city和province两个自定义字段）</div><pre class="prettyprint codestyle"> [ |
{ | { | ||
| − | "entity_name": " | + | "entity_name": "京Q8374W", |
| − | "loc_time": | + | "loc_time": 1525232703, |
| − | "latitude": | + | "latitude": 39.989715, |
| − | "longitude": | + | "longitude": 116.437039, |
"coord_type_input": "wgs84", | "coord_type_input": "wgs84", | ||
"speed":27.23, | "speed":27.23, | ||
| 第200行： | 第213行： | ||
"radius":32, | "radius":32, | ||
"object_name":"12836", | "object_name":"12836", | ||
| − | "city": " | + | "city": "beijing", |
| − | "province": " | + | "province": "beijing", |
}, | }, | ||
{ | { | ||
| − | "entity_name": | + | "entity_name": 37286234, |
| − | "loc_time": | + | "loc_time": 1525232703, |
| − | "latitude": | + | "latitude": 39.895895, |
| − | "longitude": | + | "longitude": 116.235244, |
"coord_type_input": "wgs84", | "coord_type_input": "wgs84", | ||
| − | "speed" | + | "speed":28.82, |
"direction":174, | "direction":174, | ||
"height":173.6, | "height":173.6, | ||
"radius":32, | "radius":32, | ||
"object_name":"12837", | "object_name":"12837", | ||
| − | "city": " | + | "city": "beijing", |
| − | "province": " | + | "province": "beijing" |
} | } | ||
] | ] | ||
| 第259行： | 第272行： | ||
| 鹰眼服务端内部失败导致的上传失败的点 | | 鹰眼服务端内部失败导致的上传失败的点 | ||
|} | |} | ||
| − | <div class="separate-title">请求示例</div><div class="serve-explain-text"> | + | <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">{ |
"status": 0, | "status": 0, | ||
"message": "成功" | "message": "成功" | ||
| 第267行： | 第280行： | ||
{ | { | ||
"entity_name": 37286234, | "entity_name": 37286234, | ||
| − | "loc_time": | + | "loc_time": 1525232703, |
| − | "latitude": | + | "latitude": 39.895895, |
| − | "longitude": | + | "longitude": 116.235244, |
"coord_type_input": "wgs84", | "coord_type_input": "wgs84", | ||
| − | "speed": | + | "speed":28.82, |
| − | "direction": | + | "direction":174, |
| − | "height":173. | + | "height":173.6, |
"radius":32, | "radius":32, | ||
| − | "object_name":" | + | "object_name":"12837", |
| − | "city": " | + | "city": "beijing", |
| − | "province": " | + | "province": "beijing", |
"error":"entity_name 类型不匹配" | "error":"entity_name 类型不匹配" | ||
} | } | ||
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表示百度墨卡托米制坐标
数据合规性说明
开发者在百度地图鹰眼自行上传数据与百度地图开放平台无关，开发者应对上传数据的合法性负责，并确保不侵犯他人合法权益。若上传数据包含用户隐私信息，包括但不限于用户名、手机号、身份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的中文描述 |
请求示例
返回示例
{
"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 | 鹰眼服务端内部失败导致的上传失败的点 | |
请求示例
返回示例
{
"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": []
}
}