如何通过Here Maps SDK检测位置是否处于已定义路线的沿线范围内

HERE Maps SDK原生支持卡车位置与预定义路线的沿线区域匹配检测能力，可直接调用内置接口实现该需求，无需额外做坐标计算逻辑。

• 第一步：生成卡车专属基准路线
  调用SDK路线规划接口，选择运输模式为卡车，同时传入车辆的高度、重量、轴数、危险品类型等限制参数，规划出符合卡车通行规则的目标Route对象，作为后续位置校验的基准。
• 第二步：配置路线匹配器
  初始化SDK内置的RouteMatcher路线匹配组件，绑定上一步生成的Route对象，同时设置自定义的沿线区域检测阈值（单位：米），阈值可根据业务对偏离的容忍度灵活调整。
• 第三步：实时校验位置
  每次获取到新的定位坐标后，将位置数据传入RouteMatcher的匹配方法，拿到的匹配结果中会返回两个核心参数：isOnRoute（是否匹配到目标路线上）、distanceToRoute（当前位置到路线的最短垂直距离），只要两个参数同时满足isOnRoute = true且distanceToRoute ≤ 阈值，就说明卡车处于已定义路线的沿线区域范围内。

// 构建卡车路线规划参数
RouteOptions routeOpts = new RouteOptions();
routeOpts.setTransportMode(TransportMode.TRUCK);
routeOpts.setTruckHeight(4.2f);
routeOpts.setTruckGrossWeight(25000);
// 传入起终点、途经点后执行路线规划，获取Route对象
Route targetRoute = routePlanner.calculateRoute(routeOpts).getRoute();

// 初始化路线匹配器
RouteMatcher routeMatcher = RouteMatcher.getInstance(context);
routeMatcher.setTargetRoute(targetRoute);
// 设置沿线检测阈值为30米
routeMatcher.setMaxAllowedDeviation(30);

// 监听定位更新，实时校验
locationProvider.addLocationListener(location -> {
    routeMatcher.matchLocation(location, matchResult -> {
        boolean isOnRouteArea = matchResult.isMatchedToRoute() 
                                && matchResult.getDeviationDistance() <= 30;
        // 后续业务逻辑处理
    });
});

• 基准路线规划时必须完整传入卡车的所有限制参数，否则生成的路线不符合卡车通行规则，会导致后续校验逻辑无效
• 建议开启SDK的传感器辅助定位能力，降低隧道、密集楼宇等场景下的定位误差，提升校验准确率
• 阈值可根据场景调整：普通城市道路建议设为20-50米，高速、郊野道路建议设为50-100米

内容的提问来源于stack exchange，提问作者Piotr