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

package/ios/map/modules/LocationManager.swift

@@ -0,0 +1,265 @@
+import Foundation
+import AMapLocationKit
+import CoreLocation
+
+/**
+ * 定位管理器
+ * 
+ * 负责:
+ * - 连续定位和单次定位
+ * - 定位配置管理
+ * - 方向传感器管理
+ * - 定位结果回调
+ */
+class LocationManager: NSObject, AMapLocationManagerDelegate {
+    /// 高德定位管理器实例
+    var locationManager: AMapLocationManager?
+    /// 定位是否已启动
+    private var isLocationStarted = false
+    /// 定位更新回调
+    var onLocationUpdate: (([String: Any]) -> Void)?
+    /// 方向更新回调
+    var onHeadingUpdate: (([String: Any]) -> Void)?
+    
+    override init() {
+        super.init()
+        initLocationManager()
+    }
+    
+    // MARK: - 定位控制
+    
+    /**
+     * 开始连续定位
+     */
+    func start() {
+        locationManager?.startUpdatingLocation()
+        isLocationStarted = true
+    }
+    
+    /**
+     * 停止定位
+     */
+    func stop() {
+        locationManager?.stopUpdatingLocation()
+        isLocationStarted = false
+    }
+    
+    /**
+     * 检查定位是否已启动
+     * @return 是否正在定位
+     */
+    func isStarted() -> Bool {
+        return isLocationStarted
+    }
+    
+    // MARK: - 定位配置
+    
+    /**
+     * 设置是否返回逆地理信息
+     * @param isReGeocode 是否返回逆地理信息
+     */
+    func setLocatingWithReGeocode(_ isReGeocode: Bool) {
+        locationManager?.locatingWithReGeocode = isReGeocode
+    }
+    
+    /**
+     * 设置定位距离过滤器(米)
+     * @param distance 最小距离变化才触发定位更新
+     */
+    func setDistanceFilter(_ distance: Double) {
+        locationManager?.distanceFilter = distance
+    }
+    
+    /**
+     * 设置定位超时时间(秒)
+     * @param timeout 超时时间
+     */
+    func setLocationTimeout(_ timeout: Int) {
+        locationManager?.locationTimeout = timeout
+    }
+    
+    /**
+     * 设置逆地理超时时间(秒)
+     * @param timeout 超时时间
+     */
+    func setReGeocodeTimeout(_ timeout: Int) {
+        locationManager?.reGeocodeTimeout = timeout
+    }
+    
+    /**
+     * 设置定位精度
+     * @param accuracy 精度级别
+     *   - 0: 最适合导航
+     *   - 1: 最佳精度
+     *   - 2: 10米精度
+     *   - 3: 100米精度
+     *   - 4: 1公里精度
+     *   - 5: 3公里精度
+     */
+    func setDesiredAccuracy(_ accuracy: Int) {
+        let accuracyValue: CLLocationAccuracy
+        switch accuracy {
+        case 0: accuracyValue = kCLLocationAccuracyBestForNavigation
+        case 1: accuracyValue = kCLLocationAccuracyBest
+        case 2: accuracyValue = kCLLocationAccuracyNearestTenMeters
+        case 3: accuracyValue = kCLLocationAccuracyHundredMeters
+        case 4: accuracyValue = kCLLocationAccuracyKilometer
+        case 5: accuracyValue = kCLLocationAccuracyThreeKilometers
+        default: accuracyValue = kCLLocationAccuracyBest
+        }
+        locationManager?.desiredAccuracy = accuracyValue
+    }
+    
+    /**
+     * 设置是否自动暂停定位更新
+     * @param pauses 是否自动暂停
+     */
+    func setPausesLocationUpdatesAutomatically(_ pauses: Bool) {
+        locationManager?.pausesLocationUpdatesAutomatically = pauses
+    }
+    
+    /**
+     * 设置是否允许后台定位
+     * @param allows 是否允许后台定位
+     */
+    func setAllowsBackgroundLocationUpdates(_ allows: Bool) {
+        locationManager?.allowsBackgroundLocationUpdates = allows
+    }
+    
+    /**
+     * 设置逆地理语言
+     * @param language 语言类型
+     *   - 0: 默认
+     *   - 1: 中文
+     *   - 2: 英文
+     */
+    func setGeoLanguage(_ language: Int) {
+        switch language {
+        case 0: locationManager?.reGeocodeLanguage = .default
+        case 1: locationManager?.reGeocodeLanguage = .chinse
+        case 2: locationManager?.reGeocodeLanguage = .english
+        default: break
+        }
+    }
+    
+    // MARK: - 方向传感器
+    
+    /**
+     * 开始更新设备方向
+     */
+    func startUpdatingHeading() {
+        locationManager?.startUpdatingHeading()
+    }
+    
+    /**
+     * 停止更新设备方向
+     */
+    func stopUpdatingHeading() {
+        locationManager?.stopUpdatingHeading()
+    }
+    
+    // MARK: - 生命周期
+    
+    /**
+     * 销毁定位管理器
+     */
+    func destroy() {
+        locationManager?.stopUpdatingLocation()
+        locationManager?.stopUpdatingHeading()
+        locationManager?.delegate = nil
+        locationManager = nil
+        onLocationUpdate = nil
+        onHeadingUpdate = nil
+    }
+    
+    /**
+     * 初始化定位管理器
+     */
+    private func initLocationManager() {
+        locationManager = AMapLocationManager()
+        locationManager?.delegate = self
+        // 推荐配置：百米精度，快速定位
+        locationManager?.desiredAccuracy = kCLLocationAccuracyHundredMeters
+        locationManager?.distanceFilter = 10
+        // 增加超时时间，避免首次授权时超时(首次定位建议10秒以上)
+        locationManager?.locationTimeout = 10  // 10秒超时
+        locationManager?.reGeocodeTimeout = 5   // 5秒超时
+        locationManager?.locatingWithReGeocode = true
+        
+        // iOS 9 之前:防止后台被系统挂起(默认关闭,用户可通过 setPausesLocationUpdatesAutomatically 配置)
+        locationManager?.pausesLocationUpdatesAutomatically = false
+    }
+    
+    // MARK: - AMapLocationManagerDelegate
+    
+    /**
+     * 定位更新回调
+     * @param manager 定位管理器
+     * @param location 位置信息
+     * @param reGeocode 逆地理信息
+     */
+    func amapLocationManager(_ manager: AMapLocationManager!, didUpdate location: CLLocation!, reGeocode: AMapLocationReGeocode!) {
+        // 🔑 坐标验证：防止无效坐标
+        guard location.coordinate.latitude >= -90 && location.coordinate.latitude <= 90,
+              location.coordinate.longitude >= -180 && location.coordinate.longitude <= 180 else {
+            return
+        }
+        
+        var locationData: [String: Any] = [
+            "latitude": location.coordinate.latitude,
+            "longitude": location.coordinate.longitude,
+            "accuracy": location.horizontalAccuracy,
+            "altitude": location.altitude,
+            "bearing": location.course,
+            "speed": location.speed,
+            "timestamp": location.timestamp.timeIntervalSince1970 * 1000
+        ]
+        
+        // 添加逆地理信息
+        if let reGeocode = reGeocode {
+            locationData["address"] = reGeocode.formattedAddress
+            locationData["province"] = reGeocode.province
+            locationData["city"] = reGeocode.city
+            locationData["district"] = reGeocode.district
+            locationData["street"] = reGeocode.street
+            locationData["streetNumber"] = reGeocode.number
+            locationData["country"] = reGeocode.country
+            locationData["cityCode"] = reGeocode.citycode
+            locationData["adCode"] = reGeocode.adcode
+        }
+        
+        onLocationUpdate?(locationData)
+    }
+    
+    /**
+     * 方向更新回调
+     * @param manager 定位管理器
+     * @param heading 方向信息
+     */
+    func amapLocationManager(_ manager: AMapLocationManager!, didUpdate heading: CLHeading!) {
+        let headingData: [String: Any] = [
+            "heading": heading.trueHeading,
+            "accuracy": heading.headingAccuracy,
+            "timestamp": heading.timestamp.timeIntervalSince1970 * 1000
+        ]
+        onHeadingUpdate?(headingData)
+    }
+    
+    /**
+     * 需要定位权限回调
+     * @param manager 定位管理器
+     * @param locationManager 系统定位管理器
+     */
+    func amapLocationManager(_ manager: AMapLocationManager!, doRequireLocationAuth locationManager: CLLocationManager!) {
+        locationManager.requestAlwaysAuthorization()
+    }
+    
+    /**
+     * 定位失败回调
+     * @param manager 定位管理器
+     * @param error 错误信息
+     */
+    func amapLocationManager(_ manager: AMapLocationManager!, didFailWithError error: Error!) {
+        // 定位失败 - 静默处理
+    }
+}

