轨迹上传及管理最后更新时间: 2021年01月22日

简介

本篇介绍如何创建轨迹，轨迹如何上传猎鹰之中以及如何进行管理。

服务调用量的限制请点击这里查阅。

创建一条轨迹，一个终端下最多可创建500000条轨迹。

URL	http://tsapi.amap.com/v1/track/trace/add
请求方式	POST

参数名	含义	规则说明	是否必须	缺省值
key	请求标识	用户在高德地图官网申请Web服务API类型KEY	必填	无
sid	服务编号	sid为用户希望增加轨迹的终端所属 Service 唯一编号	必填	无
tid	设备编号	tid为用户希望增加轨迹的终端唯一编号	必填	无
trname	轨迹名称	开发者可为每条轨迹添加自定义名称，格式支持中文、英文大小写字母、英文下划线"_"、英文横线"-"和数字 。长度不得超过128个字符。	非必填	系统随机命名

删除一条轨迹，轨迹删除后无法进行恢复。

URL	http://tsapi.amap.com/v1/track/trace/delete
请求方式	POST

可以将终端的轨迹点通过经纬度上传接口进行上传，支持批量上传以及单点上传。
在上传经纬度之前需要先通过创建轨迹接口创建一条轨迹，拿到trid，根据trid上传经纬度点；如果用户指定了trid（轨迹id），但是trid不存在，该点按照trid字段为空存储，并返回对应的错误信息：trid不存在，点已存储，此时点信息会绑定在tid上，不会生成轨迹。
若一次上传多个点，其中有一个/多个出错时，服务会进行报错，但是正确的点会上传到服务器之中可以正常使用，并且在结果之中会显示出错点的序号。例如：用户上传了A、B、C、D、E 这五个点，其中C点的数据是错误的，服务会返回报错结果，及序号：3；但是A、B、D、E这4个点已经成功上传

URL	http://tsapi.amap.com/v1/track/point/upload
请求方式	POST

参数名			含义	规则说明	是否必须	缺省值
key			请求服务权限标识	用户在高德地图官网申请Web服务API类型KEY	必填	无
sid			服务的唯一编号	此ID服务唯一编号	必填	无
tid			设备唯一编号	此ID终端唯一编号	必填	无
trid			轨迹ID	此ID为轨迹的唯一编号	必填	无
points			具体上传点的信息	json数组形式，里面最多包含100个对象。	必填	无
	location		经纬度坐标	格式为：X,Y 小数点后最多6位	必填	无
	locatetime		此次定位的时间点	需要用unix时间戳表示，需要精确到毫秒，若有相同的unix时间戳则会覆盖旧的点。	必填	无
	speed		速度	单位：km/h 小数点后最多3位	非必填	无
	direction		方向	取值范围[0~360]，0代表正北方，采取顺时针方向取值小数点后最多4位	非必填	无
	height		高度	单位：米小数点后最多3位	非必填	无
	accuracy		定位精度	仅允许输入数字小数点后最多3位	非必填	无
	props		用户自定义字段		非必填	无
		<key-value-track>		此字段为用户针对轨迹的自定义字段，若想使用必须先在“增加轨迹的自定义字段”中进行创建字段。并且此之中必须为一个json格式对象，需要按照定义的类型上传数据，例如定义为int，则仅上传数字。仅支持中文、英文大小字母、英文下划线"_"、英文横线"-"、数字和“.”,不能以"_"开头。内容最长不得超过128字符	非必填	无

points参数内容示例：

{"location":"116.397428,39.90923",

"locatetime":1544176895000,

"speed":40,

"direction":120,

"height":39,

"accuracy":20},

{"location":"116.397435,39.90935",

"locatetime":1544176913000,

"speed":40,

"direction":110,

"height":39,

"accuracy":20}

名称		含义	字段类型
errcode		结果状态码	数值
errmsg		返回结果状态码描述	String
errdetail		错误细节	String
data		数据结果
	errorpoints	错误点的数据。为json结构。Json节点如下： _param_err_info 错误信息类型：string _err_point_index 错误点的位置类型：string （以下参数类型和请求参数的类型相同） accuracy定位精准度 location用户定位的经纬度坐标 speed速度 locatetime 定位时间 direction方向 height 高度 props 用户自定义字段	String