AI
产品服务
解决方案
文档与支持
定价
更新时间: 2026-03-20 08:02:34
简介

为 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上传一个轨迹点

API服务地址

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。addpoint的时候,如果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的多个轨迹点,并且可以携带自定义字段的信息。

API服务地址

https://yingyan.baidu.com/api/v3/track/addpoints
//POST 请求

请求参数
参数名称字段含义数据类型是否必填备注

ak

用户的AK,授权使用

string

service_id

service的ID,service 的唯一标识

int

service 的唯一标识。在轨迹管理台创建鹰眼服务时,系统返回的 service_id

point_list

轨迹点列表

string(1-10000)

轨迹点总数不超过100个,json 格式。轨迹点字段描述参见 addpoint 接口,其中 entity_name,latitude,longitude,loc_time,coord_type_input5个字段必填,其他字段可选。addpoint的时候,如果entity不存在,会自动创建一个出来的。

sn

用户的权限签名,若用户所用AK的校验方式为SN校验时该参数必须。SN计算方法

string

point_list 格式参考:(假设这个service已通过轨迹管理台的service设置添加过city和province两个自定义字段)

[
{
"entity_name": "京Q8374W",
"loc_time": 1773135357,
"latitude": 39.98971115,
"longitude": 116.437039,
"coord_type_input": "wgs84",
"speed": 28.82,
"direction": 174,
"height": 173.6,
"radius": 32
},
{
"entity_name": "京Q8375W",
"loc_time": 1773135370,
"latitude": 39.89511895,
"longitude": 116.235244,
"coord_type_input": "wgs84",
"speed": 28.82,
"direction": 174,
"height": 173.6,
"radius": 32
}
]
返回值
参数名字段含义类型备注

status

状态码

int

返回状态,0为成功

message

响应信息

string

对status的中文描述

success_num

上传成功的点个数

int

fail_info

上传失败的点信息

dict

param_error

输入参数不正确导致的上传失败的点

array

上传的point_list中,参数不符合规范的点,以及该点的错误信息(在"error"字段中返回)

internal_error

服务器内部错误导致上传失败的点

array

鹰眼服务端内部失败导致的上传失败的点

注意:拷贝示例代码后,请在代码中填入您的serviceID再运行;

请求示例
返回示例
{
"status": 0,
"message": "成功",
"success_num": 1,
"total": 2,
"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": []
}
}

上一篇

空间搜索

下一篇

轨迹查询和纠偏

本篇文章对您是否有帮助?