文 档 中 心 / Document Center
搜索 管理中心
壹川接口文档V3
车辆行驶规划
更新时间:2018-12-18 16:31:27   更新人员:叶洋   文档状态:完成 #462    测试接口
摘要
根据车辆当前所在位置,以及车辆拉载的运单起止点信息集合,规划出最短的行驶路线。
  1. 接口基本信息
    接口名称:车辆行驶规划
    请求方法:POST
    接口地址:truck/twplan
    登录验证:是
  2. 请求参数
    参数名 参数 数据类型 是否必须 示例值 说明
    curr_posi{} 车辆当前位置 object
    ├ addr ├ 地址 string 环球中心
    ├ y ├ 纬度 float 30.568971
    └ x └ 经度 float 104.063865
    bill_list[] 规划单列表 array
    ├ e{} ├ 终点信息 object
    │ ├ addr │ ├ 地址 string 十陵
    │ ├ y │ ├ 纬度 float 30.665068
    │ └ x │ └ 经度 float 104.164558
    ├ s{} ├ 起点信息 object
    │ ├ addr │ ├ 地址 string 九方
    │ ├ y │ ├ 纬度 float 30.590663
    │ └ x │ └ 经度 float 104.065305
    └ n └ 单名 string YD001242
  3. 响应数据参数
    参数名 参数 数据类型 示例值 说明
    line[] 线路规划信息 array
    ├ p ├ 标记码 string s 该点在所属运单上的标记码,s为起点,e为终点
    ├ n ├ 点所属运单 string YD075216
    ├ y ├ 纬度 float 30.811724
    ├ x ├ 经度 float 104.16445
    └ addr └ 地址 string 新都花园
    distance 规划总行程 int 62785 单位:米
  4. 请求示例
    请求例子:
     
    apirq('truck/twplan', {
        method: "post",
        data: {
            "curr_posi": {
                "x": "104.164558",
                "y": "30.665068",
                "addr": "十陵"
            },
            "bill_list": [
                {
                    "n": "YD001242",
                    "s": {
                        "x": "104.065305",
                        "y": "30.590663",
                        "addr": "九方"
                    },
                    "e": {
                        "x": "103.986149",
                        "y": "30.756116",
                        "addr": "西南交大"
                    }
                },
                {
                    "n": "YD075216",
                    "s": {
                        "x": "104.16445",
                        "y": "30.811724",
                        "addr": "新都花园"
                    },
                    "e": {
                        "x": "104.079342",
                        "y": "30.655551",
                        "addr": "春熙路"
                    }
                }
            ]
        }
    }) 
    
    返回数据结果:
     
    {
        "code": 0,
        "msg": "ok",
        "time": "1545120767",
        "data": [
            {
                "distance": 62785,
                "line": [
                    {
                        "addr": "十陵",
                        "x": 104.164558,
                        "y": 30.665068
                    },
                    {
                        "addr": "新都花园",
                        "x": 104.16445,
                        "y": 30.811724,
                        "n": "YD075216",
                        "p": "s"
                    },
                    {
                        "addr": "春熙路",
                        "x": 104.079342,
                        "y": 30.655551,
                        "n": "YD075216",
                        "p": "e"
                    },
                    {
                        "addr": "九方",
                        "x": 104.065305,
                        "y": 30.590663,
                        "n": "YD001242",
                        "p": "s"
                    },
                    {
                        "addr": "西南交大",
                        "x": 103.986149,
                        "y": 30.756116,
                        "n": "YD001242",
                        "p": "e"
                    }
                ]
            },
            {
                "distance": 69862,
                "line": [
                    {
                        "addr": "十陵",
                        "x": 104.164558,
                        "y": 30.665068
                    },
                    {
                        "addr": "九方",
                        "x": 104.065305,
                        "y": 30.590663,
                        "n": "YD001242",
                        "p": "s"
                    },
                    {
                        "addr": "西南交大",
                        "x": 103.986149,
                        "y": 30.756116,
                        "n": "YD001242",
                        "p": "e"
                    },
                    {
                        "addr": "新都花园",
                        "x": 104.16445,
                        "y": 30.811724,
                        "n": "YD075216",
                        "p": "s"
                    },
                    {
                        "addr": "春熙路",
                        "x": 104.079342,
                        "y": 30.655551,
                        "n": "YD075216",
                        "p": "e"
                    }
                ]
            }
        ]
    } 
    
本书创建于 2018-03-30 12:03:13 ?如有疑问,请联系技术人员