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