expo-gaode-map-navigation 1.0.1-next.0

package/android/src/main/java/expo/modules/gaodemap/navigation/managers/IndependentRouteManager.kt

@@ -0,0 +1,83 @@
+package expo.modules.gaodemap.navigation.managers
+
+import android.content.Context
+import com.amap.api.navi.AMapNavi
+import com.amap.api.navi.model.AMapNaviPathGroup
+
+/**
+ * 独立路径组管理器
+ *
+ * - 负责存储/选择/启动/清理独立路径组，避免 ExpoGaodeMapNavigationModule 过于臃肿
+ * - 提供线程安全的 token 管理
+ */
+class IndependentRouteManager {
+  private val groups = mutableMapOf<Int, AMapNaviPathGroup>()
+  private var nextToken = 1
+
+  @Synchronized
+  fun store(group: AMapNaviPathGroup): Int {
+    val token = nextToken++
+    groups[token] = group
+    return token
+  }
+
+  @Synchronized
+  fun get(token: Int): AMapNaviPathGroup {
+    return groups[token] ?: throw Exception("invalid token")
+  }
+
+  /**
+   * 选主路线：
+   * - routeId: SDK 约定 12/13/14...
+   * - routeIndex: 0/1/2（内部转换为 12+index）
+   */
+  @Synchronized
+  fun select(token: Int, routeId: Int?, routeIndex: Int?): Boolean {
+    val group = get(token)
+    return when {
+      routeId != null -> group.selectRouteWithIndex(routeId)
+      routeIndex != null -> group.selectRouteWithIndex(12 + routeIndex)
+      else -> true // 未提供则保持当前主路线
+    }
+  }
+
+  /**
+   * 启动导航（可在启动前进行选路）
+   * - naviType: 0=GPS, 1=EMULATOR
+   */
+  @Synchronized
+  fun start(context: Context, token: Int, naviType: Int, routeId: Int?, routeIndex: Int?): Boolean {
+    try {
+      val group = get(token)
+      val navi = AMapNavi.getInstance(context)
+      
+      // 选择路线
+      if (routeId != null) {
+        group.selectRouteWithIndex(routeId)
+      } else if (routeIndex != null) {
+        group.selectRouteWithIndex(12 + routeIndex)
+      }
+      
+      // 启动导航
+      val result = navi.startNaviWithPath(naviType, group)
+      if (!result) {
+        android.util.Log.e("IndependentRouteManager", "startNaviWithPath failed: naviType=$naviType")
+      }
+      return result
+    } catch (e: Exception) {
+      android.util.Log.e("IndependentRouteManager", "Start navigation failed", e)
+      return false
+    }
+  }
+
+  @Synchronized
+  fun clear(token: Int): Boolean {
+    return groups.remove(token) != null
+  }
+
+  @Synchronized
+  fun clearAll() {
+    groups.clear()
+    nextToken = 1
+  }
+}

package/android/src/main/java/expo/modules/gaodemap/navigation/managers/RouteCalculator.kt

