addpoint——添加轨迹点
接口说明
为一个track添加最新轨迹点。
请求URI
HTTP请求方式
POST
请求参数
参数名
参数含义
类型
备注
ak
用户的ak,授权使用
string
必须
service_id
servicede ID,作为其唯一标识
int
必选
latitude
纬度
double(-90.0 , +90.0)
必选
longitude
经度
double(-180.0 , +180.0)
必选
coord_type
坐标类型
int(1-3)
必选,1:GPS经纬度坐标2:国测局加密经纬度坐标 3:百度加密经纬度坐标。
loc_time
轨迹点采集的GPS时间
Unix时间戳
必选。输入的loc_time不能超过当前服务端时间10分钟以上。
entity_name
entity唯一标识
string(0-128)
必选
用户自定义列的column_key
此处值的类型须与用户自定义的column值的类型一致。
在track/create接口中可以为用户自定义的column赋值,当loc_time字段的值大于上一次时,如果输入了自定义的column的值,则这些值也会被更新。
返回值
参数名
参数含义
类型
备注
status
状态码
int
返回状态,0为成功
message
响应信息
string
对status的中文描述
请求示例
返回格式
JSON
响应实例
{
"status": 0,
"message": "成功"
}
addpoints——批量添加轨迹点
接口说明
对于一个track批量上传轨迹点。按照时间顺序保留最后一个点作为实时点,过程耗时等信息。
请求URI
HTTP请求方式
POST
请求参数
参数名
参数含义
类型
备注
ak
用户的ak,授权使用
string
必选
service_id
service唯一标识
int
必选
entity_name
entity唯一标识
string(128)
必选
point_list
上传的轨迹点文件
file
必选。文件类型为.csv,编码格式支持UTF8。上传文件最大不能超过300KB,最多不能超过200条。
返回值
参数名
参数含义
类型
备注
status
状态码
int
返回状态,0为成功
message
响应信息
string
对status的中文描述
time
提交任务过程耗时
int
单位:秒
error_points
上传失败的轨迹点列表
array()
所有轨迹点都上传成功,则没有该字段。若有轨迹点没有上传成功,则该字段中会列出每个上传失败的轨迹点的详细信息。
返回格式
point_list文件示例:点击下载
返回格式
上传全部成功的示例
JSON
响应示例
{
"status": 0,
"time": 30,
"total":3,
"message":"成功"
有上传失败点的示例
JSON
响应示例
{
"status": 0,
"message": "失败1条, 请检查自定义字段的类型是否正确,且loc_time不能超过当前时间10分钟",
"time": 0,
"total": 2,
"error_points": [
{
"longitude": "22.22",
"latitude": "33.33",
"loc_time": "12",
"coord_type": "3",
"dispatch_state": "not",
}
]
gethistory——查询历史轨迹
接口说明
通过service _id和entity_name查找本entity历史轨迹点的具体信息,包括经纬度,时间,其他用户自定义信息等。
请求URI
HTTP请求方式
GET
请求参数
参数名
参数含义
类型
备注
ak
用户的ak,授权使用
string
必须
service_id
service唯一标识
int
必选
start_time
起始时间
UNIX时间戳
必选
end_time
结束时间
UNIX时间戳
必选。结束时间不超过当前时间,不能早于起始时间,且与起始时间差在24小时之内。
entity_name
entity唯一标识
string
必选
simple_return
是否返回精简的结果
int
可选,默认值是0,当设为1时,返回精简结果。
is_processed
是否返回纠偏后轨迹
int
可选,默认值是0。0为返回原始轨迹,1为返回纠偏轨迹。注意:轨迹纠偏功能包括去噪、抽稀、绑路三个步骤,当is_processed=1时,默认仅进行去噪和抽稀处理,并不作绑路处理。若应用为车辆轨迹追踪类型,需要开通绑路操作,可发邮件至:baiduyingyan@baidu.com申请开通。
page_index
分页索引
int(1到2^21-1)默认值为1
可选,与page_size一起计算从第几条结果返回,代表返回第几页。
page_size
分页大小
int(1-5000)默认值为100
可选字段,返回结果最大个数与page_index一起计算从第几条结果返回,代表返回结果中每页有几条记录。
返回值
参数名
参数含义
类型
备注
status
状态码
message
响应信息
string
对status的中文描述
total
忽略掉page_index,page_size后的轨迹点数量
代表一共有多少条符合条件的track
size
返回的结果条数
int
代表本页返回了多少条符合条件的轨迹点数量
distance
此段轨迹的里程数,单位:米
double
符合条件的所有轨迹点的总里程。注意:是total个轨迹点的里程,和分页及本页显示的size无关。
points
历史轨迹点列表
当simple_return=0时,返回point全部字段信息;
当simple_return=1时,返回point信息将只包含 [longitude, latitude, loc_time,speed]字段;
location
经纬度
Array
百度加密坐标
loc_time
该track实时点的上传时间
UNIX时间戳
该时间为用户上传的时间
create_time
创建时间
格式化时间
该时间为服务端时间
自定义字段
当用户创建了track的自定义属性,且在创该属性赋有值,才会返回此字段。
请求示例
返回结果示例
当simple_return=0时
JSON
响应实例
{
"status": 0,
"size": 2,
"total": 2,
"entity_name":"小明",
"distance":4190.69,
"points": [
{
"location": [
116.1556024,
40.0820658,
],
"create_time": "2014-09-13 18:23:45",
"loc_time": "1442139825",
"dispatch_state": “not”
},
{
"location": [
116.3579834,
40.0280849,
],
"create_time": "2014-09-13 18:24:45",
"loc_time": 1442139885,
"dispatch_state": “not”
}
],
"message": "成功"
}
返回结果示例
当simple_return=1,且point的speed字段有值时
JSON
响应实例
{
"status": 0,
"size": 2,
"total": 2,
"entity_name":"小明",
"distance":4190.69,
"points": [
[
116.1556024,
40.0820658,
1376877958,
18.8
],
[ 116.3579834,
40.0280849,
1376877955,
19.6
],
]
],
"message": "成功"
}
addcolumn——添加track的属性字段
接口说明
为track添加一个属性字段。
请求URI
HTTP请求方式
POST
请求参数
参数名
参数含义
类型
备注
ak
用户的ak,授权使用
string
必选
service_id
service的唯一标识
Int
必选
column_key
字段名称
string(45)
必选,最多创建10个属性字段,同一service下track的column_key不能重复。
column_desc
字段描述
string(45)
可选
column_type
字段类型
int(1-3)
可选。必选,枚举值1:Int64, 2:double, 3:string(字符串最大支持2048字符)
返回值
参数名
参数含义
类型
备注
status
状态码
int
返回状态,0为成功
message
响应信息
string
对status的中文描述
请求示例
返回格式
JSON
响应实例
{
"status": 0,
"message": "成功"
}
deletecolumn——删除track属性字段
接口说明
删除track某个属性字段。
请求URI
HTTP请求方式
POST
请求参数
参数名
参数含义
类型
备注
ak
用户的ak,授权使用
string
必选
service_id
该track所属的service服务的唯一标识
Int
必选
column_key
字段唯一标识
string
必选
返回值
参数名
参数含义
类型
备注
status
状态码
int
返回状态,0为成功
message
响应信息
string
对status的中文描述
请求示例
返回格式
JSON
响应实例
{
"status": 0,
"message": "成功"
}
listcolumn——列出track属性字段
接口说明
列出track所有自定义属性字段。
请求URI
HTTP请求方式
GET
请求参数
参数名
参数含义
类型
备注
ak
用户的ak,授权使用
string
必选
service_id
该track所属的service服务的唯一标识
int
必选
返回值
参数名
参数含义
类型
备注
status
状态码
int
返回状态,0为成功
message
响应信息
string
对status的中文描述
columns
字段列表
array
column_key
字段名称
string
column_desc
字段描述
string
column_type
字段类型
int
create_time
字段创建时间
格式化日期
请求示例
返回格式
JSON
响应示例
{
"status": 0,
"columns": [
{
"column_key": "oil",
"column_desc": "油量",
"column_type": 1,
"create_time": "2015-05-18 09:02:25",
"modify_time": "2015-05-18 09:02:25"
},
{
"column_key": "gas",
"column_desc": "排放",
"column_type": 1,
"create_time": "2015-05-18 09:05:31",
"modify_time": "2015-05-18 09:05:31"
}
]
"message": "成功"
}