智能调度路网矩阵服务

所有文档

服务概览

快速开始

使用准备

接口文档

服务功能

路网创建接口路网查询接口路网新增/减少网点坐标网点线路更新路网删除路网任务执行时间查询路网任务权重修改接口

相关资料

更新日志常见问题资源下载使用指南

路网创建接口

下载开发文档

API服务地址

https://api.map.baidu.com/ros/v1/matrix?ak=您的AK
//POST请求

请求参数

参数名称		字段类型	必填	参数说明
name		String	否	路网矩阵名称
locationType		String	否	默认值：bd09ll，wgs84：GPS 坐标，gcj02：国测局加密坐标，bd09ll：百度经纬度坐标，bd09mc：百度墨卡托坐标
locations		List<Location>	是	网点信息列表,包括仓库
	latitude	Double	是	坐标的纬度
	longitude	Double	是	坐标的经度
	key	String	是	客户网点的唯一key，排单排线需要用到, 长度最大32，路网中不允许出现key相同的情况
	name	String	否	网点名称
	address	String	否	位置信息描述
lbsType		List<String>	是	LEAST_TIME：时间优先，LEAST_DISTANCE：距离最短， NO_HIGHWAY：不走高速，客户可以根据自己场景填写，最多填写两个值
vehicleType		List<String>	是	车辆类型ID，枚举，目前支持GB01（货车，车辆长宽高6m2m3m）、SMALL（货车，车辆长宽高4m2m2m）、NORMAL（小客车）、ELECBICYCLE（两轮电动车）、BICYCLE（自行车）。该信息用于道路货车限行规避，一个车辆类型会对应一个或多个型号的车辆，由用户自行决定车辆型号与车辆类型的映射关系
params		List<String>	否	备用传参集合。配合排单排线的可跨城市、区/县数量限制参数：matrix.calc.admin.info.enable=true

返回参数

字段名称	字段类型	备注
id	String	路网ID
commitId	String	路网版本（增加网点删除网点更新网点路网版本会变化，路网ID不变）
status	String	RUNNING, FINISHED, ERROR 计算状态
errorCode	String	错误码
errorMessage	String	错误信息

请求参数填写示例



        {
            "name": "test",
            "locationType": "bd09ll",
            "lbsType": [
                "LEAST_TIME"
            ],
            "vehicleType": [
                "GB01"
            ],
            "locations": [
                {
                    "latitude": 31.863202,
                    "longitude": 117.103855,
                    "key": "aaaa"
                },
                {
                    "latitude": 31.863202,
                    "longitude": 117.103855,
                    "key": "bbbb"
                },
                {
                    "latitude": 31.863202,
                    "longitude": 117.103855,
                    "key": "vvvv"
                }
            ]
        }

返回参数示例



        HTTP/1.1 200 OK
        x-bce-request-id: f3d25695-6975-4b2b-a540-18f77907f486

        {
          "id" : "8b664a457cdd42ec871e8344368c5d79",
          "commitId": "ad51151d0252463c83030723bb2f28a0",
          "status": "RUNNING",
          "errorCode": "",
          "errorMessage": ""
        }

服务状态码

返回码	定义	常见原因


200	返回成功	服务请求正常召回
400	请求失败	请求参数不合法，请按照返回提示修改参数
401	未鉴权	ak不合法或者账号未开通相应权限
403	禁止	未开通白名单，请前往反馈工单联系我们。
503	服务不可用	服务异常，请前往反馈工单联系我们。
500	内部服务错误	服务异常，请前往反馈工单联系我们。

使用准备

路网查询接口

本篇文章对您是否有帮助？