@@ -0,0 +1,173 @@
+package expo.modules.gaodemap.navigation.managers
+
+import android.content.Context
+import com.amap.api.navi.AMapNavi
+import com.amap.api.navi.model.AMapCarInfo
+
+import expo.modules.kotlin.Promise
+import expo.modules.gaodemap.navigation.ExpoGaodeMapNavigationModule
+import expo.modules.gaodemap.navigation.utils.Converters
+import expo.modules.gaodemap.navigation.listeners.RouteCalculateListener
+
+/**
+ * 路径规划管理器
+ * 
+ * 负责处理各种类型的路径规划：驾车、步行、骑行、公交、货车
+ */
+class RouteCalculator(
+  private val context: Context,
+  private val module: ExpoGaodeMapNavigationModule
+) {
+  
+  private var aMapNavi: AMapNavi? = null
+  private var routeListener: RouteCalculateListener? = null
+
+  init {
+    initNavi()
+  }
+
+  private fun initNavi() {
+    if (aMapNavi == null) {
+      aMapNavi = AMapNavi.getInstance(context)
+      routeListener = RouteCalculateListener(module)
+      aMapNavi?.addAMapNaviListener(routeListener)
+    }
+  }
+
+  /**
+   * 驾车路径规划
+   */
+  fun calculateDriveRoute(options: Map<String, Any?>, promise: Promise) {
+    @Suppress("UNCHECKED_CAST")
+    val from = options["from"] as? Map<String, Any?>
+    @Suppress("UNCHECKED_CAST")
+    val to = options["to"] as? Map<String, Any?>
+      ?: throw Exception("to is required")
+
+    val fromPoi = from?.let { Converters.parseNaviPoi(it) }
+    val toPoi = Converters.parseNaviPoi(to)
+    @Suppress("UNCHECKED_CAST")
+    val waypoints = Converters.parseWaypoints(options["waypoints"] as? List<Map<String, Any?>>)
+
+    // 支持两种策略传参：
+    // 1) 直接传 PathPlanningStrategy 的整型值：strategy
+    // 2) 传策略开关（建议）：avoidCongestion/avoidHighway/avoidCost/prioritiseHighway
+    val strategy: Int = if (options.containsKey("strategy")) {
+      (options["strategy"] as? Number)?.toInt() ?: 0
+    } else {
+      val avoidCongestion = options["avoidCongestion"] as? Boolean ?: false
+      val avoidHighway = options["avoidHighway"] as? Boolean ?: false
+      val avoidCost = options["avoidCost"] as? Boolean ?: false
+      val prioritiseHighway = options["prioritiseHighway"] as? Boolean ?: false
+      try {
+        // 6.3+ multipleRoute 参数已无效，但保留 true 以获取多路线策略
+        aMapNavi?.strategyConvert(avoidCongestion, avoidHighway, avoidCost, prioritiseHighway, true) ?: 0
+      } catch (e: Exception) {
+        0
+      }
+    }
+
+    // 若提供了车牌/限行信息，则在算路前设置车辆信息（小客车）
+    val carNumber = options["carNumber"] as? String
+    val restriction = options["restriction"] as? Boolean
+    if (carNumber != null || restriction != null) {
+      try {
+        val carInfo = AMapCarInfo().apply {
+          if (carNumber != null) setCarNumber(carNumber)
+          // 0=小客车；如为货车请使用 calculateTruckRoute 并设置 carType=1
+          setCarType("0")
+          if (restriction != null) setRestriction(restriction)
+        }
+        aMapNavi?.setCarInfo(carInfo)
+      } catch (_: Exception) {
+        // 忽略设置失败，不影响算路
+      }
+    }
+
+    routeListener?.currentPromise = promise
+    // 官方 API：POI 算路
+    aMapNavi?.calculateDriveRoute(fromPoi, toPoi, waypoints, strategy)
+  }
+
+  /**
+   * 步行路径规划（使用 NaviLatLng）
+   */
+  fun calculateWalkRoute(options: Map<String, Any?>, promise: Promise) {
+    @Suppress("UNCHECKED_CAST")
+    val from = options["from"] as? Map<String, Any?>
+      ?: throw Exception("from is required")
+    @Suppress("UNCHECKED_CAST")
+    val to = options["to"] as? Map<String, Any?>
+      ?: throw Exception("to is required")
+    
+    val fromLatLng = Converters.parseNaviLatLng(from)
+    val toLatLng = Converters.parseNaviLatLng(to)
+    
+    routeListener?.currentPromise = promise
+    aMapNavi?.calculateWalkRoute(fromLatLng, toLatLng)
+  }
+
+  /**
+   * 骑行路径规划（使用 NaviLatLng）
+   */
+  fun calculateRideRoute(options: Map<String, Any?>, promise: Promise) {
+    @Suppress("UNCHECKED_CAST")
+    val from = options["from"] as? Map<String, Any?>
+      ?: throw Exception("from is required")
+    @Suppress("UNCHECKED_CAST")
+    val to = options["to"] as? Map<String, Any?>
+      ?: throw Exception("to is required")
+    
+    val fromLatLng = Converters.parseNaviLatLng(from)
+    val toLatLng = Converters.parseNaviLatLng(to)
+    
+    routeListener?.currentPromise = promise
+    aMapNavi?.calculateRideRoute(fromLatLng, toLatLng)
+  }
+
+  /**
+   * 公交路径规划
+   * 注意：公交路径规划需要使用搜索服务，这里返回未实现错误
+   */
+  fun calculateBusRoute(options: Map<String, Any?>, promise: Promise) {
+    promise.reject("NOT_IMPLEMENTED", "Bus route calculation requires search service", null)
+  }
+
+  /**
+   * 货车路径规划
+   */
+  fun calculateTruckRoute(options: Map<String, Any?>, promise: Promise) {
+    // 货车路径规划：在算路前设置货车信息
+    try {
+      val carNumber = options["carNumber"] as? String
+      val restriction = options["restriction"] as? Boolean
+      val carInfo = AMapCarInfo().apply {
+        if (carNumber != null) setCarNumber(carNumber)
+        // 1=货车（CarType 为 1/3/5 均视为货车），这里取 1 作为通用值
+        setCarType("1")
+        if (restriction != null) setRestriction(restriction)
+        // 如需更精细的车型参数（轴数/长宽高/载重等），可在此扩展：
+        // setVehicleAxis("6"); setVehicleHeight("3.5"); setVehicleLength("7.3"); setVehicleWidth("2.5");
+        // setVehicleSize("4"); setVehicleLoad("25.99"); setVehicleWeight("20"); setVehicleLoadSwitch(true);
+      }
+      aMapNavi?.setCarInfo(carInfo)
+    } catch (_: Exception) {
+      // 忽略设置失败，不影响后续算路
+    }
+
+    // 复用驾车算路逻辑（含 strategyConvert）
+    calculateDriveRoute(options, promise)
+  }
+
+  fun destroy() {
+    aMapNavi?.removeAMapNaviListener(routeListener)
+    try {
+      // 官方建议：销毁单例释放资源
+      AMapNavi.destroy()
+    } catch (_: Exception) {
+    } finally {
+      aMapNavi = null
+      routeListener = null
+    }
+  }
+}

