浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。
排单排线结果页
下载开发文档

排单排线结果页是智能调度的前端SDK API @baidu-map/ros-sdk

npm version
产品简介

智能调度前端SDK是为了帮助客户能够在自己的系统中快速集成智能调度的能力,提供诸如路线结果展示、路线调整、路线计算、网点定位、车辆控制、配载3D展示、未分配订单查询等功能与UI界面。UI界面主题支持自定义能够适配客户系统。同时支持代理模式使SDK信息更加安全,多参数、多事件的配置也能更加灵活的适配客户系统。

功能展示

路线结果展示

adjustresult.png

路线调整

adjustroute.pngadjustroute2.png

配载展示

adjustarrange.png
快速上手

引入项目

<script src="https://unpkg.com/@baidu-map/ros-sdk@0.0.1/dist/index.umd.min.js"></script>

使用示例

// CDN方式引入时
new window.BAIDU_ROS_SDK({
domId: "root", // ros展示的dom id(必填)
serveAk: "服务AK", // 服务ak(当isProxy为false时 必填)
taskId: "taskId", // 任务id(必填)
isProxy: true, // 是否开启代理(非必填,默认false)
prefixPath: "", // 请求前缀(非必填)
webAk: "您的AK", // 地图jsapi ak(必填)
commitId: "", // commitId(非必填)
eventCallBack: () => {}, // 内置的一些事件回调(非必填)
datafeed: { // 数字字典,会根据传入的key:value替换界面上的展示文本(非必填)
units: "条数",
unitsSuffix: "条",
orderNum: "客户数",
orderCode: "买卖许可证号",
serviceId: "买卖许可证号",
}
})

参数说明

参数名是否必填类型描述
domIdStringros展示的domid
serveAk当isProxy为false时,为必填项,即为非代理模式String服务ak
isProxyBoolean是否开启代理(默认false)
taskIdString任务id
webAkString地图jsapiak:申请地址
prefixPathString请求前缀
commitIdStringcommitId
eventCallBackFunction(EventCallBackOptions): void内置的一些事件回调
datafeedDataFeed数字字典配置,对sdk界面展示的文本进行自定义
functionFieldFunctionField控制一些字段和功能的显示隐藏
themeString主题颜色
EventCallBackOptions
参数描述
methodNameString事件名称:
onSaveStart: 保存开始;
onSaveEnd: 保存结束;
onCalculationStart: 计算开始;
onCalculationEnd: 计算结束;
onConfirmStart: 确认结果开始;
onConfirmEnd: 确认结果结束;
successBoolean事件是否成功
dataObject事件附带的数据
DataFeed
参数名称默认值描述
units'件数'件数
unitsSuffix'件'units的单位后缀
orderNum'订单数'订单数
orderCode'订单号'订单号
serviceId'ServiceId'ServiceId
baseSheetName'基本信息'导出文件的基本信息的sheet名称
baseSheetTitle['线路编号', '车型', '装载率(重量)', '装载率(体积)', '装载率(件数)', '订单数量', '里程(公里)', '耗时(小时)']基本信息的表头名称
routeSheetName'路线'导出文件的路线信息的sheet名称
routeSheetTitle['顺序', '网点ID', '坐标', '地址', '货物重量(吨)', '货物体积(立方米)', '货物件数(件)', '时间窗口', '停留时间(分钟)', '预计到达时间', '预计离开时间']路线信息的表头名称
FunctionField
参数名称默认值(true:显示,false:隐藏)描述
estimatedCosttrue预估费用
stowagetrue配载功能
additionTrucktrue增加运输车按钮
savetrue保存按钮
startCalculatingtrue开始计算按钮
headerCommitIdtrue顶部-commitid
headerConfirmResulttrue顶部-确认结果
detailOrderTypetrue详情-订单类型
detailServiceIdtrue详情-serviceId
detailOrderPricetrue详情-订单价格
detailAddresstrue详情-地址
detailRoadNametrue详情-道路名称
detailRoadGradetrue详情-道路等级
detailLinkIdtrue详情-linkid
detailSkillstrue详情-特性
detailRectifyLocationtrue详情-修正点坐标
detailTimeWindowstrue详情-时间窗口
detailArriveTimeStrtrue详情-预计到达时间
detailEndTimeStrtrue详情-预计离开时间
detailLocationtrue详情-坐标
detailTotalWeighttrue详情-总重量
detailTotalVolumetrue详情-总体积
detailTotalUnitstrue详情-总件数
detailReasontrue详情-未分配原因
detailWeighttrue详情-装载重量
detailVolumetrue详情-装载体积
detailUnitstrue详情-件数
非代理模式

即通过SDK集成的智能调度页面在客户系统内展示,但是所有的请求都是直连百度地图,客户可以通过sdk的事件和一些参数配置做一些通知的接收和配置。非代理模式,需要在页面源码中暴露服务端AK,存在安全风险,建议仅在测试验证时,或者可限制访问IP范围的场景下使用,在生产环境下更建议使用代理模式。

proxy1.png
代理模式

即智能调度SDK所有的服务请求都通过客户的服务进行代理转发,客户可以在服务端精准把控服务执行时机和一些安全性的校验。

proxy2.png

nginx代理配置例子

# 如果配置的有请求前缀可以在这里加上
location /ros/ {
set $args "$args&ak=您的ak";
proxy_pass https://api.map.baidu.com/ros/;
proxy_set_header Host api.map.baidu.com;
}

上一篇

多点有序排单查询

下一篇

更新日志

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