基于 Java 的百度地图路线规划服务开发指南
基于 Java 调用百度地图驾车路线规划 API 的完整流程。涵盖接口请求参数与响应结构解析,演示如何使用 UniHttp 进行接口调用,并通过 Lombok 和 Gson 将 JSON 数据封装为 Java 对象。同时总结了坐标顺序及格式等常见集成问题的解决方案,适用于需要接入地图导航功能的 Java 开发者。

基于 Java 调用百度地图驾车路线规划 API 的完整流程。涵盖接口请求参数与响应结构解析,演示如何使用 UniHttp 进行接口调用,并通过 Lombok 和 Gson 将 JSON 数据封装为 Java 对象。同时总结了坐标顺序及格式等常见集成问题的解决方案,适用于需要接入地图导航功能的 Java 开发者。

在数字化时代,地理信息系统(GIS)技术已经深入到生活的方方面面。无论是日常出行规划、物流配送优化,还是城市交通管理,路线规划服务都扮演着至关重要的角色。而百度地图作为国内地图服务提供商,其强大的路线规划 API 为开发者提供了丰富的功能和数据支持。基于 Java 开发语言,结合百度地图的路线规划服务,不仅可以实现高效、精准的路线规划,还能通过 Java 的强大生态和企业级应用能力,为各类应用场景提供稳定可靠的解决方案。

本文将以 Java 编程语言为例,详细的对百度地图开放平台的驾车路线规划服务进行介绍,不仅详细的介绍其 API 和请求响应参数,同时还以 Java 为例,讲解如何对平台返回的对象进行对应的封装,通过自定义封装的结果。可以为后续的数据持久化和数据挖掘分析提供坚实的数据基础。文章首先详细的介绍百度地图的驾车路线服务,包括接口请求参数和响应参数。然后详细介绍在 Java 当中如何集成路径规划服务,并且将官方的 JSON 转换成我们的 JavaBean。无论您是地理应用开发爱好者,还是 GIS 开发工程师,均可以学习实践。
本节将对百度地图的驾车路线服务进行简单的介绍。这不仅是我们开发的重要文档,也是我们后续进行问题查找的重要资料。这里将详细的介绍百度地图提供哪些规划服务、驾车路线服务包括哪些以及驾车路线服务的请求参数和响应参数信息。
路线规划服务(又名 Direction API)是一套 REST 风格的 Web 服务 API,以 HTTP/HTTPS 形式提供了路线规划服务。

