Browse Source

增加上报轨迹接口

gmw 4 years ago
parent
commit
a4a685024f
1 changed files with 63 additions and 0 deletions
  1. 63 0
      README.md

+ 63 - 0
README.md

@@ -36,6 +36,8 @@
     - [创建委托代收合同接口](#%E5%88%9B%E5%BB%BA%E5%A7%94%E6%89%98%E4%BB%A3%E6%94%B6%E5%90%88%E5%90%8C%E6%8E%A5%E5%8F%A3)
 - [实名认证类接口](#%E5%AE%9E%E5%90%8D%E8%AE%A4%E8%AF%81%E7%B1%BB%E6%8E%A5%E5%8F%A3)
     - [实名认证接口](#%E5%AE%9E%E5%90%8D%E8%AE%A4%E8%AF%81%E6%8E%A5%E5%8F%A3)
+- [位置信息类接口](#%E4%BD%8D%E7%BD%AE%E4%BF%A1%E6%81%AF%E7%B1%BB%E6%8E%A5%E5%8F%A3)
+    - [上报运单轨迹接口](#%E4%B8%8A%E6%8A%A5%E8%BF%90%E5%8D%95%E8%BD%A8%E8%BF%B9%E6%8E%A5%E5%8F%A3)
 - [接口参数说明](#%E6%8E%A5%E5%8F%A3%E5%8F%82%E6%95%B0%E8%AF%B4%E6%98%8E)
     - [运单](#%E8%BF%90%E5%8D%95)
     - [撮合运单](#%E6%92%AE%E5%90%88%E8%BF%90%E5%8D%95)
@@ -48,6 +50,7 @@
     - [车辆](#%E8%BD%A6%E8%BE%86)
     - [收款人](#%E6%94%B6%E6%AC%BE%E4%BA%BA)
     - [经纪人](#%E7%BB%8F%E7%BA%AA%E4%BA%BA)
+    - [位置信息](#%E4%BD%8D%E7%BD%AE%E4%BF%A1%E6%81%AF)
 
 <!-- /TOC -->
 
@@ -1103,6 +1106,47 @@ https://wlhy.ali.56fanyun.com/order/create_order?access_token=fe12047e-52b1-418c
 }
 ```
 
+
+# 位置信息类接口
+
+## 上报运单轨迹接口
+
+**简要描述:** 上报运单轨迹接口,位置信息必须是在上报运单的运输时间范围内的,否则会被拒绝。上报后如果无法看到轨迹,先确认运单绑定的设备是否在智能管车中绑定了小黑卡,若已绑定小黑卡则将使用小黑卡的轨迹数据。
+
+**请求 URL:** `/gps/report_gps_data_for_order`
+
+**请求方式:** POST
+
+**需要AccessToken:** 是
+
+**调用限制:** 120次/分钟
+
+**请求参数:**
+
+|名称|说明|类型|
+|---|---|---|
+|**orderNumber**  <br>*必填*|运单号|string|
+|**gpsDataList**  <br>*必填*|位置信息列表  <br>**长度** : `1 - 500`|< [位置信息](#位置信息) > array|
+
+- 调用成功示例
+
+```java
+{
+    "code": 200,
+    "data": true,
+    "message": null
+}
+```
+
+- 调用失败示例
+
+```java
+{
+    "code": 500,
+    "message": "xxxxxxxx"
+}
+```
+
 # 接口参数说明
 
 ## 运单
@@ -1326,3 +1370,22 @@ https://wlhy.ali.56fanyun.com/order/create_order?access_token=fe12047e-52b1-418c
 |**idCard**  <br>*必填*|身份证号|string|
 |**idCardAddress**  <br>*可选*|身份证地址|string|
 |**remark**  <br>*可选*|备注  <br>**长度** : `1 - 200`|string|
+
+## 位置信息
+
+|名称|说明|类型|
+|---|---|---|
+|**longitude**  <br>*必填*|经度|number (double)|
+|**latitude**  <br>*必填*|纬度|number (double)|
+|**locateTime**  <br>*必填*|定位时间(时间戳,精确到秒)|integer (int32)|
+|**locateType**  <br>*必填*|定位类型:(0:未知,1:GPS,2:基站定位,4:北斗定位,5:GPS 和北斗定位)|integer (int32)|
+|**runStatus**  <br>*必填*|设备运行状态(1:行驶,2:停止,3:离线)|integer (int32)|
+|**addr**  <br>*可选*|设备完整定位地址,包含省市区  <br>**例** : `浙江省杭州市西湖区计量大厦`|string|
+|**province**  <br>*可选*|定位省份|string|
+|**city**  <br>*可选*|定位城市|string|
+|**roadName**  <br>*可选*|定位街道|string|
+|**speed**  <br>*可选*|设备速度(单位:km/h)|number (double)|
+|**direction**  <br>*可选*|设备运动方向(单位:角度)|number (double)|
+|**temperature**  <br>*可选*|设备温度(单位:度)|number (double)|
+|**humidity**  <br>*可选*|设备湿度(单位:度)|number (double)|
+|**powerRate**  <br>*可选*|设备电量(单位:%)|integer (int32)|