expo-gaode-map 0.1.5 → 1.0.0

package/ios/managers/OverlayManager.swift

@@ -1,17 +1,39 @@
 import MAMapKit
 
+/**
+ * 覆盖物管理器
+ * 
+ * 负责:
+ * - 管理地图覆盖物(圆形、折线、多边形)
+ * - 管理标记点(Marker)
+ * - 处理覆盖物样式和渲染
+ * - 支持纹理贴图
+ */
 class OverlayManager {
+    /// 地图视图弱引用
     private weak var mapView: MAMapView?
+    /// 覆盖物字典 (id -> overlay)
     private var overlays: [String: MAOverlay] = [:]
+    /// 覆盖物样式字典 (id -> style)
     private var overlayStyles: [String: [String: Any]] = [:]
+    /// 标记点字典 (id -> annotation)
     private var annotations: [String: MAPointAnnotation] = [:]
     
+    /**
+     * 初始化覆盖物管理器
+     * @param mapView 地图视图实例
+     */
     init(mapView: MAMapView) {
         self.mapView = mapView
     }
     
-    // MARK: - Circle
+    // MARK: - Circle 圆形
     
+    /**
+     * 添加圆形覆盖物
+     * @param id 圆形唯一标识
+     * @param props 圆形属性(center, radius, fillColor, strokeColor, strokeWidth)
+     */
     func addCircle(id: String, props: [String: Any]) {
         guard let mapView = mapView,
               let center = props["center"] as? [String: Double],
@@ -25,6 +47,10 @@ class OverlayManager {
         overlays[id] = circle
     }
     
+    /**
+     * 移除圆形覆盖物
+     * @param id 圆形唯一标识
+     */
     func removeCircle(id: String) {
         guard let mapView = mapView, let circle = overlays[id] else { return }
         mapView.remove(circle)
@@ -32,13 +58,23 @@ class OverlayManager {
         overlayStyles.removeValue(forKey: id)
     }
     
+    /**
+     * 更新圆形覆盖物
+     * @param id 圆形唯一标识
+     * @param props 新的圆形属性
+     */
     func updateCircle(id: String, props: [String: Any]) {
         removeCircle(id: id)
         addCircle(id: id, props: props)
     }
     
-    // MARK: - Marker
+    // MARK: - Marker 标记点
     
+    /**
+     * 添加标记点
+     * @param id 标记点唯一标识
+     * @param props 标记点属性(position, title, description)
+     */
     func addMarker(id: String, props: [String: Any]) {
         guard let mapView = mapView,
               let position = props["position"] as? [String: Double],
@@ -53,42 +89,60 @@ class OverlayManager {
         annotations[id] = annotation
     }
     
+    /**
+     * 移除标记点
+     * @param id 标记点唯一标识
+     */
     func removeMarker(id: String) {
         guard let mapView = mapView, let annotation = annotations[id] else { return }
         mapView.removeAnnotation(annotation)
         annotations.removeValue(forKey: id)
     }
     
+    /**
+     * 更新标记点
+     * @param id 标记点唯一标识
+     * @param props 新的标记点属性
+     */
     func updateMarker(id: String, props: [String: Any]) {
         removeMarker(id: id)
         addMarker(id: id, props: props)
     }
     
-    // MARK: - Polyline
+    // MARK: - Polyline 折线
     
+    /**
+     * 添加折线覆盖物
+     * @param id 折线唯一标识
+     * @param props 折线属性(points, strokeWidth, strokeColor, texture)
+     */
     func addPolyline(id: String, props: [String: Any]) {
         guard let mapView = mapView,
-              let points = props["points"] as? [[String: Double]] else { return }
+              let points = props["points"] as? [[String: Double]] else {
+            return
+        }
+        
         var coordinates: [CLLocationCoordinate2D] = []
         for point in points {
             guard let lat = point["latitude"], let lng = point["longitude"] else { continue }
             coordinates.append(CLLocationCoordinate2D(latitude: lat, longitude: lng))
         }
-        guard !coordinates.isEmpty else { return }
+        guard coordinates.count >= 2 else {
+            return
+        }
         
-        let polyline = MAMultiPolyline()
-        polyline.setPolylineWithCoordinates(&coordinates, count: coordinates.count)
+        let polyline = MAPolyline(coordinates: &coordinates, count: UInt(coordinates.count))!
         
+        // 先保存样式和 overlay，再添加到地图
         overlayStyles[id] = props
         overlays[id] = polyline
         mapView.add(polyline)
-        
-        // 强制刷新地图渲染
-        DispatchQueue.main.async {
-            mapView.setNeedsDisplay()
-        }
     }
     
+    /**
+     * 移除折线覆盖物
+     * @param id 折线唯一标识
+     */
     func removePolyline(id: String) {
         guard let mapView = mapView, let polyline = overlays[id] else { return }
         mapView.remove(polyline)
@@ -96,13 +150,23 @@ class OverlayManager {
         overlayStyles.removeValue(forKey: id)
     }
     
+    /**
+     * 更新折线覆盖物
+     * @param id 折线唯一标识
+     * @param props 新的折线属性
+     */
     func updatePolyline(id: String, props: [String: Any]) {
         removePolyline(id: id)
         addPolyline(id: id, props: props)
     }
     
-    // MARK: - Polygon
+    // MARK: - Polygon 多边形
     
+    /**
+     * 添加多边形覆盖物
+     * @param id 多边形唯一标识
+     * @param props 多边形属性(points, fillColor, strokeColor, strokeWidth)
+     */
     func addPolygon(id: String, props: [String: Any]) {
         guard let mapView = mapView,
               let points = props["points"] as? [[String: Double]] else { return }
@@ -118,6 +182,10 @@ class OverlayManager {
         overlays[id] = polygon
     }
     
+    /**
+     * 移除多边形覆盖物
+     * @param id 多边形唯一标识
+     */
     func removePolygon(id: String) {
         guard let mapView = mapView, let polygon = overlays[id] else { return }
         mapView.remove(polygon)
@@ -125,66 +193,92 @@ class OverlayManager {
         overlayStyles.removeValue(forKey: id)
     }
     
+    /**
+     * 更新多边形覆盖物
+     * @param id 多边形唯一标识
+     * @param props 新的多边形属性
+     */
     func updatePolygon(id: String, props: [String: Any]) {
         removePolygon(id: id)
         addPolygon(id: id, props: props)
     }
     
-    // MARK: - Renderer
+    // MARK: - Renderer 渲染器
     
+    /**
+     * 获取覆盖物渲染器
+     * @param overlay 覆盖物对象
+     * @return 对应的渲染器
+     */
     func getRenderer(for overlay: MAOverlay) -> MAOverlayRenderer? {
         let id = overlays.first(where: { $0.value === overlay })?.key
         let style = id != nil ? overlayStyles[id!] : nil
         
-        print("🎨 OverlayManager.getRenderer - overlay类型: \(type(of: overlay)), id: \(id ?? "nil"), style: \(style ?? [:])")
-        
         if let circle = overlay as? MACircle {
             guard let renderer = MACircleRenderer(circle: circle) else {
                 return nil
             }
             
+            // 设置填充颜色
             if let fillColor = style?["fillColor"] {
                 renderer.fillColor = ColorParser.parseColor(fillColor)
             }
+            // 设置边框颜色
             if let strokeColor = style?["strokeColor"] {
                 renderer.strokeColor = ColorParser.parseColor(strokeColor)
             }
+            // 设置边框宽度
             if let strokeWidth = style?["strokeWidth"] as? Double {
                 renderer.lineWidth = CGFloat(strokeWidth)
             }
             
             return renderer
-        } else if let polyline = overlay as? MAMultiPolyline {
-            let renderer = MAMultiColoredPolylineRenderer(multiPolyline: polyline)
+        } else if let polyline = overlay as? MAPolyline {
+            let renderer = MAPolylineRenderer(polyline: polyline)!
             
-            if let color = style?["color"] {
-                renderer?.strokeColor = ColorParser.parseColor(color) ?? .red
-            } else if let strokeColor = style?["strokeColor"] {
-                renderer?.strokeColor = ColorParser.parseColor(strokeColor) ?? .red
+            // 设置线宽
+            if let width = style?["width"] as? Double {
+                renderer.lineWidth = CGFloat(width)
+            } else if let strokeWidth = style?["strokeWidth"] as? Double {
+                renderer.lineWidth = CGFloat(strokeWidth)
             } else {
-                renderer?.strokeColor = .red
+                renderer.lineWidth = 8
             }
             
-            if let width = style?["width"] as? Double {
-                renderer?.lineWidth = CGFloat(width)
-            } else if let strokeWidth = style?["strokeWidth"] as? Double {
-                renderer?.lineWidth = CGFloat(strokeWidth)
+            // 设置线条样式
+            renderer.lineJoinType = kMALineJoinRound
+            renderer.lineCapType = kMALineCapRound
+            
+            // 设置纹理或颜色
+            if let textureUrl = style?["texture"] as? String, !textureUrl.isEmpty {
+                loadPolylineTexture(url: textureUrl, renderer: renderer)
             } else {
-                renderer?.lineWidth = 5
+                if let color = style?["color"] {
+                    let parsedColor = ColorParser.parseColor(color)
+                    renderer.strokeColor = parsedColor ?? .red
+                } else if let strokeColor = style?["strokeColor"] {
+                    let parsedColor = ColorParser.parseColor(strokeColor)
+                    renderer.strokeColor = parsedColor ?? .red
+                } else {
+                    renderer.strokeColor = .red
+                }
             }
             
-            return renderer!
+            return renderer
         } else if let polygon = overlay as? MAPolygon {
             guard let renderer = MAPolygonRenderer(polygon: polygon) else {
                 return nil
             }
             
+            // 设置填充颜色
             if let fillColor = style?["fillColor"] {
                 renderer.fillColor = ColorParser.parseColor(fillColor)
             }
+            // 设置边框颜色
             if let strokeColor = style?["strokeColor"] {
                 renderer.strokeColor = ColorParser.parseColor(strokeColor)
             }
+            // 设置边框宽度
             if let strokeWidth = style?["strokeWidth"] as? Double {
                 renderer.lineWidth = CGFloat(strokeWidth)
             }
@@ -195,6 +289,54 @@ class OverlayManager {
         return nil
     }
     
+    /**
+     * 加载折线纹理图片
+     * @param url 图片 URL (支持 http/https/file/本地资源)
+     * @param renderer 折线渲染器
+     */
+    private func loadPolylineTexture(url: String, renderer: MAPolylineRenderer) {
+        if url.hasPrefix("http://") || url.hasPrefix("https://") {
+            // 网络图片
+            guard let imageUrl = URL(string: url) else {
+                return
+            }
+            URLSession.shared.dataTask(with: imageUrl) { [weak self] data, _, error in
+                if let error = error {
+                    return
+                }
+                guard let data = data, let image = UIImage(data: data) else {
+                    return
+                }
+                DispatchQueue.main.async {
+                    self?.applyPolylineTexture(image: image, to: renderer)
+                }
+            }.resume()
+        } else if url.hasPrefix("file://") {
+            // 本地文件
+            let path = String(url.dropFirst(7))
+            if let image = UIImage(contentsOfFile: path) {
+                applyPolylineTexture(image: image, to: renderer)
+            }
+        } else {
+            // 资源文件
+            if let image = UIImage(named: url) {
+                applyPolylineTexture(image: image, to: renderer)
+            }
+        }
+    }
+    
+    /**
+     * 应用纹理到折线渲染器
+     * @param image 纹理图片
+     * @param renderer 折线渲染器
+     */
+    private func applyPolylineTexture(image: UIImage, to renderer: MAPolylineRenderer) {
+        renderer.strokeImage = image
+    }
+    
+    /**
+     * 清除所有覆盖物和标记点
+     */
     func clear() {
         guard let mapView = mapView else { return }
         for overlay in overlays.values {
@@ -207,4 +349,4 @@ class OverlayManager {
         overlayStyles.removeAll()
         annotations.removeAll()
     }
-}
+}

package/ios/managers/UIManager.swift

@@ -1,49 +1,100 @@
 import MAMapKit
 
+/**
+ * UI 和手势管理器
+ * 
+ * 负责:
+ * - 地图类型设置
+ * - 控件显示控制
+ * - 手势交互控制
+ * - 图层显示管理
+ * - 用户位置样式配置
+ */
 class UIManager {
+    /// 弱引用地图视图,避免循环引用
     private weak var mapView: MAMapView?
     
     init(mapView: MAMapView) {
         self.mapView = mapView
     }
     
+    // MARK: - 地图类型
+    
+    /**
+     * 设置地图类型
+     * @param type 0:标准 1:卫星 2:夜间 3:导航
+     */
     func setMapType(_ type: Int) {
         guard let mapView = mapView else { return }
         switch type {
         case 1: mapView.mapType = .satellite
         case 2: mapView.mapType = .standardNight
+        case 3: mapView.mapType = .navi
         default: mapView.mapType = .standard
         }
     }
     
+    // MARK: - 控件显示
+    
+    /**
+     * 设置是否显示缩放控件
+     * iOS 高德地图不支持缩放控件
+     */
     func setShowsZoomControls(_ show: Bool) {
-        // iOS 高德地图不支持缩放控件
+        // iOS 不支持
     }
     
+    /**
+     * 设置是否显示指南针
+     */
     func setShowsCompass(_ show: Bool) {
         mapView?.showsCompass = show
     }
     
+    /**
+     * 设置是否显示比例尺
+     */
     func setShowsScale(_ show: Bool) {
         mapView?.showsScale = show
     }
     
+    // MARK: - 手势控制
+    
+    /**
+     * 设置是否启用缩放手势
+     */
     func setZoomEnabled(_ enabled: Bool) {
         mapView?.isZoomEnabled = enabled
     }
     
+    /**
+     * 设置是否启用滚动手势
+     */
     func setScrollEnabled(_ enabled: Bool) {
         mapView?.isScrollEnabled = enabled
     }
     
+    /**
+     * 设置是否启用旋转手势
+     */
     func setRotateEnabled(_ enabled: Bool) {
         mapView?.isRotateEnabled = enabled
     }
     
+    /**
+     * 设置是否启用倾斜手势
+     */
     func setTiltEnabled(_ enabled: Bool) {
         mapView?.isRotateCameraEnabled = enabled
     }
     
+    // MARK: - 用户位置
+    
+    /**
+     * 设置是否显示用户位置
+     * @param show 是否显示
+     * @param followUser 是否跟随用户
+     */
     func setShowsUserLocation(_ show: Bool, followUser: Bool) {
         guard let mapView = mapView else { return }
         mapView.showsUserLocation = show
@@ -54,6 +105,10 @@ class UIManager {
         }
     }
     
+    /**
+     * 设置用户位置样式
+     * @param config 样式配置字典
+     */
     func setUserLocationRepresentation(_ config: [String: Any]) {
         guard let mapView = mapView else { return }
         let representation = MAUserLocationRepresentation()
@@ -142,6 +197,12 @@ class UIManager {
         mapView.update(representation)
     }
     
+    /**
+     * 调整图片大小
+     * @param image 原始图片
+     * @param targetSize 目标大小
+     * @return 调整后的图片
+     */
     private func resizeImage(_ image: UIImage, targetSize: CGSize) -> UIImage {
         let renderer = UIGraphicsImageRenderer(size: targetSize)
         return renderer.image { _ in
@@ -149,14 +210,25 @@ class UIManager {
         }
     }
     
+    // MARK: - 图层显示
+    
+    /**
+     * 设置是否显示交通路况
+     */
     func setShowsTraffic(_ show: Bool) {
         mapView?.isShowTraffic = show
     }
     
+    /**
+     * 设置是否显示建筑物
+     */
     func setShowsBuildings(_ show: Bool) {
         mapView?.isShowsBuildings = show
     }
     
+    /**
+     * 设置是否显示室内地图
+     */
     func setShowsIndoorMap(_ show: Bool) {
         mapView?.isShowsIndoorMap = show
     }