浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。
服务介绍
服务文档
使用指南
常见问题
更新日志
智能调度路网矩阵服务

智能调度路网矩阵服务是一类Web API接口服务,提供了物流调度排单场景的网点距离计算服务。如需试用请至反馈平台申请开通试用权限,将在1-3个工作日内处理。

功能介绍
路网矩阵服务

可计算网点两两之间的距离矩阵,提供以下功能:
1.支持计算货车距离和非货车距离
2.支持路网矩阵创建
3.支持路网矩阵查询
4.支持新增/减少/更新网点坐标
5.支持网点线路更新
6.支持路网删除
7.支持修改路网任务权重
8.支持查询路网任务执行时间


接口功能介绍
路网创建接口
https://api.map.baidu.com/ros/v1/matrix?ak={您的AK} //POST请求
请求参数
参数名称
参数类型
是否必须
参数说明
from Location 网点信息

latitude Double 坐标的纬度
longitude Double 坐标的经度
key String 客户网点的唯一key,排单排线需要用到
to Location 网点信息

latitude Double 坐标的纬度
longitude Double 坐标的经度
key String 客户网点的唯一key,排单排线需要用到

返回参数
参数名称 参数类型 参数说明
id String 路网ID
commitId String 路网版本(增加网点删除网点更新网点 路网版本会变化,路网ID不变)
status String RUNNING, FINISHED, ERROR 计算状态
errorCode String 错误码
errorMessage String 错误信息


请求示例
POST https://api.map.baidu.com/ros/v1/matrix?ak={您的AK} HTTP/1.1 

{
    "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": ""
}

路网查询接口

https://api.map.baidu.com/ros/v2/matrix?ak={您的AK}&matrixId={matrixId}&commitId={commitId} //GET请求
返回结果
参数名称 参数类型 参数说明
id String 路网ID
commitId String 路网版本(增加网点删除网点更新网点 路网版本会变化,路网ID不变)
status String RUNNING, FINISHED, ERROR 计算状态
errorCode String 错误码
errorMessage String 错误信息

路网新增/减少网点/更新网点坐标
https://api.map.baidu.com/ros/v2/matrix?ak={您的AK}&matrixId={matrixId} //PUT请求
请求参数
参数名称
参数类型
是否必须
参数说明
locations List<Location> 网点列表

latitude Double 坐标的纬度
longitude Double 坐标的经度
key String 客户网点的唯一key,排单排线需要用到,长度最大32
type String ADD , DELETE,UPDATE

返回参数
参数名称 参数类型 参数说明
id String 路网ID
commitId String 路网版本(增加网点删除网点更新网点 路网版本会变化,路网ID不变)
status String RUNNING, FINISHED, ERROR 计算状态
errorCode String 错误码
errorMessage String 错误信息

网点线路更新
https://api.map.baidu.com/ros/v2/matrix/point?ak={您的AK}&matrixId={matrixId}//PUT请求
请求参数
参数名称
参数类型
是否必须
参数说明
from Location 网点信息

latitude Double 坐标的纬度
longitude Double 坐标的经度
key String 客户网点的唯一key,排单排线需要用到
to Location 网点信息

latitude Double 坐标的纬度
longitude Double 坐标的经度
key String 客户网点的唯一key,排单排线需要用到

返回参数
参数名称 参数类型 参数说明
id String 路网ID
commitId String 路网版本(增加网点删除网点更新网点 路网版本会变化,路网ID不变)
status String RUNNING, FINISHED, ERROR 计算状态
errorCode String 错误码
errorMessage String 错误信息

路网删除
https://api.map.baidu.com/ros/v2/matrix/delete?ak={您的AK} //PUT请求
请求参数
参数名称
参数类型
参数说明

matrixIds

List<String> 网点的集合Id

路网任务执行时间查询接口
https://api.map.baidu.com/ros/v1/matrix/current/task?ak={您的AK} //GET请求
请求示例
GET https://api.map.baidu.com/ros/v1/matrix/current/task?ak={您的AK} HTTP/1.1 
返回示例
HTTP/1.1 200 OK
x-bce-request-id: c3d25695-697f-4b2b-a540-18f77907f486

[
    {
        "matrixId" : "d",
        "commitId" : "v"
        "status" : "RUNNING",
        "time" : "3分钟";
    }
]

路网任务权重修改接口
https://api.map.baidu.com/ros/v1/matrix/weight?ak={您的AK} //PUT请求
请求参数
参数名称
参数类型
是否必填 参数说明
matrixId String 路网ID
weight Integer 该路网的权重 0最低, 10最高

请求示例
GET https://api.map.baidu.com/ros/v1/matrix/weight?ak={您的AK} HTTP/1.1 

{
    "matrixId": "matrixId",
    "weight" : 8
}

返回示例
HTTP/1.1 200 OK
x-bce-request-id: c3d25695-697f-4b2b-a540-18f77907f486

错误码
错误码 说明
MatrixNotFound 找不到路网
InvalidRequestParam 请求参数错误
TypeEmpty 更新网点的类型不能为空
LocationEmpty 网点信息不能为空
MatrixCommitIdNotFound 路网版本未找到
NotFoundAvailableMatrix 找不到可用的路网
ProblemIdsMappingError 单据中的ID在可用的路网中未找到
MatrixNotFinishedUpdate 当前路网还未完成,不能进行网点的变更操作
LocationIdsNotFound 单据中的用户网点未找到
LbsTypesNotFound 驾驶策略维度信息在路网中未找到
VehicleTypeTypesNotFound 车型维度信息在路网中未找到
ServerInternalError 系统错误
TypesNotFoundInMatrix 无法获取维度信息
LbsTypeNotFoundInMatrix 无法获取驾驶策略维度信息
VehicleTypeNotFoundInMatrix 无法获取车型维度信息
MatrixPointError 网点中的信息有空值
MatrixLocationKeyError 网点中的key最长为32

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

使用方法
    服务使用流程
编码说明

API请求中需要用到中文或一些特殊字符的参数,如query、region等,为了避免提交到后台乱码,需要对这几个参数值进行编码处理,转换成UTF-8字符的二字符十六进制值,凡是不在下表中的字符都需要进行编码。

字符集合 字符
URL非保留字
a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 - _ . ~
URL保留字
 ! * ' ( ) ; : @ & = + $ , / ? % # [ ]

如果中文参数中使用URL保留字字符的字面意思,例如:region关键字取值为"?北京",检索关键字包含一个问号,此问号也必须进行编码。

附注:

javascript中一般采用encodeURIComponent函数对特殊字符进行编码。

Java中可以使用函数URLEncoder.encode对特殊字符进行编码。

C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。

php中可以使用函数urlencode对特殊字符进行编码。


服务常见问题
1、如何开通路网矩阵API?

路网矩阵API暂未提供免费配额,如需试用请至反馈平台申请开通试用权限,将在1-3个工作日内处理。


2020年2月25日

V1.0


产品上线
智能调度路网矩阵服务上线

  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

如发现文档错误,或对此文档有更好的建议,请在下方反馈。问题咨询请前往反馈平台提交工单咨询。

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消