轨迹上传及管理 最后更新时间: 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 |