package/ios/map/overlays/CircleView.swift

@@ -0,0 +1,234 @@
+import ExpoModulesCore
+import AMapNaviKit
+
+/**
+ * 圆形覆盖物视图
+ * 
+ * 负责:
+ * - 在地图上绘制圆形
+ * - 管理圆形的样式(填充色、边框色、边框宽度)
+ * - 响应属性变化并更新渲染
+ */
+class NaviCircleView: ExpoView {
+    /// 事件派发器 - 使用 onCirclePress 避免与 MarkerPress 冲突
+    let onCirclePress = EventDispatcher()
+    
+    /// 圆心坐标
+    var circleCenter: [String: Double] = [:]
+    /// 半径(米)
+    var radius: Double = 0
+    /// 填充颜色
+    var fillColor: Any?
+    /// 边框颜色
+    var strokeColor: Any?
+    /// 边框宽度
+    var strokeWidth: Float = 0
+    /// z-index 图层顺序
+    var zIndex: Double = 0
+    
+    /// 地图视图引用
+    private var mapView: MAMapView?
+    /// 圆形覆盖物对象
+    var circle: MACircle?
+    /// 圆形渲染器
+    private var renderer: MACircleRenderer?
+    /// 上次设置的地图引用（防止重复调用）
+    private weak var lastSetMapView: MAMapView?
+    
+    required init(appContext: AppContext? = nil) {
+        super.init(appContext: appContext)
+        
+        // 🔑 关键修复：CircleView 不应该拦截触摸事件
+        self.isUserInteractionEnabled = false
+    }
+    
+    /**
+     * 重写 hitTest，让触摸事件完全穿透此视图
+     * 这是解决覆盖物视图阻挡地图触摸的关键
+     */
+    override func hitTest(_ point: CGPoint, with event: UIEvent?) -> UIView? {
+        // 始终返回 nil，让触摸事件穿透到地图
+        return nil
+    }
+    
+    /**
+     * 重写 point(inside:with:)，确保此视图不响应任何触摸
+     */
+    override func point(inside point: CGPoint, with event: UIEvent?) -> Bool {
+        // 始终返回 false，表示点击不在此视图内
+        return false
+    }
+    
+    /**
+     * 检查地图是否已连接
+     */
+    func isMapConnected() -> Bool {
+        return mapView != nil
+    }
+    
+    /**
+     * 设置地图实例
+     * @param map 地图视图
+     */
+    func setMap(_ map: MAMapView) {
+        // 🔑 关键优化：如果是同一个地图引用，跳过重复设置
+        if lastSetMapView === map {
+            return
+        }
+        
+        lastSetMapView = map
+        self.mapView = map
+        updateCircle()
+    }
+    
+    /**
+     * 更新圆形覆盖物
+     */
+    private func updateCircle() {
+        guard let mapView = mapView else {
+            return
+        }
+        
+        guard let latitude = circleCenter["latitude"],
+              let longitude = circleCenter["longitude"],
+              radius > 0 else {
+            return
+        }
+        
+        // 🔑 坐标验证：防止无效坐标导致崩溃
+        guard latitude >= -90 && latitude <= 90,
+              longitude >= -180 && longitude <= 180 else {
+            return
+        }
+        
+        // 🔑 半径验证：防止负数或过大的半径
+        let validRadius = max(0.1, min(radius, 1000000))
+        
+        if circle == nil {
+            let coordinate = CLLocationCoordinate2D(latitude: latitude, longitude: longitude)
+            circle = MACircle(center: coordinate, radius: validRadius)
+            mapView.add(circle!)
+        } else {
+            // 先移除旧的
+            mapView.remove(circle!)
+            // 更新属性
+            circle?.coordinate = CLLocationCoordinate2D(latitude: latitude, longitude: longitude)
+            circle?.radius = validRadius
+            // 重新添加
+            mapView.add(circle!)
+        }
+        
+        renderer = nil
+    }
+    
+    /**
+     * 获取圆形渲染器
+     * @return 渲染器实例
+     */
+    func getRenderer() -> MAOverlayRenderer {
+        if renderer == nil, let circle = circle {
+            renderer = MACircleRenderer(circle: circle)
+            let parsedFillColor = ColorParser.parseColor(fillColor)
+            let parsedStrokeColor = ColorParser.parseColor(strokeColor)
+            renderer?.fillColor = parsedFillColor ?? UIColor.clear
+            renderer?.strokeColor = parsedStrokeColor ?? UIColor.clear
+            renderer?.lineWidth = CGFloat(strokeWidth)
+        }
+        // 确保即使 renderer 存在，它也与当前的 circle 实例关联
+        if renderer?.circle !== circle {
+            renderer = MACircleRenderer(circle: circle)
+        }
+        return renderer!
+    }
+    
+    /**
+     * 设置中心点
+     * @param center 中心点坐标 {latitude, longitude}
+     */
+    func setCenter(_ center: [String: Double]) {
+        circleCenter = center
+        updateCircle()
+    }
+    
+    /**
+     * 设置半径
+     * @param radius 半径(米)
+     */
+    func setRadius(_ radius: Double) {
+        self.radius = radius
+        updateCircle()
+    }
+    
+    /**
+     * 设置填充颜色
+     * @param color 颜色值
+     */
+    func setFillColor(_ color: Any?) {
+        fillColor = color
+        renderer = nil
+        updateCircle()
+    }
+    
+    /**
+     * 设置边框颜色
+     * @param color 颜色值
+     */
+    func setStrokeColor(_ color: Any?) {
+        strokeColor = color
+        renderer = nil
+        updateCircle()
+    }
+    
+    /**
+     * 设置边框宽度
+     * @param width 宽度值
+     */
+    func setStrokeWidth(_ width: Float) {
+        strokeWidth = width
+        renderer = nil
+        updateCircle()
+    }
+    
+    /**
+     * 设置 z-index
+     * @param zIndex z-index 值，数值越大越在上层
+     *
+     * 注意：iOS 高德地图的 MACircle 不直接支持 zIndex 属性
+     * overlay 的渲染顺序由添加顺序决定，后添加的在上层
+     * 这里通过重新添加来尝试改变顺序
+     */
+    func setZIndex(_ zIndex: Double) {
+        self.zIndex = zIndex
+        renderer = nil
+        updateCircle()
+    }
+    
+    /**
+     * 视图即将从父视图移除时调用
+     * 🔑 关键修复：旧架构下，React Native 移除视图时不一定立即调用 deinit
+     * 需要在 willMove(toSuperview:) 中立即清理地图覆盖物
+     */
+    override func willMove(toSuperview newSuperview: UIView?) {
+        super.willMove(toSuperview: newSuperview)
+        
+        // 当 newSuperview 为 nil 时，表示视图正在从父视图移除
+        if newSuperview == nil {
+            if let mapView = mapView, let circle = circle {
+                mapView.remove(circle)
+                self.circle = nil
+            }
+        }
+    }
+    
+    /**
+     * 析构时移除圆形（双重保险）
+     */
+    deinit {
+        if let mapView = mapView, let circle = circle {
+            mapView.remove(circle)
+        }
+        mapView = nil
+        circle = nil
+        renderer = nil
+    }
+}

