终端位置实时监控 最后更新时间: 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 代表自定义字段内容 |
自定义类型 |
|||