|
@@ -2,17 +2,16 @@
|
|
|
|
|
|
<!-- TOC -->
|
|
|
|
|
|
-- [TMS三方设备GPS接口文档](#tms三方设备gps接口文档)
|
|
|
- - [接口简介](#接口简介)
|
|
|
- - [轨迹数据对接流程](#轨迹数据对接流程)
|
|
|
- - [接口详细信息](#接口详细信息)
|
|
|
- - [添加设备接口](#添加设备接口)
|
|
|
- - [上传设备状态位置数据接口](#上传设备状态位置数据接口)
|
|
|
- - [移除设备接口](#移除设备接口)
|
|
|
- - [通过车牌号获取绑定设备的轨迹数据](#通过车牌号获取绑定设备的轨迹数据)
|
|
|
- - [获取设备号的轨迹数据](#获取设备号的轨迹数据)
|
|
|
- - [获取受理单轨迹数据](#获取受理单轨迹数据)
|
|
|
- - [其他问题](#其他问题)
|
|
|
+- [TMS三方设备GPS接口文档](#tms%E4%B8%89%E6%96%B9%E8%AE%BE%E5%A4%87gps%E6%8E%A5%E5%8F%A3%E6%96%87%E6%A1%A3)
|
|
|
+ - [接口简介](#%E6%8E%A5%E5%8F%A3%E7%AE%80%E4%BB%8B)
|
|
|
+ - [轨迹数据对接流程](#%E8%BD%A8%E8%BF%B9%E6%95%B0%E6%8D%AE%E5%AF%B9%E6%8E%A5%E6%B5%81%E7%A8%8B)
|
|
|
+ - [接口详细信息](#%E6%8E%A5%E5%8F%A3%E8%AF%A6%E7%BB%86%E4%BF%A1%E6%81%AF)
|
|
|
+ - [添加设备接口](#%E6%B7%BB%E5%8A%A0%E8%AE%BE%E5%A4%87%E6%8E%A5%E5%8F%A3)
|
|
|
+ - [上传设备状态位置数据接口](#%E4%B8%8A%E4%BC%A0%E8%AE%BE%E5%A4%87%E7%8A%B6%E6%80%81%E4%BD%8D%E7%BD%AE%E6%95%B0%E6%8D%AE%E6%8E%A5%E5%8F%A3)
|
|
|
+ - [移除设备接口](#%E7%A7%BB%E9%99%A4%E8%AE%BE%E5%A4%87%E6%8E%A5%E5%8F%A3)
|
|
|
+ - [通过车牌号获取绑定设备的轨迹数据](#%E9%80%9A%E8%BF%87%E8%BD%A6%E7%89%8C%E5%8F%B7%E8%8E%B7%E5%8F%96%E7%BB%91%E5%AE%9A%E8%AE%BE%E5%A4%87%E7%9A%84%E8%BD%A8%E8%BF%B9%E6%95%B0%E6%8D%AE)
|
|
|
+ - [获取设备号的轨迹数据](#%E8%8E%B7%E5%8F%96%E8%AE%BE%E5%A4%87%E5%8F%B7%E7%9A%84%E8%BD%A8%E8%BF%B9%E6%95%B0%E6%8D%AE)
|
|
|
+ - [其他问题](#%E5%85%B6%E4%BB%96%E9%97%AE%E9%A2%98)
|
|
|
|
|
|
<!-- /TOC -->
|
|
|
|
|
@@ -324,137 +323,6 @@
|
|
|
}
|
|
|
```
|
|
|
|
|
|
-### 获取受理单轨迹数据
|
|
|
-
|
|
|
-**简要描述:** 获取受理单轨迹数据
|
|
|
-
|
|
|
-**请求 URL:** `/gps/get_customer_order_track_points`
|
|
|
-
|
|
|
-**请求方式:** POST
|
|
|
-
|
|
|
-**需要认证:** 是
|
|
|
-
|
|
|
-**请求参数:**
|
|
|
-
|
|
|
-| 参数名 | 必选 | 类型 | 说明 |
|
|
|
-|:----:|:---:|:-----:|:-----:|
|
|
|
-| `customerOrderNumber` | 是 | `String` | 受理单号 |
|
|
|
-| `fields` | 是 | `String` | 需要返回的数据的字段名,中间用','隔开,如果不传则返回空,可选的字段名参考返回示例中,例:`fields: "path,address,locateTypes"` |
|
|
|
-
|
|
|
-**返回示例**
|
|
|
-
|
|
|
-- 调用成功示例
|
|
|
-
|
|
|
-```java
|
|
|
-
|
|
|
-{
|
|
|
- "code": 200,
|
|
|
- "message": null,
|
|
|
- "data" : {
|
|
|
- "path" : [ [ 120.1242792, 30.2776902 ], ... ], //定位点的经纬度信息
|
|
|
- "address" : [ "浙江省 杭州市 西湖区 万塘路 靠近广发银行(文三支行)", ...], //地址,值与path字段对应
|
|
|
- "locateTypes" : [ 2, 2, 2, ... ], //定位类型,值与path字段对应,类型:0未定位,1:GPS,2:LBS 基站,3:其他,
|
|
|
- //4:北斗,5:GPS+北斗,6:WIFI,7:基站Wifi混合定位, 8:格洛纳斯,32:伽利略
|
|
|
- "times" : [ 1557817625, 1557817806, ... ], //定位时间,值与path字段对应
|
|
|
- "directions" : [ 0.0, 0.0, 0.0, ... ], //方向,值与path字段对应
|
|
|
- "speeds" : [ 0.0, 0.0, 0.0, ... ], //速度,值与path字段对应
|
|
|
-
|
|
|
- "DEVICE_GPS_LOCATETYPE" : 1, //定位类型, 0:gps, 1:gps+基站
|
|
|
- "isFinished" : false, //受理单是否已完成
|
|
|
- "elapsed" : 865180, //耗时
|
|
|
- "estimatedArriveTime" : 1558081837, //预估到达时间,时间戳,单位:秒
|
|
|
- "progress" : 0.43, //当前进度,1.0为100%
|
|
|
- "mileage" : 3, //已行驶里程
|
|
|
- "leftMileage" : 7, //剩余里程
|
|
|
-
|
|
|
- "currentGps" : { //当前定位信息
|
|
|
- "device" : "867282033466851",
|
|
|
- "gpsTime" : 1558080766, //定位时间
|
|
|
- "lng" : 120.1242792,
|
|
|
- "lat" : 30.2776902,
|
|
|
- "province" : "浙江省",
|
|
|
- "city" : "杭州市",
|
|
|
- "location" : "浙江省 杭州市 西湖区 万塘路 靠近广发银行(文三支行)",
|
|
|
- "roadName" : "浙江省 杭州市 西湖区 万塘路 靠近广发银行(文三支行)",
|
|
|
- "powerRate" : 79, //内置电量
|
|
|
- "locateType" : 2, //定位类型:0未定位,1:GPS,2:LBS 基站,3:其他,4:北斗,5:GPS+北斗,
|
|
|
- //6:WIFI,7:基站Wifi混合定位,8:格洛纳斯,32:伽利略
|
|
|
- "speed" : 0.0,
|
|
|
- "direction" : 0.0,
|
|
|
- "address" : { // 省市区及详细地址
|
|
|
- "province" : "浙江省",
|
|
|
- "city" : "杭州市",
|
|
|
- "district" : "西湖区",
|
|
|
- "detail" : "浙江省 杭州市 西湖区 万塘路 靠近广发银行(文三支行)"
|
|
|
- },
|
|
|
- "accStatus" : null, //Acc状态
|
|
|
- "runStatus" : 1 //行驶状态: 9 - 未激活, 1 - 行驶,2 - 停止, 3 - 离线
|
|
|
- },
|
|
|
- "consignerFence" : { //出发围栏信息
|
|
|
- "device" : "867282033466851", //设备号
|
|
|
- "fenceName" : "出发围栏", //围栏名字
|
|
|
- "fenceType" : 1, //围栏类型,1:圆形
|
|
|
- "loc" : { //经纬度
|
|
|
- "lng" : 120.10449,
|
|
|
- "lat" : 30.284574
|
|
|
- },
|
|
|
- "radius" : 1000, //围栏半径,单位:米
|
|
|
- "alarmType" : null, //警报类型,0:出围栏报警, 1:进围栏报警
|
|
|
- "remarks" : null //备注
|
|
|
- },
|
|
|
- "consigneeFence" : { //到达围栏信息,字段含义同出发围栏
|
|
|
- "device" : "867282033466851",
|
|
|
- "fenceName" : "到达围栏",
|
|
|
- "fenceType" : 1,
|
|
|
- "loc" : {
|
|
|
- "lng" : 120.141405,
|
|
|
- "lat" : 30.319037
|
|
|
- },
|
|
|
- "radius" : 1000,
|
|
|
- "alarmType" : null,
|
|
|
- "remarks" : null
|
|
|
- },
|
|
|
- "consigner" : { //发货人信息
|
|
|
- "name" : "西湖区吴彦祖", //姓名
|
|
|
- "phone" : "19102150001", //手机号
|
|
|
- "address" : { //发货地址信息
|
|
|
- "province" : "浙江省", //省
|
|
|
- "cityCode" : null, //城市代号
|
|
|
- "city" : "杭州", //城市
|
|
|
- "district" : "西湖区", //区
|
|
|
- "name" : "浙江省杭州市西湖区西湖区行政服务中心", //详细地址
|
|
|
- "address" : "浙江省杭州市西湖区西湖区行政服务中心", //详细地址
|
|
|
- "lng" : 120.10449, //经度
|
|
|
- "lat" : 30.284574 //纬度
|
|
|
- }
|
|
|
- },
|
|
|
- "consignee" : { //收货人信息
|
|
|
- "name" : "拱墅区黄晓明",
|
|
|
- "phone" : "19102151004",
|
|
|
- "address" : { //收货地址信息
|
|
|
- "province" : "浙江省",
|
|
|
- "cityCode" : null,
|
|
|
- "city" : "杭州",
|
|
|
- "district" : "拱墅区",
|
|
|
- "name" : "浙江省杭州市拱墅区拱墅区政协",
|
|
|
- "address" : "浙江省杭州市拱墅区拱墅区政协",
|
|
|
- "streetNumber" : null,
|
|
|
- "lng" : 120.141405,
|
|
|
- "lat" : 30.319037
|
|
|
- }
|
|
|
- }
|
|
|
- }
|
|
|
-}
|
|
|
-```
|
|
|
-- 调用失败示例
|
|
|
-
|
|
|
-```java
|
|
|
-{
|
|
|
- "status": 500,
|
|
|
- "message": "受理单不存在"
|
|
|
-}
|
|
|
-```
|
|
|
-
|
|
|
|
|
|
## 其他问题
|
|
|
|