package/ios/map/overlays/CircleViewModule.swift

@@ -0,0 +1,50 @@
+import ExpoModulesCore
+
+public class NaviCircleViewModule: Module {
+    public func definition() -> ModuleDefinition {
+        Name("NaviCircleView")
+        
+        View(NaviCircleView.self) {
+            Events("onCirclePress")
+            
+            Prop("center") { (view: NaviCircleView, center: [String: Double]) in
+                view.setCenter(center)
+            }
+            
+            Prop("radius") { (view: NaviCircleView, radius: Double) in
+                view.setRadius(radius)
+            }
+            
+            Prop("fillColor") { (view: NaviCircleView, color: String) in
+                view.setFillColor(color)
+            }
+            
+            Prop("strokeColor") { (view: NaviCircleView, color: String) in
+                view.setStrokeColor(color)
+            }
+            
+            Prop("strokeWidth") { (view: NaviCircleView, width: Double) in
+                view.setStrokeWidth(Float(width))
+            }
+
+            Prop("zIndex") { (view: NaviCircleView, zIndex: Double) in
+                view.setZIndex(zIndex)
+            }
+            
+            OnViewDidUpdateProps { (view: NaviCircleView) in
+                // 属性更新完成后，如果还没连接地图，尝试连接
+                if !view.isMapConnected() {
+                    // 查找父视图 NaviMapView
+                    var parent = view.superview
+                    while parent != nil {
+                        if let mapView = parent as? NaviMapView {
+                            view.setMap(mapView.mapView)
+                            return
+                        }
+                        parent = parent?.superview
+                    }
+                }
+            }
+        }
+    }
+}