package/android/src/main/java/expo/modules/gaodemap/navigation/routes/drive/DriveTruckRouteCalculator.kt

@@ -0,0 +1,196 @@
+package expo.modules.gaodemap.navigation.routes.drive
+
+import android.content.Context
+import com.amap.api.navi.AMapNavi
+import com.amap.api.navi.model.AMapCarInfo
+import expo.modules.gaodemap.navigation.ExpoGaodeMapNavigationModule
+import expo.modules.gaodemap.navigation.listeners.RouteCalculateListener
+import expo.modules.gaodemap.navigation.utils.Converters
+import expo.modules.kotlin.Promise
+
+/**
+ * 驾车/货车 路线规划计算器
+ *
+ * 对齐官方文档：
+ * - 使用 AMapNavi.calculateDriveRoute(...)（POI/经纬度两种思路，这里采用 POI 形式，亦可传入仅经纬度）
+ * - 策略支持两种：
+ *   1) 直接传 PathPlanningStrategy 整型值：strategy
+ *   2) 通过 strategyConvert(avoidCongestion/avoidHighway/avoidCost/prioritiseHighway)
+ * - 货车：在算路前设置 AMapCarInfo.carType=1，且支持车牌/限行开关（可按需扩展 轴数/长宽高/载重等）
+ */
+class DriveTruckRouteCalculator(
+  private val context: Context,
+  private val module: ExpoGaodeMapNavigationModule
+) {
+  private var aMapNavi: AMapNavi? = null
+  private var routeListener: RouteCalculateListener? = null
+  private var isInitialized = false
+
+  init {
+    initNavi()
+  }
+
+  private fun initNavi() {
+    if (aMapNavi == null) {
+      try {
+        aMapNavi = AMapNavi.getInstance(context)
+        
+        // 检查SDK是否正确初始化（验证API Key）
+        if (aMapNavi == null) {
+          throw Exception("高德地图导航SDK初始化失败,请检查API Key配置是否正确。请在app.json中配置android.config.gaodeMapKey")
+        }
+        
+        routeListener = RouteCalculateListener(module)
+        aMapNavi?.addAMapNaviListener(routeListener)
+        
+        // 设置出行模式为驾车模式（默认）
+        aMapNavi?.setEmulatorNaviSpeed(80) // 设置模拟导航速度
+        
+        isInitialized = true
+        android.util.Log.d("DriveTruckRouteCalculator", "AMapNavi 初始化成功")
+      } catch (e: Exception) {
+        android.util.Log.e("DriveTruckRouteCalculator", "AMapNavi 初始化失败", e)
+        throw e
+      }
+    }
+  }
+
+  /**
+   * 驾车路径规划
+   */
+  fun calculateDriveRoute(options: Map<String, Any?>, promise: Promise) {
+    android.util.Log.d("DriveTruckRouteCalculator", "开始计算驾车路线，初始化状态: $isInitialized")
+    
+    // 确保初始化完成
+    if (!isInitialized) {
+      try {
+        initNavi()
+      } catch (e: Exception) {
+        promise.reject("INIT_FAILED", e.message ?: "高德地图导航SDK初始化失败", e)
+        return
+      }
+      // 再次检查，如果仍然未初始化，延迟重试
+      if (!isInitialized) {
+        android.util.Log.d("DriveTruckRouteCalculator", "初始化未完成，延迟500ms重试")
+        android.os.Handler(android.os.Looper.getMainLooper()).postDelayed({
+          calculateDriveRoute(options, promise)
+        }, 500)
+        return
+      }
+    }
+    
+    android.util.Log.d("DriveTruckRouteCalculator", "AMapNavi 实例: ${aMapNavi != null}")
+    
+    // 添加防重复调用检查
+    if (routeListener?.currentPromise != null) {
+      android.util.Log.w("DriveTruckRouteCalculator", "当前已有正在计算的请求，忽略新请求")
+      promise.reject("BUSY", "Another route calculation is in progress", null)
+      return
+    }
+
+    @Suppress("UNCHECKED_CAST")
+    val from = options["from"] as? Map<String, Any?>
+    @Suppress("UNCHECKED_CAST")
+    val to = options["to"] as? Map<String, Any?>
+      ?: throw Exception("to is required")
+
+    val fromPoi = from?.let { Converters.parseNaviPoi(it) }
+    val toPoi = Converters.parseNaviPoi(to)
+    @Suppress("UNCHECKED_CAST")
+    val waypoints = Converters.parseWaypoints(options["waypoints"] as? List<Map<String, Any?>>)
+
+    // 1) 直接传策略值，或 2) 通过 strategyConvert 计算
+    val strategy: Int = if (options.containsKey("strategy")) {
+      (options["strategy"] as? Number)?.toInt() ?: 0
+    } else {
+      val avoidCongestion = options["avoidCongestion"] as? Boolean ?: false
+      val avoidHighway = options["avoidHighway"] as? Boolean ?: false
+      val avoidCost = options["avoidCost"] as? Boolean ?: false
+      val prioritiseHighway = options["prioritiseHighway"] as? Boolean ?: false
+      try {
+        aMapNavi?.strategyConvert(avoidCongestion, avoidHighway, avoidCost, prioritiseHighway, true) ?: 0
+      } catch (_: Exception) {
+        0
+      }
+    }
+
+    // 小客车可选设置：车牌/限行
+    val carNumber = options["carNumber"] as? String
+    val restriction = options["restriction"] as? Boolean
+    if (carNumber != null || restriction != null) {
+      try {
+        val carInfo = AMapCarInfo().apply {
+          if (carNumber != null) setCarNumber(carNumber)
+            carType = "0" // 0=小客车
+          if (restriction != null) isRestriction = restriction
+        }
+        aMapNavi?.setCarInfo(carInfo)
+      } catch (_: Exception) {
+        // ignore
+      }
+    }
+
+    // 标注场景与多路线期望（默认 drive；若上层已指定 scene 则尊重）
+    if (routeListener?.scene == null) {
+      routeListener?.scene = "drive"
+    }
+    routeListener?.multiple = true
+    routeListener?.currentPromise = promise
+    
+    android.util.Log.d("DriveTruckRouteCalculator", "调用 calculateDriveRoute")
+    android.util.Log.d("DriveTruckRouteCalculator", "起点: $fromPoi")
+    android.util.Log.d("DriveTruckRouteCalculator", "终点: $toPoi")
+    android.util.Log.d("DriveTruckRouteCalculator", "策略: $strategy")
+    
+    val result = aMapNavi?.calculateDriveRoute(fromPoi, toPoi, waypoints, strategy)
+    android.util.Log.d("DriveTruckRouteCalculator", "calculateDriveRoute 返回: $result")
+  }
+
+  /**
+   * 货车路径规划
+   * 注意：该能力为收费接口；需要商务开通。未开通可能算路失败。
+   */
+  fun calculateTruckRoute(options: Map<String, Any?>, promise: Promise) {
+    // 先设置货车信息，再复用驾车算路流程
+    try {
+      val carNumber = options["carNumber"] as? String
+      val restriction = options["restriction"] as? Boolean
+
+      val carInfo = AMapCarInfo().apply {
+        if (carNumber != null) setCarNumber(carNumber)
+          carType = "1" // 1/3/5 视为货车，这里取 1
+        if (restriction != null) isRestriction = restriction
+
+        // 可按需扩展更详细的货车参数（示例）：
+        // setVehicleAxis("6")
+        // setVehicleHeight("3.5")
+        // setVehicleLength("7.3")
+        // setVehicleWidth("2.5")
+        // setVehicleSize("4")
+        // setVehicleLoad("25.99")
+        // setVehicleWeight("20")
+        // setVehicleLoadSwitch(true)
+      }
+      aMapNavi?.setCarInfo(carInfo)
+    } catch (_: Exception) {
+      // ignore
+    }
+
+    // 标注场景（truck），并期望多路线
+    routeListener?.scene = "truck"
+    routeListener?.multiple = true
+
+    calculateDriveRoute(options, promise)
+  }
+
+  fun destroy() {
+    aMapNavi?.removeAMapNaviListener(routeListener)
+    try {
+      AMapNavi.destroy()
+    } catch (_: Exception) {
+    } finally {
+      aMapNavi = null
+      routeListener = null
+    }
+  }
+}

