开发 猎鹰轨迹服务 开发指南 API文档 终端位置实时监控

终端位置实时监控 最后更新时间: 2022年01月11日

简介

本篇介绍查询终端实时位置的功能。

使用限制

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

查询终端位置

  • 接口说明

通过指定服务与终端,返回该终端指定轨迹的最后位置,支持对终端最后位置的实时查询与历史查询;

请注意,需要有一段正常的连续轨迹(至少5个点)才能进行终端位置查询,否则接口会报错。

  • URL地址

地址

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

请求方式

GET

  • 请求参数

参数名

含义

规则说明

是否必须

缺省值

key

请求服务权限标识

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

必填

sid

服务编号

sid为终端所属service唯一编号

必填 

无 

tid

设备编号

tid为终端唯一编号

必填

无  

trid 

轨迹编号

trid为轨迹唯一编号

非必填

correction

是否进行轨迹纠偏

默认为driving

driving:用驾车模式纠偏,返回纠偏后的最后一个点

n :不纠偏,返回用户上传的最后一个点      


纠偏后的结果需要注意:

1、若上传点少于3个则很有可能无法得到正确结果。

2、若最后1个点和前面几个点距离差距过大(距离超过100米或1分钟),结果也可能无法得到正确的结果。

3、如果纠偏的话,很有可能无法返回定位时间、精度、方向、速度、高度等相关字段。

driving

  • 返回结果

名称

含义

字段类型

说明

errcode

结果状态码

数值 


errmsg

返回结果状态码描述

String


errdetail

错误细节

String


data

返回的具体结果信息 




location

最后的经纬度

格式:X,Y 

String



locatetime

最后一次的定位时间

单位:毫秒

数值



accuracy

定位精度 

double



direction

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

double



speed

速度,单位:km/h

double



height

高度,单位:米

double



props

自定义字段内容





<key-value-terminal>

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

key 代表自定字段名字

value 代表自定义字段内容

自定义类型



返回顶部 示例中心 常见问题 智能客服 公众号
二维码