瀏覽代碼

增加获取受理单轨迹数据接口

gmw 5 年之前
父節點
當前提交
9b48513c01
共有 1 個文件被更改,包括 131 次插入0 次删除
  1. 131 0
      README.md

+ 131 - 0
README.md

@@ -9,6 +9,7 @@
   - [移除设备接口](#移除设备接口)
   - [通过车牌号获取绑定设备的轨迹数据](#通过车牌号获取绑定设备的轨迹数据)
   - [获取设备号的轨迹数据](#获取设备号的轨迹数据)
+  - [获取受理单轨迹数据](#获取受理单轨迹数据)
 - [其他问题](#其他问题)
 
 ## 接口简介
@@ -319,6 +320,136 @@
 }
 ```
 
+## 获取受理单轨迹数据
+
+**简要描述:** 获取受理单轨迹数据
+
+**请求 URL:** `/gps/get_customer_order_track_points`
+
+**请求方式:** POST
+
+**需要认证:** 是
+
+**请求参数:**
+
+| 参数名 | 必选 | 类型 | 说明 |
+|:----:|:---:|:-----:|:-----:|
+| `customerOrderNumber` | 是 | `String` | 受理单号  |
+| `fields` | 否 | `String` | 需要返回的数据的字段名,中间用','隔开,如果不传则返回空,可选的字段名参考返回示例 |
+
+**返回示例**
+
+- 调用成功示例
+
+```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": "受理单不存在"
+}
+```
+
+
 ## 其他问题
 
 **1.如何在系统中查看上传的轨迹**