基于 Java 的百度地图驾车路线规划服务开发指南

基于 Java 的百度地图驾车路线规划服务开发指南 | 极客日志

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 位
destination	终点经纬度，小数点后不超过 6 位，40.056878,116.30815	string	必填	终点经纬度，格式为：纬度，经度；小数点后不超过 6 位
origin_uid	POI 的 uid（在已知起点 POI 的 uid 情况下，请尽量填写 uid，将提升路线规划的准确性）	string	选填
destination_uid	POI 的 uid（在已知终点 POI 的 uid 情况下，请尽量填写 uid，将提升路线规划的准确性）	string	选填
waypoints	途径点坐标串，支持 18 个以内的有序途径点。多个途径点坐标按顺序以英文竖线符号分隔	string	选填
coord_type	坐标类型，可选参数，默认为 bd09ll。允许的值为：bd09ll（百度经纬度坐标）、bd09mc（百度墨卡托坐标）、gcj02（国测局加密坐标）、wgs84（gps 设备获取的坐标）	string	选填	默认 bd09ll
ret_coordtype	返回结果坐标类型，默认为 bd09ll，允许的值为：bd09ll（百度经纬度坐标）、gcj02（国测局加密坐标）	string	选填	默认 bd09ll
tactics	0：默认；2：距离最短；3：不走高速；4：高速优先；5：躲避拥堵；6：少收费；7: 躲避拥堵 & 高速优先等	int	选填	默认 0:默认策略
alternatives	是否返回备选路线。0：返回一条推荐路线；1：返回 1-3 条路线供选择	int	选填	默认 0
cartype	车辆类型。0：普通汽车；1：纯电动汽车	int	选填	默认 0
plate_number	车牌号，如京 A00022。用于规避车牌号限行路段	string	选填	不填则不做规避
departure_time	设置出发时间（支持未来 7 天），UNIX 时间戳。该功能为高级付费服务	string	选填	默认为当前时间
ext_departure_time	更多出发时间，UNIX 时间戳。目前支持输入过去 7 天内一个或多个出发时间戳	string	选填	不填则不返回 ext_duration 字段
expect_arrival_time	预期的到达时间，UNIX 时间戳。该功能为高级付费服务	string	选填	不填则不返回 suggest_departure_time 字段
gps_direction	起点的车头方向。字段类型：int64 取值范围：0-359	int	选填
radius	起点的定位精度，字段类型：float，取值范围 [0,2000]	float	选填	配合 gps_direction 字段使用
speed	起点车辆的行驶速度，字段类型：float	float	选填	单位：米/秒
output	表示输出类型，可设置为 xml 或 json	string	选填	默认为 json
sn	用户的权限签名，当 AK 设置为 SN 校验时，该参数必填	string	选填
timestamp	时间戳，与 SN 配合使用	int64	SN 存在时必填
callback	回调函数	string	选填	仅在 output=json 时，该参数有效
intelligent_plan	传入多个途经点，综合考虑路况、交规限行、途经点的相对位置以及路线整体的绕路成本等，支持智能调整途经点顺序	int	选填	默认 0
walkinfo	起终点步导路线。1 表示下发起终点步导路线	int	选填	默认值为 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	返回的方案集
restriction_info
status	限行状态	int	取值范围【0,3】
desc	限行提示语	string
origin
lng	起点经度	double
lat	起点纬度	double
destination
lng	终点经度	double
lat	终点纬度	double
tag	方案标签	string
traffic_light	红绿灯数量	int
route_id	如无特殊需要，开发者无需关注	string
distance	方案距离，单位：米	int
duration	未来驾车路线耗时，单位：秒	int
ext_duration	驾车路线历史耗时（扩展），单位：秒	int
suggest_departure_time	建议出发时间，单位：秒	int64
taxi_fee	出租车费用，单位：元	int
toll	此路线道路收费，单位：元	int
toll_distance	收费路段里程，单位：米	int
steps	路线分段	array
leg_index	途径点序号	int
direction	进入道路的角度	int	枚举值 0-11
distance	step 的距离信息	int	单位米
road_name	分段的道路名称	string
road_type	分段的道路类型	int	枚举值 0-9
toll	分段道路收费，单位：元	int
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
traffic_condition	分段路况详情	array
status	路况指数	int	0: 无路况 1: 畅通 2: 缓行 3: 拥堵 4: 非常拥堵
geo_cnt	从当前坐标点开始，path 中路况相同的坐标点个数	int
distance	距离，从当前坐标点开始 path 中路况相同的距离，单位：米	float
end_walkinfo	终点步导路线	array
distance	终点步导路线距离	int	单位米
path	终点步导路线坐标点	string
start_walkinfo	起点步导路线	array
distance	起点步导路线距离	int	单位米
path	起点步导路线坐标点	string

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 位
     * @param destination 终点经纬度，小数点后不超过 6 位
     * @param coordType 坐标类型
     * @param retCoordtype 返回结果坐标类型
     * @param tactics 策略
     * @param alternatives 是否返回备选路线
     * @param cartype 车辆类型
     * @param speed 起点车辆的行驶速度
     * @param stepsInfo 是否下发 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,
                                          @QueryPar("alternatives") int alternatives,
                                          @QueryPar("cartype") int cartype,
                                          @QueryPar("speed") float speed,
                                          @QueryPar("steps_info") int stepsInfo);
}

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
        int tactics = 0;//默认距离最短
        int alternatives = 1;//1 表示返回 1-3 条备选路线
        int cartype = 0;//普通油车
        float speed = 27.78F;//100 千米/小时 ≈ 27.78 米/秒
        int stepsInfo = 1;//下发详情
        HttpResponse<String> result = drivingService.getSearch(BAIDU_CLIENT_AK, origin, destination, coordType, retCoordtype, tactics, alternatives, cartype, speed, stepsInfo);
        System.out.println(result.getBodyResult());
    }
}

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;
    @SerializedName("has_guidance")
    private boolean hasGuidance;
    private List<BdDrivingStepDTO> steps;//路线分段集合
    @SerializedName("restriction_info")
    private BdDrivingRestrictionInfoDTO restrictionInfo;
    @SerializedName("yellow_tip")
    private List<BdDrivingYelloTipDTO> yellowTipList;
    private int toll;//此路线道路收费，单位：元
    @SerializedName("toll_distance")
    private float tollDistance;
    private float score;
    @SerializedName("route_id")
    private String routeId;
}

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));
}

基于 Java 的百度地图驾车路线规划服务开发指南

一、驾车路线服务简介

1、百度路线规划服务

2、驾车路线服务

3、请求参数

4、响应参数

二、UniHttp 接口访问集成

1、访问接口创建

2、本地调用测试

3、响应对象初探

三、响应对象的 Java 封装

1、驾车路线服务响应类图

2、响应对象实现

a、公共属性类

b、驾车路线数据传输类

c、导航信息类

d、具体路线分段信息类

3、使用 GSON 转换实例

四、常见问题

1、坐标顺序问题

2、坐标格式问题

更多推荐文章

相关免费在线工具

基于 Java 的百度地图驾车路线规划服务开发指南

一、驾车路线服务简介

1、百度路线规划服务

2、驾车路线服务

3、请求参数

4、响应参数

二、UniHttp 接口访问集成

1、访问接口创建

2、本地调用测试

3、响应对象初探

三、响应对象的 Java 封装

1、驾车路线服务响应类图

2、响应对象实现

a、公共属性类

b、驾车路线数据传输类

c、导航信息类

d、具体路线分段信息类

3、使用 GSON 转换实例

四、常见问题

1、坐标顺序问题

2、坐标格式问题

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具