package/ios/map/overlays/ClusterView.swift

@@ -0,0 +1,85 @@
+import ExpoModulesCore
+import AMapNaviKit
+
+class NaviClusterView: ExpoView {
+    var points: [[String: Any]] = []
+    var radius: Int = 100
+    var minClusterSize: Int = 2
+    
+    private var mapView: MAMapView?
+    private var annotations: [MAPointAnnotation] = []
+    
+    required init(appContext: AppContext? = nil) {
+        super.init(appContext: appContext)
+    }
+    
+    func setMap(_ map: MAMapView) {
+        self.mapView = map
+        updateCluster()
+    }
+    
+    func setPoints(_ points: [[String: Any]]) {
+        self.points = points
+        updateCluster()
+    }
+    
+    func setRadius(_ radius: Int) {
+        self.radius = radius
+        updateCluster()
+    }
+    
+    func setMinClusterSize(_ size: Int) {
+        self.minClusterSize = size
+        updateCluster()
+    }
+    
+    private func updateCluster() {
+        guard let mapView = mapView else { return }
+        
+        // 先移除旧的注释
+        removeAllAnnotations()
+        
+        // 验证数据有效性
+        guard !points.isEmpty else { return }
+        
+        for point in points {
+            guard let latitude = point["latitude"] as? Double,
+                  let longitude = point["longitude"] as? Double else {
+                continue
+            }
+            
+            let annotation = MAPointAnnotation()
+            annotation.coordinate = CLLocationCoordinate2D(latitude: latitude, longitude: longitude)
+            mapView.addAnnotation(annotation)
+            annotations.append(annotation)
+        }
+    }
+    
+    /**
+     * 移除所有标注
+     */
+    private func removeAllAnnotations() {
+        guard let mapView = mapView else { return }
+        
+        for annotation in annotations {
+            mapView.removeAnnotation(annotation)
+        }
+        annotations.removeAll()
+    }
+    
+    /**
+     * 从父视图移除时清理标注
+     */
+    override func removeFromSuperview() {
+        super.removeFromSuperview()
+        removeAllAnnotations()
+    }
+    
+    /**
+     * 析构时移除标注
+     */
+    deinit {
+        removeAllAnnotations()
+        mapView = nil
+    }
+}

package/ios/map/overlays/ClusterViewModule.swift

@@ -0,0 +1,21 @@
+import ExpoModulesCore
+
+public class NaviClusterViewModule: Module {
+    public func definition() -> ModuleDefinition {
+        Name("NaviClusterView")
+        
+        View(NaviClusterView.self) {
+            Prop("points") { (view: NaviClusterView, points: [[String: Any]]) in
+                view.setPoints(points)
+            }
+            
+            Prop("radius") { (view: NaviClusterView, radius: Int) in
+                view.setRadius(radius)
+            }
+            
+            Prop("minClusterSize") { (view: NaviClusterView, size: Int) in
+                view.setMinClusterSize(size)
+            }
+        }
+    }
+}