轨迹上传及管理 最后更新时间: 2021年01月22日
简介
本篇介绍如何创建轨迹，轨迹如何上传猎鹰之中以及如何进行管理。
使用限制
服务调用量的限制请点击这里查阅。
创建轨迹
- 接口说明
创建一条轨迹，一个终端下最多可创建500000条轨迹。
- 服务地址
|
URL |
https://tsapi.amap.com/v1/track/trace/add |
|
请求方式 |
POST |
- 请求参数
|
参数名 |
含义 |
规则说明 |
是否必须 |
缺省值 |
|
|---|---|---|---|---|---|
|
key |
请求标识 |
用户在高德地图官网申请Web服务API类型KEY |
必填 |
无 |
|
|
sid |
服务编号 |
sid为用户希望增加轨迹的终端所属 Service 唯一编号 |
必填 |
无 |
|
|
tid |
设备编号 |
tid为用户希望增加轨迹的终端唯一编号 |
必填 |
无 |
|
|
trname |
轨迹名称 |
开发者可为每条轨迹添加自定义名称，格式支持中文、英文大小写字母、英文下划线”_”、英文横线”-“和数字 。 长度不得超过128个字符。 |
非必填 |
系统随机命名 |
|
- 返回结果
|
名称 |
含义 |
字段类型 |
|
|---|---|---|---|
|
errcode |
结果状态码 |
数值 |
|
|
errmsg |
返回结果状态码描述 |
String |
|
|
errdetail |
错误细节 |
String |
|
|
data |
|||
|
trid |
轨迹的唯一编号 |
数值 |
|
|
trname |
轨迹名称 |
String |
|
删除轨迹
- 接口说明
删除一条轨迹，轨迹删除后无法进行恢复。
- 服务地址
|
URL |
https://tsapi.amap.com/v1/track/trace/delete |
|
请求方式 |
POST |
- 请求参数
|
参数名 |
含义 |
规则说明 |
是否必须 |
缺省值 |
|
|---|---|---|---|---|---|
|
key |
请求服务权限标识 |
用户在高德地图官网申请Web服务API类型KEY |
必填 |
无 |
|
|
sid |
服务的唯一编号 |
此ID为用户希望删除轨迹的终端所属服务唯一编号 |
必填 |
无 |
|
|
tid |
设备唯一编号 |
此ID为用户希望删除轨迹的终端唯一编号 |
必填 |
无 |
|
|
trid |
需要删除的轨迹ID |
此ID为用户希望删除轨迹的唯一编号 |
必填 |
无 |
|
- 返回结果
|
名称 |
含义 |
字段类型 |
|
|---|---|---|---|
|
errcode |
结果状态码 |
数值 |
|
|
errmsg |
返回结果状态码描述 |
String |
|
|
errdetail |
错误细节 |
String |
|
轨迹点上传（单点、批量）
- 接口说明
- 可以将终端的轨迹点通过经纬度上传接口进行上传，支持批量上传以及单点上传。
- 在上传经纬度之前需要先通过创建轨迹接口创建一条轨迹，拿到trid，根据trid上传经纬度点；如果用户指定了trid（轨迹id），但是trid不存在，该点按照trid字段为空存储，并返回对应的错误信息：trid不存在，点已存储，此时点信息会绑定在tid上，不会生成轨迹。
- 若一次上传多个点，其中有一个/多个出错时，服务会进行报错，但是正确的点会上传到服务器之中可以正常使用，并且在结果之中会显示出错点的序号。例如：用户上传了A、B、C、D、E 这五个点，其中C点的数据是错误的，服务会返回报错结果，及序号：3；但是A、B、D、E这4个点已经成功上传
- 服务地址
|
URL |
https://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 |
|