开发 猎鹰轨迹服务 开发指南 API文档 轨迹查询及纠偏

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

简介

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

使用限制

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

查询轨迹信息

  • 接口说明

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

  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,
单次查询最多支持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 代表自定义字段内容

  • 服务示例
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

请求方式

POST/GET

  • 请求参数

参数名

含义

规则

是否必填

缺省值

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)

  • 特别说明
  1. 建议3-5s传一个点最佳,轨迹长度理论上不能超过300KM;
返回顶部 示例中心 常见问题 智能客服 公众号
二维码