(以“{{webapi-sidebar}} <div class="labels"><div class="interiorNav"><div class="interiorLI">服务介绍</div><div class="interiorLI">服务文档</div><div class="inter...”为内容创建页面) |
|||
第20行: | 第20行: | ||
| style="width: 135px;" | string | | style="width: 135px;" | string | ||
| style="width: 180px;" | 起点坐标 | | style="width: 180px;" | 起点坐标 | ||
− | | style="width: 428px;" | 格式为:纬度,经度。如:21. | + | | style="width: 428px;" | 格式为:纬度,经度。如:21.22345,112.11478 |
|- | |- | ||
| destination | | destination | ||
第152行: | 第152行: | ||
| style="width: 135px;" | int32 | | style="width: 135px;" | int32 | ||
| style="width: 180px;" | 排放标准 | | style="width: 180px;" | 排放标准 | ||
− | | style="width: 428px;" | 取值范围1-6,对应国1-国6标准<br/> | + | | style="width: 428px;" | 取值范围1-6,对应国1-国6标准<br/> |
|- | |- | ||
| load_weight | | load_weight |
2019年11月27日 (三) 07:54的版本
服务介绍
服务文档
使用指南
常见问题
更新日志
物流路线规划服务
物流路线规划服务(又名Logistics Direction API)是一套REST风格的Web服务API,以HTTP/HTTPS形式提供了针对物流行业的路线规划服务。目前,Logistics Direction API支持货车路线规划,覆盖中国境内地区。
功能介绍
货车路线规划
根据起终点坐标检索符合条件的货车驾车路线规划方案,支持以下功能:1. 支持全国同城/跨城路线规划
2. 支持规避物理四限:高、宽、重、轴重
3. 支持根据车牌号规避交规限行,支持区分蓝/黄/白/绿/黑车牌
4. 支持途径点,最多不超过20个
5. 支持未来出行规划,指定未来3天任意出发时刻,将依据智能预测路况和道路限行规划合理路线
6. 支持多种路线策略选择,包括省钱路线、不走高速、高速优先等策略
7. 支持规避自定义区域
接口功能文档
货车路线规划
http://api.map.baidu.com/logistics_direction/v1/truck //GET请求
货车规划请求参数
参数名称 | 是否必填 | 字段类型 | 含义 | 备注 |
---|---|---|---|---|
origin | 是 | string | 起点坐标 | 格式为:纬度,经度。如:21.22345,112.11478 |
destination | 是 | string | 终点坐标 | 格式与起点坐标相同 |
waypoints | 否 | string | 途经点坐标 | 格式:支持20个以内的有序途径点。多个途径点坐标按顺序以英文竖线符号分隔, 示例: 40.465,116.314|40.232,116.352|40.121,116.453 |
coord_type | 否 | string | 输入坐标类型 | 坐标类型,可选参数,默认为bd09ll 允许的值为: bd09ll(百度经纬度坐标) bd09mc(百度墨卡托坐标) gcj02(国测局加密坐标) wgs84(gps设备获取的坐标) |
ret_coordtype | 否 | string | 输出坐标类型 | 返回结果坐标类型,默认为bd09ll 允许的值为: bd09ll(百度经纬度坐标) gcj02(国测局加密坐标) |
height | 否 | double | 车辆高度 | 单位:米,取值[0,5.0],默认1.8,会按照填写数字进行限行规避 |
width | 否 | double | 车辆宽度 | 单位:米,取值[0,3.0],默认1.9,会按照填写数字进行限行规避 |
weight | 否 | double | 车辆总重 | 车辆总重=车辆自身重量+货物重量,单位:吨,取值[0,100],默认2.5,会按照填写数字进行限行规避 |
length | 否 | double | 车辆长度 | 单位:米,取值[0,20.0],默认4.2,会按照填写数字进行限行规避 |
axle_weight | 否 | double | 轴重 | 单位:吨,取值[0,50],默认2,会按照填写数字进行限行规避 |
axle_count | 否 | int32 | 轴数 | 取值[0,50],默认2,会按照填写数字进行限行规避 |
is_trailer | 否 | int32 | 是否是挂车 | 0:不是(默认) 1:是 |
plate_province | 否 | string | 车牌号省份 | 默认:空字串 |
plate_number | 否 | string | 车牌号(省份以外号码) | 默认:空字串 |
plate_color | 否 | int32 | 车牌颜色 | 0:蓝色(默认) 1:黄 2:黑 3:白 4:绿 |
departure_time | 否 | int32 | 出发时间 | Unix时间戳(秒),默认为当前时间,支持未来3天内的区间:(now_timestamp - 600, now_timestamp + 3 * 86400) |
tactics | 否 | int32 | 驾驶策略 | 0:默认 (时间优先) 1:距离优先 // 其他暂不支持 3:不走高速 4:高速优先 5:躲避拥堵 6:少收费 |
alternatives | 否 | int32 | 是否返回备选路线 | 0:返回一条推荐路线 (默认) 1:返回1到3条备选路线 |
alternatives | 否 | int32 | 是否返回备选路线 | 0:返回一条推荐路线 (默认) 1:返回1到3条备选路线 |
user_mark | 否 | string | 用户标识 | 规避自定义区域时的特殊字段 格式:大小写字母、数字、英文逗号、英文分号 |
displacement | 否 | int32 | 百公里油耗,单位mL | |
power_type | 否 | int32 | 动力类型 | 默认汽油 0-所有;1-汽油;2-柴油;3-电动;4-混合 |
emission_limit | 否 | int32 | 排放标准 | 取值范围1-6,对应国1-国6标准 |
load_weight | 否 | int32 | 核定载重 | 单位吨[0,1000] |
ak | 是 | string | 用户的AK,授权使用 | |
sn | 否 | string | 用户的权限签名,若用户所用AK的校验方式为SN校验时该参数必须。参考: SN校验 |
返回参数
字段名称 | 字段类型 | 字段含义 | ||||||
---|---|---|---|---|---|---|---|---|
status | int32 | 取值范围: 0:成功; 1:服务器内部错误; 2:参数错误 更多状态码详见附录 | ||||||
message | string | 状态码对应的信息 | ||||||
result | kv | 返回的结果 | ||||||
restriction | kv | 车牌限行信息(城市级别) 若一条路线触发多个限行,仅返回其中一个 | ||||||
type | string | 可能取值如下: 0:无限行;1:本地车限行,2:外地车限行,3:本地车尾号限行;4.外地车尾号限行;5其他限行 | ||||||
info | string | 限行信息的文字 | ||||||
total | int32 | 返回方案的总数(一期返回1条) | ||||||
routes | array | 返回的方案集 | ||||||
origin | lng | double | 起点经度 | |||||
lat | double | 起点纬度 | ||||||
destination | lng | double | 终点经度 | |||||
lat | double | 终点纬度 | ||||||
tag | string | 方案标签 | ||||||
distance | double | 方案距离,单位:米 | ||||||
duration | int32 | 线路耗时,单位:秒(历史eta) | ||||||
toll | int32 | 此路线道路收费,单位:元(一期小客车费用) | ||||||
toll_distance | double | 收费路段里程,单位:米(一期小客车收费里程) | ||||||
oil_cost | double | 油费,单位元 | ||||||
steps | array | 路线分段 | ||||||
leg_index | int32 | 途径点序号,为从0开始的整数,用于标识step所属的途径点路段 如:若该step属于起点至第一个途径中的路段,则其leg_index为0 | ||||||
direction | int32 | 进入道路的角度。 | ||||||
distance | double | step的距离信息 | ||||||
road_name | string | 分段的道路名称 | ||||||
road_type | int32 | 分段的道路类型 | ||||||
toll_distance | double | 分段道路收费路程,单位:米 | ||||||
toll_gate_name | string | 收费站名称(一期导航后端保证一个step只返回一个收费站信息) | ||||||
toll_gate_location | lng | double | 收费站位置:经度 | |||||
lat | double | 收费站位置:纬度 | ||||||
start_location | lng | double | 分段起点经度 | |||||
lat | double | 分段起点纬度 | ||||||
end_location | lng | double | 分段终点经度 | |||||
lat | double | 分段终点纬度 | ||||||
path | string | 分段坐标 | ||||||
traffic_condition | array | 分段路况详情(填历史路况) | ||||||
status | int | 路况指数 | ||||||
geo_cnt | int | 从当前坐标点开始,path中路况相同的坐标点个数 注:绘制路况时,指标指向第一个path的第一个点,往后数n个点组成的路段路况是一样的,计数时不算指标所在的点(当前step所有geo_cnt的和为path中的点数减1) | ||||||
distance | double | 距离,从当前坐标点开始path 中路况相同的距离,单位:米 |
使用方法
坐标系说明
.WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。
.GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。
.BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标
.路线规划服务API的输入参数支持以上三种坐标系,开发者无需进行任何坐标转换,通过请求参数"coord_type"指明所使用的坐标系即可。输出参数支持国测局坐标(gcj02)和 百度坐标(bd09ll)两种坐标,通过请求参数"ret_coordtype"进行设置。
.GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。
.BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标
.路线规划服务API的输入参数支持以上三种坐标系,开发者无需进行任何坐标转换,通过请求参数"coord_type"指明所使用的坐标系即可。输出参数支持国测局坐标(gcj02)和 百度坐标(bd09ll)两种坐标,通过请求参数"ret_coordtype"进行设置。
服务使用限制
.服务相关配额及并发请求限制请访问开发者权益页面查看。
编码说明
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对特殊字符进行编码。
附注:
.javascript中一般采用encodeURIComponent函数对特殊字符进行编码。
.Java中可以使用函数URLEncoder.encode对特殊字符进行编码。
.C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。
.php中可以使用函数urlencode对特殊字符进行编码。
服务常见问题
1、如何开通试用货车路线规划API?
货车路线规划API暂未提供免费配额,如需试用请至反馈平台申请开通试用权限,将在1-3个工作日内反馈。
2019年11月27日
V1.0
产品上线
开放物流路线规划V1.0,支持货车路线规划。