Android平台Mapbox Navigation SDK接入自定义路由服务器方法咨询

要在Android的Mapbox Navigation SDK中替换官方路由服务，核心是把自研OSRM/Valhalla服务器的响应转换成SDK能识别的Route对象，再注入导航流程。以下是具体步骤：

1. 解析自定义路由响应为Mapbox Route格式 #

Mapbox导航的核心依赖是com.mapbox.api.directions.v5.models.Route类，你需要把OSRM或Valhalla的JSON响应映射到该类的结构上：

• 坐标与路径：提取路由的经纬度点序列，转换成List<Position>，对应RouteGeometry。
• 路段与步骤：将OSRM的legs/steps或Valhalla的legs/maneuvers映射为Mapbox的Leg和LegStep对象，每个步骤需要包含：
  • 转向指令类型（如左转、直行）：对应Maneuver.Type，比如OSRM的turn.left映射为MANEUVER_TYPE_TURN_LEFT
  • 步骤的起止坐标、距离、预计时间
• 元数据：填充RouteOptions（起点、终点、偏好设置等），确保和你请求自研服务器时的参数一致。

示例代码（解析OSRM响应简化版）：

// 假设已从自研服务器获取到OSRM的JSON响应字符串
val osrmResponse = getCustomRouteResponse()
val osrmRoute = Gson().fromJson(osrmResponse, OsrmRoute::class.java)

// 构建Mapbox Route的Legs
val mapboxLegs = mutableListOf<Leg>()
osrmRoute.routes.first().legs.forEach { osrmLeg ->
    val steps = osrmLeg.steps.map { osrmStep ->
        val maneuverType = when(osrmStep.maneuver.type) {
            "turn" -> when(osrmStep.maneuver.modifier) {
                "left" -> Maneuver.Type.MANEUVER_TYPE_TURN_LEFT
                "right" -> Maneuver.Type.MANEUVER_TYPE_TURN_RIGHT
                else -> Maneuver.Type.MANEUVER_TYPE_CONTINUE
            }
            "straight" -> Maneuver.Type.MANEUVER_TYPE_CONTINUE
            // 其他类型按需映射
            else -> Maneuver.Type.MANEUVER_TYPE_UNKNOWN
        }
        LegStep.builder()
            .distance(Distance.fromMeters(osrmStep.distance.toDouble()))
            .duration(Duration.fromSeconds(osrmStep.duration.toDouble()))
            .maneuver(Maneuver.builder().type(maneuverType).location(Position.fromLngLat(osrmStep.maneuver.location[0], osrmStep.maneuver.location[1])).build())
            .geometry(PolylineUtils.encode(osrmStep.geometry.coordinates, 6))
            .build()
    }
    val mapboxLeg = Leg.builder()
        .steps(steps)
        .distance(Distance.fromMeters(osrmLeg.distance.toDouble()))
        .duration(Duration.fromSeconds(osrmLeg.duration.toDouble()))
        .build()
    mapboxLegs.add(mapboxLeg)
}

// 构建最终的Mapbox Route
val mapboxRoute = Route.builder()
    .legs(mapboxLegs)
    .geometry(PolylineUtils.encode(osrmRoute.routes.first().geometry.coordinates, 6))
    .distance(Distance.fromMeters(osrmRoute.routes.first().distance.toDouble()))
    .duration(Duration.fromSeconds(osrmRoute.routes.first().duration.toDouble()))
    .routeOptions(RouteOptions.builder().build()) // 填充实际的起点终点等参数
    .build()

2. 注入Route启动导航 #

跳过Mapbox官方的RouteApi请求流程，直接用自定义构建的Route启动导航：

// 构建导航启动选项
val options = NavigationLauncherOptions.builder()
    .route(mapboxRoute)
    .shouldSimulateRoute(false) // 根据需求设置模拟导航
    .build()

// 启动导航
NavigationLauncher.startNavigation(this, options)

3. 处理实时重路由（可选） #

如果需要支持导航过程中的重路由，需替换Mapbox默认的重路由逻辑：

• 监听导航中的位置变化和偏离事件
• 当需要重路由时，向自研服务器发起新的路由请求
• 解析新的Route对象后，通过NavigationViewModel更新导航会话：

navigationViewModel.updateRoute(newMapboxRoute)

关键注意事项 #

• 确保自定义路由的坐标采用WGS84坐标系（和Mapbox一致），避免位置偏移
• 转向指令的类型映射要完整，否则逐向导航的语音提示和UI会异常
• 距离、时间等参数需与实际路由匹配，保证导航进度计算准确

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