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

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

更新时间:2018年09月13日

简介

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

使用限制

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

查询轨迹信息(里程、时间等)

  • 接口说明

能够查询某个终端的某条轨迹,轨迹信息包括经纬度点,里程,时间等信息,支持如下两种查询方式:

  1. 查询指定轨迹:指定服务id、终端id、轨迹id,查询指定的轨迹信息,目前最多支持查询1条轨迹;
  2. 分段查询轨迹信息:在第一种查询方式的基础上,通过设置查询的时间间隔(通过starttime和endtime限定时间间隔),分段查询轨迹数据,在分段查询中,trid、starttime、endtime均为必填信息。

请注意,该接口需要使用Get形式请求。

  • URL地址

地址

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

请求方式

GET

  • 请求参数

参数名

含义

规则说明

是否必须

缺省值

key

请求服务权限标识

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

必填

sid

服务的唯一编号

sid为终端所属service唯一编号

必填 

无 

tid

设备唯一编号

tid为终端唯一编号

必填

无  

trid 

轨迹唯一编号

trid为轨迹唯一编号

必填

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. 定位精度过滤,用于过滤掉定位精度较差的轨迹点,示例:

threshold=0:不过滤

rthreshold=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

返回结果状态码描述

String


errdetail

错误细节

String


data

返回的具体结果信息 




degradedParams

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

数组




threshold

threshold=0:未降级生效中

threshold=1:已降级不生效

数值



counts

返回的轨迹条数

数值



tracks

轨迹具体信息

数组




trid

轨迹id

String




distance

轨迹长度,单位:米

数值




time

轨迹持续时间,单位:毫秒

数值




counts

返回的轨迹点数量

数值




points

轨迹经纬度点具体信息

数组





location

经纬度

格式:X,Y 

String





locatetime

最后一次的定位时间

单位:毫秒

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

数值





accuracy

定位精度 

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

double





direction

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

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

double





speed

速度,单位:km/h

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

double





height

高度,单位:米

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

double





props

自定义字段内容







<key-value-traces>

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

key 代表自定字段名字

value 代表自定义字段内容

自定义类型




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