从上图可以看到,百度地图的路线规划服务视图是非常丰富的,不仅包含驾车的方式,还包含骑行、步行和公交。大家可以根据自己的业务需要来调用相应的服务即可。更多服务能力,大家可以访问百度开放平台的相关链接了解。
驾车服务作为路线服务中非常重要的一环。如今随着城市交通建设的大力发展,许多城市的道路建设几乎是日新月异,如果没有路线导航服务,出行一定会受到极大的限制。
百度驾车路线服务:
根据起终点坐标检索符合条件的驾车路线规划方案,支持以下功能:
- 支持一次请求返回多条路线(备用路线)
- 支持 18 个以内的途径点
- 支持传入车牌规避限行路段
- 支持传入起点车头方向,辅助判断起点所在正逆向车道,辅助更准确算路
- 支持未来出行规划,指定未来 7 天任意出发时刻,将依据智能预测路况和道路限行规划合理路线
驾车路线服务的访问地址如下:
https://api.map.baidu.com/direction/v2/driving?origin=40.01116,116.339303&destination=39.936404,116.452562&ak=您的 AK
| 字段名称 | 含义 | 字段类型 | 必填 | 备注 |
|---|---|---|---|---|
| ak | 用户的访问权限,AK 申请 | string | 必填 | |
| origin | 起点经纬度,小数点后不超过 6 位,40.056878,116.30815 | string | 必填 | 起点经纬度,格式为:纬度,经度;小数点后不超过 6 位,40.056878,116.30815 |
| destination | 终点经纬度,小数点后不超过 6 位,40.056878,116.30815 | string | 必填 | 终点经纬度,格式为:纬度,经度;小数点后不超过 6 位,40.056878,116.30815 |
| origin_uid | POI 的 uid(在已知起点 POI 的 uid 情况下,请尽量填写 uid,将提升路线规划的准确性,使用地点检索服务获取 uid 使用地点输入提示服务获取 uid) | string | 选填 | |
| destination_uid | POI 的 uid(在已知终点 POI 的 uid 情况下,请尽量填写 uid,将提升路线规划的准确性,使用地点检索服务获取 uid 使用地点输入提示服务获取 uid | string | 选填 | |
| waypoints | 途径点坐标串,支持 18 个以内的有序途径点。多个途径点坐标按顺序以英文竖线符号分隔,示例:40.465,116.314 | 40.232,116.352 | 40.121,116.453 | string |
| coord_type | 坐标类型,可选参数,默认为 bd09ll。允许的值为:bd09ll(百度经纬度坐标)、bd09mc(百度墨卡托坐标)、gcj02(国测局加密坐标)、wgs84(gps 设备获取的坐标)。 | string | 选填 | 默认 bd09II |
| ret_coordtype | 返回结果坐标类型,默认为 bd09ll,允许的值为:bd09ll(百度经纬度坐标)、gcj02(国测局加密坐标) | string | 选填 | 默认 bd09II |
| tactics | 0:默认 2:距离最短(只返回一条路线,不考虑限行和路况,距离最短且稳定,用于估价场景)3:不走高速 4:高速优先 5:躲避拥堵 6:少收费 7: 躲避拥堵 & 高速优先 8: 躲避拥堵 & 不走高速 9: 躲避拥堵 & 少收费 10: 躲避拥堵 & 不走高速 & 少收费 11: 不走高速 & 少收费 12:距离优先(考虑限行和路况,距离相对短且不一定稳定)13:时间优先 | int | 选填 | 默认 0:默认策略 |
| alternatives | 是否返回备选路线 类型:string 可选值:0:返回一条推荐路线 1:返回 1-3 条路线供选择 | int | 选填 | 默认 0 |
| cartype | 车辆类型,区分车辆是普通燃油车或纯电动汽车。由于部分城市对燃油车和电动车限行规则有差异,该字段用于结合 plate_number 车牌号来规避限行。例如:纯电动汽车在北京本地无尾号限行,而燃油车需遵守尾号限行。可选值:0:普通汽车 1:纯电动汽车 | int | 选填 | 默认 0 |
| plate_number | 车牌号,如京 A00022 用于规避车牌号限行路段。1、若有规避限行区域的可选路线,则返回规避后的路线,不会返回限行路线 2、若无规避限行的可选路线(如:起终点在限行区域内,或所有符合偏好的路线都无法规避限行区域),则返回限行路线中最优路线,并在返回字段 restriction 中提示用户路段被限行 | string | 选填 | 不填则不做规避 |
| departure_time | 设置出发时间(支持未来 7 天),UNIX 时间戳。该字段将影响 duration 字段的返回,用于返回未来驾车路线耗时。取值范围:当前时间之后 7 天*24 小时内任意时刻(超出时间范围将预估路线)若设置该参数,则路线规划服务将依据设定时间预测路况和限行规则,并据此计算路线和耗时。详细说明 | string | 选填 | 默认为当前时间 注意:该功能为高级付费服务,需通过 工单 联系工作人员开通 |
| ext_departure_time | 更多出发时间,UNIX 时间戳。该字段将影响 ext_duration 字段的返回,用于返回驾车路线历史耗时(路线在指定出发时间的耗时)。目前支持输入过去 7 天内一个或多个出发时间戳(不超过 12 个),多个时间戳之间用","英文半角逗号隔开。示例:ext_departure_time=1526527619 ext_departure_time=1526527619,1526525384,1526523654 注:目前出发时间仅影响 ext_duration 字段,还不会影响路线计算和选择。即仍按照现在的路况计算并推荐路线,但将增加返回该路线在其他时间的耗时。详细说明 | string | 选填 | 不填则不返回 ext_duration 字段 注意:该功能为高级付费服务,需通过 工单 联系工作人员开通 |
| expect_arrival_time | 预期的到达时间,UNIX 时间戳。该字段将影响 suggest_departure_time 字段的返回,用于返回建议出发时间。取值范围:当前时间之后 15 分钟的任意时刻(小于这个时间则不做处理)若设置此参数,则路线规划服务将依据设定时间计算路线和耗时,并给出建议出发时间 若算出的 suggest_departure_time 小于当前时间,则设置 suggest_departure_time 为 -1。详细说明 | string | 选填 | 不填则不返回 ext_duration 字段 注意:该功能为高级付费服务,需通过 工单 联系工作人员开通 |
| gps_direction | 起点的车头方向。字段类型:int64 取值范围:0-359 | int | 选填 | 车头方向为与正北方向顺时针夹角,该参数用于辅助判断起点所在正逆向车道,提高算路准确率。当 speed 大于 1.5 米/秒且 gps_direction 存在时,采用该方向。gps_direction 并不代表需填写从 gps 获取的方向,可以填入校正后的方向。请填写尽量准确的方向,其准确性很大程度决定了计算的精度。 |
| radius | 起点的定位精度,字段类型:float,取值范围 [0,2000] | float | 选填 | 配合 gps_direction 字段使用 |
| speed | 起点车辆的行驶速度,字段类型:float | float | 选填 | 单位:米/秒,配合 gps_direction 字段使用,当 speed 大于 1.5 米/秒且 gps_direction 存在时,采用 gps_direction 的方向。 |
| output | 表示输出类型,可设置为 xml 或 json | string | 选填 | 默认为 json |
| sn | 用户的权限签名,当 AK 设置为 SN 校验时,该参数必填 SN 计算方法 | string | 选填 | |
| timestamp | 时间戳,与 SN 配合使用 | int64 | SN 存在时必填 | |
| callback | 回调函数 | string | 选填 | 仅在 output=json 时,该参数有效 |
| intelligent_plan | 传入多个途经点,综合考虑路况、交规限行、途经点的相对位置以及路线整体的绕路成本等,支持智能调整途经点顺序,给出最优路线。可选值:0(默认值):不执行途经点智能规划 1:执行途经点智能规划。详细说明 | int | 选填 | 默认 0:不执行途经点智能规划 注意:该功能为高级付费服务,需通过 工单 联系工作人员开通 |
| walkinfo | 起终点步导路线 | int | 选填 | 1 表示下发起终点步导路线;0 不下发起终点步导路线;默认值为 0 |
| steps_info | 是否下发 step 详情 1:下发 step 详情 0:不下发 step 详情 | int | 选填 | |
| origin_bind_stategy | 起点绑路策略 0-起点绑路不剔除封闭道路 1-起点绑路剔除封闭道路 | int | 选填 | 默认值 0 |
| dest_bind_stategy | 终点绑路策略 0-终点绑路不剔除封闭道路 1-终点绑路剔除封闭道路 | int | 选填 | 默认值 0 |
| origin_road_type | 起点道路类型,0 普通道路 [默认。绑路策略不参考此入参];1 高架上;2 高架下;3 主路;4 辅路;(高速和匝道切换其实相当于主辅路切换) | int | 选填 | 默认值 0 |
| 字段名称 | 字段含义 | 字段类型 | 备注 |
|---|---|---|---|
| status | 状态码 | int | 0:成功 1:服务内部错误 2:参数无效 7:无返回结果 |
| message | 状态码对应的信息 | string | |
| type | 默认返回 2,开发者无需关注 | int | |
| result | 返回的结果 | ||
| restriction | 限行结果提示信息 若无限行路线,则返回空 若无法规避限行,则返回限行提示信息 | string | |
| total | 返回方案的总数 | int | |
| routes | 返回的方案集 | 若请求参数设置了符合规则的 departure_time,则按照设定时间的预测路况和限行规则计算路线。若未设置 departure_time,则按照当前时刻的路况和限行规则计算路线 | |
| restriction_info | |||
| status | 限行状态 | int | 取值范围【0,3】0:无限行 1:已规避限行,路线合法 2:无法规避限行,路线非法 3:疫情相关的信息 |
| desc | 限行提示语 | string | 当限行 status 为 1 或 2 时,会有相应的限行描述信息。若该路线有多条提示信息,则以英文竖线分隔符分隔,如:"已为您避开北京限行区域" "无法为您避开北京限行区域,请合理安排出行" "起点在北京限行区域,请合理安排出行" "终点在北京限行区域,请合理安排出行" "起点在北京限行区域,请合理安排出行 |
| origin | |||
| lng | 起点经度 | double | |
| lat | 起点纬度 | double | |
| destination | |||
| lng | 终点经度 | double | |
| lat | 终点纬度 | double | |
| tag | 方案标签 | string | |
| traffic_light | 红绿灯数量 | int | |
| route_id | 如无特殊需要,开发者无需关注 | string | |
| distance | 方案距离,单位:米 | int | |
| duration | 未来驾车路线耗时,单位:秒 | int | 若请求参数设置了符合规则的 departure_time,则按照设定出发时间的预测路况计算路线耗时。若未设置 departure_time,则按照当前时刻的路况计算路线耗时 注意:该功能为高级付费服务,需通过 工单 联系工作人员开通 |
| ext_duration | 驾车路线历史耗时(扩展),单位:秒 | int | 若设置了请求参数 ext_departure_time,则返回该字段;若 ext_departure_time 设置了一个或多个出发时间则以英文半角逗号","分隔返回多个扩展耗时;若扩展耗时计算失败,则返回 -1。注意:该功能为高级付费服务,需通过 联系工作人员开通 |
这里我们使用 UniHttp 来简化 Http 服务调用,关于如何快速集成 UniHttp,在博主之前的系列博客中均有所涉及,如果想了解更多使用教程,可以查询官网,也可以私信留言。这里仅详细说明如何进行访问接口的创建和本地接口的创建和集成。本节是实际的进行接口调用,并且返回相应的结果实战。
package com.yelang.project.thridinterface;
import com.burukeyou.uniapi.http.annotation.param.QueryPar;
import com.burukeyou.uniapi.http.annotation.request.GetHttpInterface;
import com.burukeyou.uniapi.http.core.response.HttpResponse;
import com.yelang.project.thirdinterface.apiprocessor.BaiduHttpApi;
/**
* - 百度驾车路径规划服务 2.0 版本
*/
@BaiduHttpApi(snMode = false)
public interface BaiduDrivingV2Service {
@GetHttpInterface(path = "/direction/v2/driving")
/**
* - 驾车路线规划
* @param ak 用户的访问权限,AK 申请
* @param origin - 起点经纬度,小数点后不超过 6 位,40.056878,116.30815
* @param destination -终点经纬度,小数点后不超过 6 位,40.056878,116.30815
* @param coordType - 坐标类型,可选参数,默认为 bd09ll。允许的值为:bd09ll(百度经纬度坐标)、bd09mc(百度墨卡托坐标)、gcj02(国测局加密坐标)、wgs84(gps 设备获取的坐标)。
* @param retCoordtype 返回结果坐标类型,默认为 bd09ll,允许的值为:bd09ll(百度经纬度坐标)、gcj02(国测局加密坐标)
* @param tactics 0:默认、2:距离最短(只返回一条路线,不考虑限行和路况,距离最短且稳定,用于估价场景)3:不走高速、4:高速优先、5:躲避拥堵、6:少收费、7: 躲避拥堵 & 高速优先 8: 躲避拥堵 & 不走高速、9: 躲避拥堵 & 少收费、10: 躲避拥堵 & 不走高速 & 少收费 11: 不走高速 & 少收费、12:距离优先(考虑限行和路况,距离相对短且不一定稳定)、13:时间优先
* @param alternatives 是否返回备选路线,类型:string。选值:0:返回一条推荐路线 1:返回 1-3 条路线供选择
* @param cartype 车辆类型,区分车辆是普通燃油车或纯电动汽车。由于部分城市对燃油车和电动车限行规则有差异,该字段用于结合 plate_number 车牌号来规避限行。例如:纯电动汽车在北京本地无尾号限行,而燃油车需遵守尾号限行。可选值:0:普通汽车、1:纯电动汽车
* @param speed 起点车辆的行驶速度,字段类型:float
* @param stepsInfo 是否下发 step 详情。1:下发 step 详情 0:不下发 step 详情
* @return
*/
public HttpResponse<String> getSearch(@QueryPar("ak") String ak, @QueryPar("origin") String origin, @QueryPar("destination") String destination, @QueryPar("coord_type") String coordType, @QueryPar("ret_coordtype") String retCoordtype, @QueryPar("tactics") int tactics, alternatives, cartype, speed, stepsInfo);
}
以上参数是根据业务的需求进行定义的,除必填的参数以外,很多选填的参数是可以不定义,直接使用默认值即可。
下面我们以从广东省广州市为起点,驾车开往贵州省铜仁市为例,车速选择匀速 100 公里,车型为普通油车、需要返回备选路线、并且返回下发详情的实例进行接口请求。这里我们使用 Junit 的方式进行集成,核心代码如下:
package com.yelang.project.unihttp;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;
import com.burukeyou.uniapi.http.core.response.HttpResponse;
import com.yelang.common.utils.StringUtils;
import com.yelang.project.thirdinterface.BaiduDrivingV2Service;
/**
* - 百度地图驾车服务测试类
*/
@SpringBootTest
@RunWith(SpringRunner.class)
public class BaiduDrivingV2ServiceCase {
private static final String BAIDU_CLIENT_AK = "yourak";
@Autowired
private BaiduDrivingV2Service drivingService;
@Test
public void testDriving() {
String origin = "23.115102,113.269043";//出发地:广东省广州市
String destination = "27.728514,109.186249";//目的地:贵州省铜仁市
String coordType = "wgs84";
String retCoordtype = "bd09ll";//返回坐标类型,请跟入参的坐标类型有所区别,返回坐标不支持 WGS84
;
;
;
;
;
HttpResponse<String> result = drivingService.getSearch(BAIDU_CLIENT_AK, origin, destination, coordType, retCoordtype, tactics, alternatives, cartype, speed, stepsInfo);
System.out.println(result.getBodyResult());
}
}
在本地 IDE 中运行以上程序后,可以看到以下输出:

在文本编辑器中对返回数据进行 json 格式化后,可以看到如下结构:

这个结构很重要,这个结构是我们下一步进行 Java 对象封装的重要参考资料。
通过上一节,我们已经成功的获取到了百度地图开放平台返回的路径规划结果,数据格式是 json,在实际业务中,我们需要使用 Java 来进行数据的持久化或者数据挖掘,因此需要将 json 反序列化成 JavaBean。这里分别介绍响应类图、以及相应的实现,最后基于 GSON 来进行对象转换说明。
根据前面的响应参数介绍以及在上一小节的真实响应对象的研究,我们大致对返回对象有了一个初印象。整理成如下类图:

根据业务的需要,为了完整的业务数据还原,这里设计 11 个类来对百度地图的路线规划服务接口返回数据进行接收。
公共对象是所有百度公共接口的父类,用来定义响应数据的公共属性,定义如下:
package com.yelang.project.meteorology.domain;
import java.io.Serializable;
import lombok.AllArgsConstructor;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;
import lombok.ToString;
/**
* - 百度接口公共 DTO 对象,用于封装通用信息
*/
@NoArgsConstructor
@AllArgsConstructor
@Setter
@Getter
@ToString
public class BdCommonDTO implements Serializable {
private static final long serialVersionUID = 4985268844473756688L;
private int status;//状态码 本次 API 访问状态,如果成功返回 0,如果失败返回其他数字。
private String message;//响应信息 对 status 的中文描述
}
驾车路线数据传输类封装了规划的路线信息,核心代码如下:
package com.yelang.project.meteorology.domain.baidudto;
import java.io.Serializable;
import com.yelang.project.meteorology.domain.BdCommonDTO;
import lombok.AllArgsConstructor;
import lombok.EqualsAndHashCode;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;
import lombok.ToString;
@NoArgsConstructor
@AllArgsConstructor
@Setter
@Getter
@ToString(callSuper=true)//callSuper=true 表示输出父类属性
@EqualsAndHashCode(callSuper=true)
public class BdDrivingDTO extends BdCommonDTO implements Serializable{
private static final long serialVersionUID = 5055488530865458258L;
private Integer type;//默认返回 2,开发者无需关注
private BdDrivingResultDTO result;
}
导航信息类包含了分段信息、方案总数、具体的方案路线信息,核心代码如下:
package com.yelang.project.meteorology.domain.baidudto;
import java.io.Serializable;
import java.util.List;
import com.google.gson.annotations.SerializedName;
import lombok.AllArgsConstructor;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;
import lombok.ToString;
@NoArgsConstructor
@AllArgsConstructor
@Setter
@Getter
@ToString
public class BdDrivingResultDTO implements Serializable{
private static final long serialVersionUID = 6407644142297216118L;
private String restriction;//限行结果提示信息,若无限行路线,则返回空,若无法规避限行,则返回限行提示信息
private int total;//返回方案的总数
@SerializedName("navi_restype")
private String naviRestype;
@SerializedName("session_id")
private String sessionId;
private List<BdDrivingRouteDTO> routes;
private String holiday;
@SerializedName("ret_coordtype")
private String retCoordtype;
@SerializedName("api_restype")
private String apiRestype;
}
具体路线分段信息类,封装了路线详情、距离、打车费用预估、预计时间和具体的转折路线列表,核心代码如下:
package com.yelang.project.meteorology.domain.baidudto;
import java.io.Serializable;
import java.util.List;
import com.google.gson.annotations.SerializedName;
import lombok.AllArgsConstructor;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;
import lombok.ToString;
@NoArgsConstructor
@AllArgsConstructor
@Setter
@Getter
@ToString
public class BdDrivingRouteDTO implements Serializable{
private static final long serialVersionUID = -2475019111446934340L;
private BdLocationDTO origin;
private BdLocationDTO destination;
private String tag;//方案标签
private String mrsl;
@SerializedName("route_md5")
private String routeMd5;
@SerializedName("data_version")
private String dataVersion;
@SerializedName("traffic_light")
private int trafficLight;
private float distance;//距离,单位米
private int duration;//未来驾车路线耗时,单位:秒
@SerializedName("taxi_fee")
private float taxiFee;
hasGuidance;
List<BdDrivingStepDTO> steps;
BdDrivingRestrictionInfoDTO restrictionInfo;
List<BdDrivingYelloTipDTO> yellowTipList;
toll;
tollDistance;
score;
String routeId;
}
篇幅有限,如果百度驾车路径规划完整响应类的代码,可以参考上述的结果先自己研究,如有问题,可以私信博主就具体的类进行交流。
最后我们将百度开放平台返回的 JSON 数据转换成 Java 对象,转换框架这里以 Gson 为例,其它的 json 框架也是可以的。转换代码如下:
Gson gson = new Gson();
if(StringUtils.isNotEmpty(result.getBodyResult())) {
BdDrivingDTO drivingDTO = gson.fromJson(result.getBodyResult(), BdDrivingDTO.class);
System.out.println(drivingDTO);
System.out.println("---------------------------");
System.out.println(gson.toJson(drivingDTO));
}
运行程序后,可以看到正常的数据输出。后续我们可以基于此和其他应用的结合。
在百度驾车路线规划服务集成过程中,可能会遇到一些问题。比如我在集成过程中就遇到了关于坐标精度和坐标和格式的问题。导致这个问题的原因主要还是对官网文档不是很熟悉,实践出真知,纸上得来终觉浅,只有经过实战才知道可能会遇到什么问题。
众所周知,在地理位置中,经纬度是描述一个点的具体格式。因此我们特别习惯在描述一个点时,使用(经度,纬度)的方式,如:113.269043,23.115102。但是这种方式在实际查询过程中会报以下错误:

解决的办法也比较简单,在百度的位置描述中,将纬度描述在前,即(纬度,经度)即可。
坐标类型永远是 GIS 应用中绕不开的话题,大家可能都以为通用的 WGS84,在接口的参数定义中,我们可以看到,查询参数的坐标是支持 WGS84 的,但是在返回的坐标中,却没有了这个参数支持。如果在返回参数中设置了 WGS84,大概率是会报错的,如下图所示:

解决办法就是按照文档调整参数设置即可。
以上就是本文的主要内容。本文将以 Java 编程语言为例,详细的对百度地图开放平台的驾车路线规划服务进行介绍,不仅详细的介绍其 API 和请求响应参数,同时还以 Java 为例,讲解如何对平台返回的对象进行对应的封装,通过自定义封装的结果。可以为后续的数据持久化和数据挖掘分析提供坚实的数据基础。文章首先详细的介绍百度地图的驾车路线服务,包括接口请求参数和响应参数。然后详细介绍在 Java 当中如何集成路径规划服务,并且将官方的 JSON 转换成我们的 JavaBean。受限于文章篇幅,很多代码和内容不能逐一展示,如对其中内容有疑问,可以留言或者私信交流。行文仓促,定有不足之处,欢迎各位朋友在评论区批评指正,不胜感激。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online
使用加密算法(如AES、TripleDES、Rabbit或RC4)加密和解密文本明文。 在线工具,加密/解密文本在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
| suggest_departure_time | 建议出发时间,单位:秒 | int64 | 若请求参数设置了符合规则的 expect_arrival_time,则按照预计到达时间预测路况计算路线,并给出建议出发时间。若算出的 suggest_departure_time 小于当前时间,则设置 suggest_departure_time 为 -1。注意:该功能为高级付费服务,需通过 工单 联系工作人员开通 |
| taxi_fee | 出租车费用,单位:元 | int |
| toll | 此路线道路收费,单位:元 | int | 此高速费为预估价格,与实际高速收费并不完全一致 |
| toll_distance | 收费路段里程,单位:米 | int |
| steps | array | 路线分段 |
| leg_index | 途径点序号 | int | 途径点序号为从 0 开始的整数,用于标识 step 所属的途径点路段如:若该 step 属于起点至第一个途径中的路段,则其 leg_index 为 0 |
| direction | 进入道路的角度 | int | 枚举值,返回值在 0-11 之间的一个值,共 12 个枚举值,以 30 度递进,即每个值代表角度范围为 30 度;其中返回"0"代表 345 度到 15 度,以此类推,返回"11"代表 315 度到 345 度";分别代表的含义是:0-[345°-15°];1-[15°-45°];2-[45°-75°];3-[75°-105°];4-[105°-135°];5-[135°-165°];6-[165°-195°];7-[195°-225°];8-[225°-255°];9-[255°-285°];10-[285°-315°];11-[315°-345°] 注:角度为与正北方向顺时针夹角 |
| distance | step 的距离信息 | int | 单位米 |
| road_name | 分段的道路名称 | string | 如'信息路' 若道路未命名或百度地图未采集到该道路名称,则返回"无名路" |
| road_type | 分段的道路类型 | int | 枚举值:返回 0-9 之间的值 0:高速路 1:城市高速路 2:国道 3:省道 4:县道 5:乡镇村道 6:其他道路 7:九级路 8:航线 (轮渡) 9:行人道路 |
| toll | 分段道路收费,单位:元 | int | 因一个收费路段可能覆盖多个 step,部分情况下费用无法按 step 准确拆分,故分段 step 收费可能存在不准确情况 |
| toll_distance | 分段道路收费路程,单位:米 | int |
| toll_gate_name | 收费站名称 | string | 只有在进收费站和出收费站时才有 |
| toll_gate_location |
| lng | 收费站位置:经度 | double | 只有在进收费站和出收费站时才有 |
| lat | 收费站位置:纬度 | double | 只有在进收费站和出收费站时才有 |
| start_location |
| lng | 分段起点经度 | double |
| lat | 分段起点纬度 | double |
| end_location |
| lng | 分段终点经度 | double |
| lat | 分段终点纬度 | double |
| path | 分段坐标 | string |
| adcodes | 分段途经的城市编码 | string | 若途经多个城市,则 adcode 以英文半角逗号相隔如:110000,120000 |
| traffic_condition | 分段路况详情 | array |
| status | 路况指数 | int | 0:无路况 1:畅通 2:缓行 3:拥堵 4:非常拥堵 |
| geo_cnt | 从当前坐标点开始,path 中路况相同的坐标点个数 | int |
| distance | 距离,从当前坐标点开始 path 中路况相同的距离,单位:米 | float | 注:单条线路中所有 distance 的和会与 route 的 distance 字段存在差异,不是完全一致 |
| end_walkinfo | 终点步导路线 | array |
| distance | 终点步导路线距离 | int | 单位米 |
| path | 终点步导路线坐标点 | string |
| start_walkinfo | 起点步导路线 | array |
| distance | 起点步导路线距离 | int | 单位米 |
| path | 起点步导路线坐标点 | string |