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

二、UniHttp 接口访问集成

为了简化 HTTP 调用，我们使用 UniHttp 框架进行封装。这能减少样板代码，让业务逻辑更清晰。

1、定义接口

在 Java 中定义接口来映射 API 端点，利用注解处理参数绑定。

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;

@BaiduHttpApi(snMode = false)
public interface BaiduDrivingV2Service {
    @GetHttpInterface(path = "/direction/v2/driving")
    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
    );
}

除必填参数外，选填参数可留空使用默认值，保持接口简洁。

2、本地调用测试

使用 JUnit 进行测试，模拟从广州到铜仁的驾车请求，并开启备选路线和详情下发。

package com.yelang.project.unihttp;
import org.junit.Test;
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.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; // 返回备选路线
        int cartype = 0;
        float speed = 27.78F; // 约 100km/h
        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());
    }
}

运行后查看控制台输出，即可看到原始 JSON 响应。

3、响应对象初探

将返回的 JSON 格式化后观察结构，这是后续封装 JavaBean 的基础。重点关注 result.routes 层级，它包含了距离、耗时、红绿灯数量及详细的 steps 路径点。

三、响应对象的 Java 封装

实际业务中，我们需要将 JSON 反序列化为 Java 对象以便持久化或分析。这里设计一组 DTO 类来还原数据结构。

1、公共属性类

所有百度接口响应通常包含通用的状态码和信息，提取为父类。

package com.yelang.project.meteorology.domain;
import lombok.*;

@NoArgsConstructor @AllArgsConstructor
@Setter @Getter @ToString
public class BdCommonDTO implements Serializable {
    private static final long serialVersionUID = 4985268844473756688L;
    private int status;      // 0 成功，其他为错误码
    private String message;  // 状态描述
}

2、驾车路线数据传输类

主入口类，继承公共属性，包含结果集。

package com.yelang.project.meteorology.domain.baidudto;
import com.yelang.project.meteorology.domain.BdCommonDTO;
import lombok.*;

@NoArgsConstructor @AllArgsConstructor
@Setter @Getter @ToString(callSuper=true)
@EqualsAndHashCode(callSuper=true)
public class BdDrivingDTO extends BdCommonDTO implements Serializable{
    private Integer type;
    private BdDrivingResultDTO result;
}

3、导航信息与路线详情

导航信息类包含限行提示、方案总数及路线列表。路线详情类则封装了具体的距离、耗时、费用及分段步骤。

// BdDrivingResultDTO 包含 routes 列表
private List<BdDrivingRouteDTO> routes;

// BdDrivingRouteDTO 包含 steps 列表
private List<BdDrivingStepDTO> steps;

具体实现时需注意字段名与 JSON 的映射关系，使用 @SerializedName 处理驼峰与下划线差异。

4、GSON 转换实例

使用 Gson 库将字符串转换为对象。

Gson gson = new Gson();
if (StringUtils.isNotEmpty(result.getBodyResult())) {
    BdDrivingDTO drivingDTO = gson.fromJson(result.getBodyResult(), BdDrivingDTO.class);
    System.out.println(drivingDTO);
    System.out.println(gson.toJson(drivingDTO));
}

转换成功后，即可在业务层直接操作对象属性。

四、常见问题

集成过程中常遇到坐标顺序和格式问题，需特别注意。

1、坐标顺序问题

开发者习惯用（经度，纬度），但百度 API 要求（纬度，经度）。若顺序颠倒，会返回无结果或错误。

解决： 确保输入参数格式严格遵循 lat,lng。

2、坐标格式问题

虽然查询参数支持 WGS84，但返回结果中通常不支持直接返回 WGS84 坐标，强制设置可能导致报错。

解决： 入参可用 WGS84，但建议将 ret_coordtype 设置为 bd09ll 或 gcj02 以确保兼容性。

五、总结

本文详细介绍了如何在 Java 项目中集成百度地图驾车路线规划服务。从 API 参数配置、HTTP 请求封装，到 JSON 响应对象的 JavaBean 映射，再到常见坐标问题的排查，提供了完整的实战参考。通过自定义封装的结果对象，可以为后续的数据持久化和数据挖掘分析提供坚实的数据基础。