您现在的位置: 开发 > 猎鹰轨迹服务 > 开发指南 > API文档 > 轨迹查询及纠偏

轨迹查询及纠偏 最后更新时间: 2021年02月01日

简介

本篇介绍通过轨迹查询接口实现查询轨迹信息、轨迹纠偏和里程核算的功能。

使用限制

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

查询轨迹信息

  • 接口说明

轨迹信息包括经纬度点,里程,时间等信息,查询策略支持如下两种方式:

  1. 查询某条指定轨迹:指定服务id、终端id、轨迹id,查询指定的轨迹信息,单次最多查询一条轨迹;
  2. 查询指定终端特定时间下的所有轨迹:指定服务id、终端id、并设置查询的时间间隔,查询该时间范围内的所有分段轨迹数据。
  • 服务地址

URL

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

请求方式

GET

  • 请求参数

参数名

含义

规则说明

是否必须

缺省值

key

请求服务权限标识

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

必填

sid

服务的唯一编号

sid为终端所属service唯一编号

必填 

无 

tid

设备唯一编号

tid为终端唯一编号

必填

无  

trid 

轨迹唯一编号

trid为轨迹唯一编号

至少必填一项

“查询指定轨迹”则必填轨迹唯一编号trid;

“查询指定终端指定时间下的所有

轨迹”则必填时间参数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

查询页数

需要查询第几页数据。

非必填

1

pagesize

每页点数

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

非必填

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 代表自定义字段内容

  • 服务示例
https://tsapi.amap.com/v1/track/terminal/trsearch?key=<用户的key>&sid=1&trid=1&tid=1&starttime=1532432593000&endtime=1532518993000&correction=denoise=1,mapmatch=0,attribute=0,threshold=0,mode=driving&page=1&pagesize=20

查询轨迹所在道路属性

  • 接口说明

轨迹道路属性查询属于猎鹰轨迹服务,服务支持查询轨迹点所在道路的一系列道路属性数据,包括道路等级、道路名称、道路限速等。本功能属于高阶服务,需要有需求的开发者通过工单联系我们申请开放。

  • 服务地址

地址

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

请求方式

GET

  • 请求参数

参数名

含义

规则

是否必填

缺省值

key

高德Key

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

必填

sid

服务唯一编号

sid为终端所属service唯一编号

必填

tid

设备唯一编号

tid为终端唯一编号

必填

trid

轨迹唯一编号


trid为轨迹唯一编号

必填

threshold

精度过滤条件

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

可选

0

可选

0

  • 返回参数

参数名

类型

说明

errcode

int

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

errmsg

string

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

data



counts

int

分段track数

distance

long

总里程

tracks


轨迹道路详情


roadName

string

轨迹点所在道路名称

speedLimit

int

轨迹点所在道路限速,仅针对驾车,单位KM/h。

roadClass

int

轨迹所在道路级别

points


详细轨迹点


location

string

轨迹点坐标,格式为“X,Y;X,Y..."

locatetime

string

轨迹点时间戳,单位ms。

  • 特别说明
  1. 道路属性查询中轨迹点最多不能超过1200个点,长度理论上不能超过50KM;
  2. 如果多个点在同一条道路上,则只返回其中一点的经纬度及其道路属性。
新用户
福利
示例
中心
常见
问题