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

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

https://api.map.baidu.com/direction/v2/driving?origin=40.01116,116.339303&destination=39.936404,116.452562&ak=您的 AK

字段名称	含义	字段类型	必填	备注
ak	用户的访问权限	string	必填
origin	起点经纬度，小数点后不超过 6 位	string	必填	起点经纬度，格式为：纬度，经度；小数点后不超过 6 位
destination	终点经纬度，小数点后不超过 6 位	string	必填	终点经纬度，格式为：纬度，经度；小数点后不超过 6 位
origin_uid	POI 的 uid	string	选填
destination_uid	POI 的 uid	string	选填
waypoints	途径点坐标串，支持 18 个以内的有序途径点	string	选填
coord_type	坐标类型，可选参数，默认为 bd09ll	string	选填	默认 bd09ll
ret_coordtype	返回结果坐标类型，默认为 bd09ll	string	选填	默认 bd09ll
tactics	策略选择	int	选填	默认 0:默认策略
alternatives	是否返回备选路线	int	选填	默认 0
cartype	车辆类型	int	选填	默认 0
plate_number	车牌号	string	选填	不填则不做规避
departure_time	设置出发时间	string	选填	默认为当前时间
ext_departure_time	更多出发时间	string	选填	不填则不返回 ext_duration 字段
expect_arrival_time	预期的到达时间	string	选填	不填则不返回 suggest_departure_time 字段
gps_direction	起点的车头方向	int	选填
radius	起点的定位精度	float	选填	配合 gps_direction 字段使用
speed	起点车辆的行驶速度	float	选填	单位：米/秒
output	表示输出类型	string	选填	默认为 json
sn	用户的权限签名	string	选填
timestamp	时间戳	int64	SN 存在时必填
callback	回调函数	string	选填	仅在 output=json 时有效
intelligent_plan	途经点智能规划	int	选填	默认 0
walkinfo	起终点步导路线	int	选填	默认值为 0
steps_info	是否下发 step 详情	int	选填
origin_bind_strategy	起点绑路策略	int	选填	默认值 0
dest_bind_strategy	终点绑路策略	int	选填	默认值 0
origin_road_type	起点道路类型	int	选填	默认值 0

字段名称	字段含义	字段类型	备注
status	状态码	int	0：成功
message	状态码对应的信息	string
type	默认返回 2	int
result	返回的结果
restriction	限行结果提示信息	string	若无法规避限行，则返回限行提示信息
total	返回方案的总数	int
routes	返回的方案集
restriction_info	限行状态
origin	起点位置
destination	终点位置
tag	方案标签	string
traffic_light	红绿灯数量	int
route_id	路线 ID	string
distance	方案距离，单位：米	int
duration	未来驾车路线耗时，单位：秒	int
ext_duration	驾车路线历史耗时	int
suggest_departure_time	建议出发时间	int64
taxi_fee	出租车费用，单位：元	int
toll	此路线道路收费，单位：元	int
toll_distance	收费路段里程，单位：米	int
steps	路线分段	array
end_walkinfo	终点步导路线	array
start_walkinfo	起点步导路线	array

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.thridinterface.apiprocessor.BaiduHttpApi;

@BaiduHttpApi(snMode = false)
public interface BaiduDrivingV2Service {
    @GetHttpInterface(path = "/direction/v2/driving")
    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.thridinterface.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"; // 返回坐标类型
        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;

@NoArgsConstructor
@AllArgsConstructor
@Setter
@Getter
@ToString
public class BdCommonDTO implements Serializable {
    private static final long serialVersionUID = 4985268844473756688L;
    private int status; // 状态码
    private String message; // 响应信息
}

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)
@EqualsAndHashCode(callSuper=true)
public class BdDrivingDTO extends BdCommonDTO implements Serializable{
    private static final long serialVersionUID = 5055488530865458258L;
    private Integer type;
    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、坐标格式问题

五、总计

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

更多推荐文章

相关免费在线工具