示例中心
功能在线体验
控制台

高德 开发 猎鹰轨迹服务 开发指南 API文档 轨迹管理及上传

更新时间:2018年09月10日

简介

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

使用限制

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

创建轨迹

  • 接口说明

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

  • URL地址

地址

http://tsapi.amap.com/v1/track/trace/add

请求方式

POST

  • 请求参数

参数名

含义

规则说明

是否必须

缺省值

key

请求服务权限标识

用户在高德地图官网申请Web服务API类型KEY

必填

sid

服务的唯一编号

sid为用户希望增加轨迹的终端所属 Service 唯一编号

必填 

无 

tid

设备唯一编号

tid为用户希望增加轨迹的终端唯一编号

必填

无  

  • 返回结果

名称

含义

字段类型

errcode

结果状态码

数值 

errmsg

返回结果状态码描述

String

errdetail

错误细节

String

data




trid

轨迹的唯一编号

数值

删除轨迹

  • 接口说明

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

  • URL地址

地址

http://tsapi.amap.com/v1/track/trace/delete

请求方式

POST

  • 请求参数

参数名

含义

规则说明

是否必须

缺省值

key

请求服务权限标识

用户在高德地图官网申请Web服务API类型KEY

必填

sid

服务的唯一编号

此ID为用户希望删除轨迹的终端所属服务唯一编号

必填 

无 

tid

设备唯一编号

此ID为用户希望删除轨迹的终端唯一编号

必填

无  

trid

需要删除的轨迹ID

此ID为用户希望删除轨迹的唯一编号

必填

  • 返回结果

名称

含义

字段类型

errcode

结果状态码

数值 

errmsg

返回结果状态码描述

String

errdetail

错误细节

String

轨迹点上传(单点、批量)

  • 接口说明
  1. 可以将终端的轨迹点通过经纬度上传接口进行上传,支持批量上传以及单点上传。
  2. 在上传经纬度之前需要先通过创建轨迹接口创建一条轨迹,拿到trid,根据trid上传经纬度点;如果用户指定了trid(轨迹id),但是trid不存在,该点按照trid字段为空存储,并返回对应的错误信息:trid不存在,点已存储,此时点信息会绑定在tid上,不会生成轨迹。 
  3. 若一次上传多个点,其中有一个/多个出错时,服务会进行报错,但是正确的点会上传到服务器之中可以正常使用,并且在结果之中会显示出错点的序号。例如:用户上传了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字符 

非必填

  • 返回结果

名称

含义

字段类型

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 



示例中心 功能
在线体验
常见问题