（→坐标系说明） |
（→坐标系说明） |
||
| 第40行： | 第40行： | ||
| − | + | {{red|鹰眼 Web服务APIv3.0的默认输入输出参数为百度坐标（BD09），同时可通过"coord_type","coord_type_input","coord_type_output"（以各服务参数介绍为准）控制输入输出的坐标类型，鹰眼将自动完成转换。}} | |
==addpoint——上传单个轨迹点== | ==addpoint——上传单个轨迹点== | ||
2017年3月30日 (四) 18:32的版本
目录
简介
轨迹点上传类接口支持开发者实时上传单个或批量轨迹点，主要包括两个接口：
| 模块 | 接口名称 | 功能说明 |
|---|---|---|
| track | addpoint | 上传单个轨迹点 |
| addpoints | 批量上传多个 entity 的多个轨迹点。与 v2版接口不同的是：
1. 轨迹点列表采用 json格式，而非.csv 文件； 2.一次请求可上传多个 entity 的轨迹点，而非一个 entity 的多个轨迹点； |
注：鹰眼 v3.0使用全新域名http://yingyan.baidu.com/api/v3，请开发者注意。
坐标系说明
目前中国主要有以下三种坐标系：
① WGS84：表示GPS获取的坐标
②GCJ02：表示经过国测局加密的坐标
③ BD09：为百度坐标系，其中bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托米制坐标
非中国地区地图，统一使用WGS84坐标
鹰眼 Web服务APIv3.0的默认输入输出参数为百度坐标（BD09），同时可通过"coord_type","coord_type_input","coord_type_output"（以各服务参数介绍为准）控制输入输出的坐标类型，鹰眼将自动完成转换。
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) | 是 | 标识轨迹点所属的 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的中文描述 |
请求示例
返回示例
JSON
| 返回示例 |
|---|
| {
"status": 0, "message": "成功" } |
addpoints——批量添加轨迹点
接口说明
一次上传多个轨迹点，可上传一个 entity 的多个轨迹点，或多个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 | 鹰眼服务端内部失败导致的上传失败的点 | |
请求示例
返回示例
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": []
}
} |