轨迹查询及纠偏 最后更新时间: 2023年04月03日

URL

 https://tsapi.amap.com/v1/track/terminal/trsearch

请求方式

GET

key

请求服务权限标识

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

必填

无

sid

服务的唯一编号

sid为终端所属service唯一编号

必填 

无 

tid

设备唯一编号

tid为终端唯一编号

必填

无  

trid 

轨迹唯一编号

trid为轨迹唯一编号

至少必填一项

“查询指定轨迹”则必填轨迹唯一编号trid，
单次查询最多支持24小时内轨迹，跨天轨
迹建议指定参数starttime及endtime；

“查询指定终端指定时间下的所有轨迹”则必填
时间参数starttime及endtime

无

starttime

起始时间

开始时间，Unix时间戳（轨迹点的定位时间）,需要精准到毫秒 

无

endtime

结束时间

结束时间，Unix时间戳（轨迹点的定位时间）,需要精准到毫秒

结束时间不能大于当前时间，且距离开始时间不能超过24小时。

若轨迹较多，建议将时间段进行拆分。 

无

correction

对轨迹进行处理

默认值为：

denoise=1,mapmatch=0,attribute=0,threshold=0,mode=driving 

取值规则为：

1.抽稀去噪： 

denoise =0：不进行抽稀去噪

denoise =1：进行抽稀去噪

2.绑路纠偏：

mapmatch=0：不进行轨迹纠偏

mapmatch=1：进行轨迹纠偏

当开启绑路纠偏时，请将抽稀去噪同时开启绑路纠偏效果会更好；

3.属性拟合：指是否将去噪、纠偏后的部分原始定位点的属性信息一同返回，设置绑路纠偏生效后，设置属性拟合才会生效。示例：

attribute=0：不进行拟合

attribute=1：进行拟合

说明：当前参数效果并不能将所有纠偏后的点的附加属性信息全部返回，返回部分原始点的属性信息；

4. 定位精度过滤，用于过滤掉定位精度较差的轨迹点，当denoise取值为1时此参数才会生效。

示例：

threshold=0：不过滤

threshold=100：过滤掉定位精度 Radius ≥ 100的点

说明：当取值=0时，则不过滤；当取值大于0的整数时，则过滤掉radius ≥ 设定值的轨迹点。例如：若只需保留 GPS 定位点，则建议设为：20；若需保留 GPS 和 Wi-Fi 定位点，去除基站定位点，则建议设为：100

5.交通方式，猎鹰将根据不同交通工具选择不同的纠偏策略，目前支持驾车示例：

mode=driving

mode=riding（当前未开放）

mode=walking（当前未开放） 

非必填

无

recoup

对轨迹进行补点

默认两点间距离超过5公里时认为点间距过远，可采用如下两种策略进行轨迹和里程的补充。

参数如下：

0：代表用直线连接方式进行补点计算；

1：代表用correction的mode方式进行补点计算，当前只开放了driving。

非必填

0

gap

补点间距

gap参数用来指定触发recoup参数生效的点间距，默认为5公里，最小50米，最大10公里，单位：米。 

非必填

5000

ispoints

是否返回轨迹点信息

是否返回tracks的points内容，默认为返回（1），可以设置为不返回（0）

非必填

1

page

查询页数

需要查询第几页数据。 最大值为100 。

非必填

1

pagesize

每页点数

每页返回点的个数，当page=1的时候起点、终点的个数不计算在内，pagesize最大值为999。

非必填

20

errcode

结果状态码

errmsg

返回结果状态码描述

errdetail

错误细节

data

返回的具体结果信息 

degradedParams

返回参数的降级状态，已降级表示参数条件不生效

threshold

threshold=0：未降级生效中

threshold=1：已降级不生效

counts

返回的轨迹条数

tracks

轨迹具体信息

trid

轨迹id

trname

轨迹名称，开发者未上传时返回系统随机命名

distance

轨迹长度，单位：米

time

轨迹持续时间，单位：毫秒

counts

返回的轨迹点数量

points

轨迹经纬度点具体信息

location

经纬度

格式：X,Y 

locatetime

最后一次的定位时间

单位：毫秒

此字段可能在correction参数生效时返回为空

accuracy

定位精度 

此字段可能在correction参数生效时返回为空

direction

方向，取值范围：[0,359]，0代表正北方，采用顺时针方向取值

此字段可能在correction参数生效时返回为空

speed

速度，单位：km/h

此字段可能在correction参数生效时返回为空

height

高度，单位：米

此字段可能在correction参数生效时返回为空

props

自定义字段内容

<key-value-traces>

用户针对轨迹的自定义字段，返回json结构的自定义字段 

key 代表自定字段名字

value 代表自定义字段内容

key

高德Key

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

必填

无

sid

服务唯一编号

sid为终端所属service唯一编号

可选，

如果不填必须传入points参数

无

tid

设备唯一编号

tid为终端唯一编号

可选，

如果不填必须传入points参数

无

trid

轨迹唯一编号

trid为轨迹唯一编号

可选，

如果不填必须传入points参数

无

points

轨迹序列

传入5-500 个顺序轨迹点，建议3-5s上报一个点。

points格式为json， 其中每个point 必须包含：location,locatetime 这2 个字段，可选speed（速度）,direction（方向）,height（高度）,accuracy（精度）这4 个字段，其他字段会被舍弃。

取值规则：

location：

格式为：X,Y

小数点后最多6位

locatetime：轨迹点的定位时间，精确到毫秒，使用UNIX 时间戳

speed：轨迹点的速度，单位：公里/小时，小数点后最多3位

direction：取值范围[0~360]，0代表正北方，采取顺时针方向取值

height：单位：米

小数点后最多3位

accuracy：仅允许输入数字

小数点后最多3位

可选，如果不填必须传入sid、tid、trid参数。

注意：sid、tid、trid、points都传时以trid对应的轨迹为准。

无

carType

车辆类型

0，客车

1，货车

可选

0

threshold

精度过滤条件

过滤精度大于等于threshold的点，0为不过滤，允许范围[0,99999]

可选

0

errcode

int

本次API访问状态，如果成功返回10000，如果失败返回其他数字。

errmsg

string

访问状态值的说明，如果成功返回"OK"，失败返回错误原因，具体见错误码说明。

data

counts

int

分段track数

distance

long

总里程

tracks

roadName

string

轨迹点所在道路名称

speedLimit

int

轨迹点所在道路限速，针对驾车。单位KM/H

roadClass

道路级别中的道路等级编号。

41000 高速公路

42000 国道

51000 省道

52000 县道

53000 乡公路

54000 县乡村内部道路

43000 主要大街、城市快速道

44000 主要道路

45000 次要道路

47000 普通道路

49 非导航道路

roadClassName

string

道路级别中的道路等级名称。

* 高速公路

* 国道

* 省道

* 县道

* 乡公路

* 县乡村内部道路

* 主要大街、城市快速道

* 主要道路

* 次要道路

* 普通道路

* 非导航道路

isToll

int

是否存在收费路段

0：不收费，1：收费

isOwnership 

int

是否含有内部道路或私有道路

0：没有，1：有

points

轨迹点

location

string

轨迹点X,Y;X,Y

locatetime

string

轨迹点时间戳（ms）