|
|
@@ -8,6 +8,7 @@
|
|
|
- [上传设备状态位置数据接口](#上传设备状态位置数据接口)
|
|
|
- [移除设备接口](#移除设备接口)
|
|
|
- [通过车牌号获取绑定设备的轨迹数据](#通过车牌号获取绑定设备的轨迹数据)
|
|
|
+ - [获取设备号的轨迹数据](#获取设备号的轨迹数据)
|
|
|
- [其他问题](#其他问题)
|
|
|
|
|
|
## 接口简介
|
|
|
@@ -181,7 +182,7 @@
|
|
|
|
|
|
| **参数名** | **必选** | **类型** | **说明** |
|
|
|
| :-: | :-: | :-: | - |
|
|
|
-| `carNumber` | `是` | `String` | `设备号，必填，多个设备用英文','隔开` |
|
|
|
+| `carNumber` | `是` | `String` | `车牌号，必填，多个车牌用英文','隔开` |
|
|
|
| `startTime` | `否` | `Integer` | `开始时间，如果不指定结束时间则查询开始时间到当前时间的数据` |
|
|
|
| `endTime` | `否` | `Integer` | `结束时间，如果传了结束时间必须传开始时间` |
|
|
|
|
|
|
@@ -240,6 +241,80 @@
|
|
|
}
|
|
|
```
|
|
|
|
|
|
+### 获取设备号的轨迹数据
|
|
|
+
|
|
|
+**1.简要描述** 获取设备号的轨迹数据
|
|
|
+
|
|
|
+**2.请求URL** ：`/gps/get_gps_data_by_device`
|
|
|
+
|
|
|
+**3.请求方式** ：POST
|
|
|
+
|
|
|
+**4.请求参数** ：
|
|
|
+
|
|
|
+| **参数名** | **必选** | **类型** | **说明** |
|
|
|
+| :-: | :-: | :-: | - |
|
|
|
+| `device` | `是` | `String` | `设备号，必填，多个设备用英文','隔开` |
|
|
|
+| `startTime` | `否` | `Integer` | `开始时间，如果不指定结束时间则查询开始时间到当前时间的数据` |
|
|
|
+| `endTime` | `否` | `Integer` | `结束时间，如果传了结束时间必须传开始时间` |
|
|
|
+
|
|
|
+**注：如果不传时间则只查询最近的一个轨迹点，查询时间范围不能超过5小时**
|
|
|
+
|
|
|
+**5.返回示例** ：
|
|
|
+
|
|
|
+- 调用成功示例：
|
|
|
+```java
|
|
|
+{
|
|
|
+ "code": 200,
|
|
|
+ "message": null,
|
|
|
+ "data": {
|
|
|
+ "867272034426851": //传参时的设备号
|
|
|
+ [
|
|
|
+ {
|
|
|
+ "device": "867272034426851",//设备号
|
|
|
+ "gpsTime": 1561081870, //定位时间
|
|
|
+ "lng": 120.1242792, //精度
|
|
|
+ "lat": 30.2776902, //纬度
|
|
|
+ "province": "浙江省", //省份
|
|
|
+ "city": "杭州市", //城市名
|
|
|
+ "location": "浙江省 杭州市 西湖区 万塘路 靠近广发银行(文三支行)", //定位地址
|
|
|
+ "roadName": "浙江省 杭州市 西湖区 万塘路 靠近广发银行(文三支行)", //街道名
|
|
|
+ "powerRate": 72, //电量
|
|
|
+ "humidity": null, //湿度
|
|
|
+ "temperature": null, //温度
|
|
|
+ "locateType": 2, //轨迹上报类型必填：(0：未知，1：GPS，2：基站定位，4：北斗定位，5：GPS 和北斗定位)
|
|
|
+ "speed": 0, //速度
|
|
|
+ "direction": 0, //方向
|
|
|
+ "address": {
|
|
|
+ "province": "浙江省", //省
|
|
|
+ "city": "杭州市", //市
|
|
|
+ "district": "西湖区", //区
|
|
|
+ "detail": "浙江省 杭州市 西湖区 万塘路 靠近广发银行(文三支行)" //详细地址
|
|
|
+ },
|
|
|
+ "runStatus": 1, //设备运行状态必填（1:行驶，2:停止，3:离线）
|
|
|
+ "created": 1561081873 //轨迹信息创建时间
|
|
|
+ },
|
|
|
+ {
|
|
|
+ ......
|
|
|
+ }
|
|
|
+ ],
|
|
|
+ "867212233372371": [.......],
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+- 调用失败示例：
|
|
|
+```java
|
|
|
+{
|
|
|
+ "message": "查询时间范围不得大于5小时",
|
|
|
+ "status": 500
|
|
|
+}
|
|
|
+
|
|
|
+{
|
|
|
+ "message": "车牌号XXXX未绑定设备",
|
|
|
+ "status": 500
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
## 其他问题
|
|
|
|
|
|
**1.如何在系统中查看上传的轨迹**
|