package/android/src/main/java/expo/modules/gaodemap/navigation/routes/ebike/EbikeRouteCalculator.kt

@@ -0,0 +1,108 @@
+package expo.modules.gaodemap.navigation.routes.ebike
+
+import android.content.Context
+import com.amap.api.navi.AMapNavi
+import com.amap.api.navi.enums.TravelStrategy
+import expo.modules.gaodemap.navigation.ExpoGaodeMapNavigationModule
+import expo.modules.gaodemap.navigation.listeners.RouteCalculateListener
+import expo.modules.gaodemap.navigation.utils.Converters
+import expo.modules.kotlin.Promise
+
+/**
+ * 骑行电动车 路线规划计算器
+ *
+ * 对齐官方文档（v8.0.0+）：
+ * - AMapNavi.calculateEleBikeRoute(to: NaviLatLng)
+ * - AMapNavi.calculateEleBikeRoute(from: NaviLatLng, to: NaviLatLng)
+ * - AMapNavi.calculateEleBikeRoute(fromPoi: NaviPoi, toPoi: NaviPoi, strategy: TravelStrategy)
+ *
+ * 说明：
+ * - 推荐使用 POI + strategy（SINGLE/MULTIPLE），SDK 可基于 poiId 提高路线合理性
+ * - 起点允许为空（内部将取定位点）
+ */
+class EbikeRouteCalculator(
+  private val context: Context,
+  private val module: ExpoGaodeMapNavigationModule
+) {
+  private var aMapNavi: AMapNavi? = null
+  private var routeListener: RouteCalculateListener? = null
+
+  init {
+    initNavi()
+  }
+
+  private fun initNavi() {
+    if (aMapNavi == null) {
+      aMapNavi = AMapNavi.getInstance(context)
+      // 适配出行视图
+        aMapNavi?.isNaviTravelView = true
+      routeListener = RouteCalculateListener(module)
+      aMapNavi?.addAMapNaviListener(routeListener)
+    }
+  }
+
+  /**
+   * 骑行电动车路径规划
+   * options:
+   * - from: { latitude, longitude } | POI
+   * - to:   { latitude, longitude } | POI  (required)
+   * - travelStrategy?: 1000(SINGLE) | 1001(MULTIPLE)
+   * - multiple?: boolean (true => MULTIPLE)
+   * - usePoi?: boolean 强制按 POI 处理
+   */
+  fun calculateEleBikeRoute(options: Map<String, Any?>, promise: Promise) {
+    @Suppress("UNCHECKED_CAST")
+    val to = options["to"] as? Map<String, Any?>
+      ?: throw Exception("to is required")
+    @Suppress("UNCHECKED_CAST")
+    val from = options["from"] as? Map<String, Any?>
+
+    // 计算策略（仅在 POI 模式下使用）
+    val travelStrategyValue: Int = when {
+      options["travelStrategy"] is Number -> (options["travelStrategy"] as Number).toInt()
+      options["multiple"] as? Boolean == true -> 1001
+      else -> 1000
+    }
+    val strategyEnum =
+      if (travelStrategyValue == 1001) TravelStrategy.MULTIPLE else TravelStrategy.SINGLE
+
+    // 是否使用 POI 算路：显式指定或存在 name / poiId 字段
+    val usePoi =
+      (from?.get("name") is String) || (from?.get("poiId") is String) ||
+      (to["name"] is String) || (to["poiId"] is String) ||
+      (options["usePoi"] as? Boolean == true)
+
+    // 标注场景与多路线期望（电动车）
+    routeListener?.scene = "ebike"
+    routeListener?.multiple = (strategyEnum == TravelStrategy.MULTIPLE)
+    routeListener?.currentPromise = promise
+
+    if (usePoi) {
+      // POI 算路（支持起点为空）
+      val startPoi = from?.let { Converters.parseNaviPoi(it) }
+      val endPoi = Converters.parseNaviPoi(to)
+      aMapNavi?.calculateEleBikeRoute(startPoi, endPoi, strategyEnum)
+      return
+    }
+
+    // 经纬度算路分三种：仅终点（无起点）、起终点
+    val toLatLng = Converters.parseNaviLatLng(to)
+    if (from == null) {
+      aMapNavi?.calculateEleBikeRoute(toLatLng)
+    } else {
+      val fromLatLng = Converters.parseNaviLatLng(from)
+      aMapNavi?.calculateEleBikeRoute(fromLatLng, toLatLng)
+    }
+  }
+
+  fun destroy() {
+    aMapNavi?.removeAMapNaviListener(routeListener)
+    try {
+      AMapNavi.destroy()
+    } catch (_: Exception) {
+    } finally {
+      aMapNavi = null
+      routeListener = null
+    }
+  }
+}