使用Java开发腾讯地图驾车路线计算服务的经验分享

Takumilovexu

已于 2024-08-20 11:32:19 修改

阅读量391

点赞数 8

文章标签： java 开发语言

于 2024-08-15 13:43:37 首次发布

本文链接：https://blog.csdn.net/Takumilove/article/details/141220134

版权

文章目录

最近我在一个项目中使用Java集成了腾讯地图的驾车路线计算服务。这个功能的核心需求是，根据用户输入的起点和终点坐标，计算出驾车路线，并返回预估的时间和距离。虽然听起来并不复杂，但在实现的过程中，还是遇到了一些挑战和思考，在这里和大家分享一下。

项目背景

项目的需求非常明确：用户需要查询从A点到B点的驾车路线，同时需要知道路程的大概时间和距离。为此，我们决定使用腾讯地图提供的驾车路线规划API。

代码实现

在这个项目中，我主要使用了RestTemplate来处理HTTP请求，这是Spring框架中非常方便的一个工具类。以下是实现的核心代码片段：

@Slf4j
@Service
@SuppressWarnings({"unchecked", "rawtypes"})
@RequiredArgsConstructor
public class MapServiceImpl implements MapService {

    private final RestTemplate restTemplate;
    @Value("${tencent.map.key}")
    private String key;

    @Override
    public DrivingLineVo calculateDrivingLine(CalculateDrivingLineForm calculateDrivingLineForm) {
        // 请求腾讯提供接口，按照接口要求传递相关参数，获取返回结果
        String url = "https://apis.map.qq.com/ws/direction/v1/driving/?from={from}&to={to}&key={key}";

        // 封装参数
        Map<String, String> map = new HashMap<>();
        map.put("from",
                calculateDrivingLineForm.getStartPointLatitude() + "," + calculateDrivingLineForm.getStartPointLatitude());
        map.put("to",
                calculateDrivingLineForm.getEndPointLatitude() + "," + calculateDrivingLineForm.getEndPointLongitude());
        map.put("key", key);

        // 调用接口
        JSONObject result = restTemplate.getForObject(url, JSONObject.class, map);
        // 处理返回结果
        int status = result.getIntValue("status");
        if (status != 0) {
            throw new GuiguException(ResultCodeEnum.MAP_FAIL);
        }

        // 获取返回路线信息
        JSONObject route = result.getJSONObject("result").getJSONArray("routes").getJSONObject(0);
        // 创建VO对象
        DrivingLineVo drivingLineVo = new DrivingLineVo();
        drivingLineVo.setDuration(route.getBigDecimal("duration"));
        drivingLineVo.setDistance(
                route.getBigDecimal("distance").divide(new BigDecimal(1000)).setScale(2, RoundingMode.HALF_UP));
        drivingLineVo.setPolyline(route.getJSONArray("polyline"));

        return drivingLineVo;
    }
}

代码解读

参数封装与接口调用：
- 使用RestTemplate进行HTTP请求调用，通过传递必要的参数如起点、终点和API密钥来获取驾车路线数据。这里，我们构建了一个Map来存放这些参数，并通过getForObject方法发起GET请求。
异常处理：
- 调用接口后，我们首先检查了返回的状态码，如果状态码不为0，表示调用失败，这时候我们抛出了自定义异常GuiguException，并传递相应的错误信息。
数据处理：
- 对返回的路线数据进行处理，提取出预估的时间和距离，并将距离单位转换为公里（默认返回的是米）。最后，我们将这些数据封装到DrivingLineVo对象中，并返回给调用者。

遇到的挑战

在开发过程中，有几个小问题值得注意：

API请求频率限制：
- 腾讯地图API有请求频率限制，所以在实际项目中，我们需要考虑请求的合理性，避免超出限制导致服务不可用。
返回数据的结构复杂性：
- 腾讯地图API返回的数据结构相对复杂，尤其是在路线规划中涉及到多条路线的情况下，我们需要确保提取的是我们需要的那一条路线。
数据的精度处理：
- 路线距离的精度处理非常重要，我们使用了BigDecimal来确保计算精确度，并通过setScale方法来调整小数点位数，避免出现不必要的计算误差。