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

package/ios/map/ExpoGaodeMapViewModule.swift

@@ -0,0 +1,108 @@
+import ExpoModulesCore
+import AMapNaviKit
+
+/**
+ * 高德地图视图 Module
+ */
+public class NaviMapViewModule: Module {
+    public func definition() -> ModuleDefinition {
+        Name("NaviMapView")
+        
+        View(NaviMapView.self) {
+            Events("onMapPress", "onMapLongPress", "onLoad", "onLocation", "onCameraMove", "onCameraIdle")
+            
+            Prop("mapType") { (view: NaviMapView, type: Int) in
+                view.mapType = type
+            }
+            
+            Prop("initialCameraPosition") { (view: NaviMapView, position: [String: Any]?) in
+                view.initialCameraPosition = position
+            }
+            
+            Prop("maxZoom") { (view: NaviMapView, zoom: Double) in
+                view.setMaxZoom(zoom)
+            }
+            
+            Prop("minZoom") { (view: NaviMapView, zoom: Double) in
+                view.setMinZoom(zoom)
+            }
+            
+            Prop("zoomControlsEnabled") { (view: NaviMapView, show: Bool) in
+                view.showsZoomControls = show
+            }
+            
+            Prop("compassEnabled") { (view: NaviMapView, show: Bool) in
+                view.showsCompass = show
+            }
+            
+            Prop("scaleControlsEnabled") { (view: NaviMapView, show: Bool) in
+                view.showsScale = show
+            }
+            
+            Prop("zoomGesturesEnabled") { (view: NaviMapView, enabled: Bool) in
+                view.isZoomEnabled = enabled
+            }
+            
+            Prop("scrollGesturesEnabled") { (view: NaviMapView, enabled: Bool) in
+                view.isScrollEnabled = enabled
+            }
+            
+            Prop("rotateGesturesEnabled") { (view: NaviMapView, enabled: Bool) in
+                view.isRotateEnabled = enabled
+            }
+            
+            Prop("tiltGesturesEnabled") { (view: NaviMapView, enabled: Bool) in
+                view.isTiltEnabled = enabled
+            }
+            
+            Prop("myLocationEnabled") { (view: NaviMapView, show: Bool) in
+                view.setShowsUserLocation(show)
+            }
+            
+            Prop("followUserLocation") { (view: NaviMapView, follow: Bool) in
+                view.setFollowUserLocation(follow)
+            }
+            
+            Prop("userLocationRepresentation") { (view: NaviMapView, config: [String: Any]) in
+                view.setUserLocationRepresentation(config)
+            }
+            
+            Prop("trafficEnabled") { (view: NaviMapView, show: Bool) in
+                view.setShowsTraffic(show)
+            }
+            
+            Prop("buildingsEnabled") { (view: NaviMapView, show: Bool) in
+                view.setShowsBuildings(show)
+            }
+            
+            Prop("indoorViewEnabled") { (view: NaviMapView, show: Bool) in
+                view.setShowsIndoorMap(show)
+            }
+            
+            OnViewDidUpdateProps { (view: NaviMapView) in
+                view.applyProps()
+            }
+            
+            AsyncFunction("moveCamera") { (view: NaviMapView, position: [String: Any], duration: Int) in
+                view.moveCamera(position: position, duration: duration)
+            }
+            
+            AsyncFunction("getLatLng") { (view: NaviMapView, point: [String: Double]) -> [String: Double] in
+                return view.getLatLng(point: point)
+            }
+            
+            AsyncFunction("setCenter") { (view: NaviMapView, center: [String: Double], animated: Bool) in
+                view.setCenter(center: center, animated: animated)
+            }
+            
+            AsyncFunction("setZoom") { (view: NaviMapView, zoom: Double, animated: Bool) in
+                view.setZoom(zoom: zoom, animated: animated)
+            }
+            
+            AsyncFunction("getCameraPosition") { (view: NaviMapView) -> [String: Any] in
+                return view.getCameraPosition()
+            }
+          
+        }
+    }
+}

package/ios/map/managers/CameraManager.swift

@@ -0,0 +1,186 @@
+import ExpoModulesCore
+import AMapNaviKit
+
+/**
+ * 相机管理器
+ * 
+ * 负责:
+ * - 相机位置和视角控制
+ * - 缩放级别管理
+ * - 坐标转换
+ */
+class CameraManager {
+    /// 弱引用地图视图,避免循环引用
+    private weak var mapView: MAMapView?
+    
+    init(mapView: MAMapView) {
+        self.mapView = mapView
+    }
+    
+    // MARK: - 缩放级别控制
+    
+    /**
+     * 设置最大缩放级别
+     * @param maxZoom 最大缩放级别 (3-20)
+     */
+    func setMaxZoomLevel(_ maxZoom: CGFloat) {
+        mapView?.maxZoomLevel = maxZoom
+    }
+    
+    /**
+     * 设置最小缩放级别
+     * @param minZoom 最小缩放级别 (3-20)
+     */
+    func setMinZoomLevel(_ minZoom: CGFloat) {
+        mapView?.minZoomLevel = minZoom
+    }
+    
+    // MARK: - 相机位置控制
+    
+    /**
+     * 设置初始相机位置
+     * 不带动画,用于地图初始化
+     * @param position 包含 target、zoom、bearing、tilt 的字典
+     */
+    func setInitialCameraPosition(_ position: [String: Any]) {
+        guard let mapView = mapView else { return }
+        let status = MAMapStatus()
+        
+        if let target = position["target"] as? [String: Double],
+           let latitude = target["latitude"],
+           let longitude = target["longitude"] {
+            // 🔑 坐标验证
+            guard latitude >= -90 && latitude <= 90,
+                  longitude >= -180 && longitude <= 180 else {
+                return
+            }
+            status.centerCoordinate = CLLocationCoordinate2D(latitude: latitude, longitude: longitude)
+        }
+        
+        if let zoom = position["zoom"] as? Double {
+            // 🔑 缩放级别范围限制 (3-20)
+            let validZoom = max(3, min(20, zoom))
+            status.zoomLevel = CGFloat(validZoom)
+        }
+        
+        if let bearing = position["bearing"] as? Double {
+            status.rotationDegree = CGFloat(bearing)
+        }
+        
+        if let tilt = position["tilt"] as? Double {
+            status.cameraDegree = CGFloat(tilt)
+        }
+        
+        mapView.setMapStatus(status, animated: false, duration: 0)
+    }
+    
+    /**
+     * 移动相机到指定位置
+     * 支持动画效果
+     * @param position 目标位置信息
+     * @param duration 动画时长(毫秒)
+     */
+    func moveCamera(position: [String: Any], duration: Int) {
+        guard let mapView = mapView else { return }
+        
+        let status = MAMapStatus()
+        
+        // 设置中心点,如果未提供则保持当前值
+        if let target = position["target"] as? [String: Double],
+           let latitude = target["latitude"],
+           let longitude = target["longitude"] {
+            // 🔑 坐标验证
+            guard latitude >= -90 && latitude <= 90,
+                  longitude >= -180 && longitude <= 180 else {
+                return
+            }
+            status.centerCoordinate = CLLocationCoordinate2D(latitude: latitude, longitude: longitude)
+        } else {
+            status.centerCoordinate = mapView.centerCoordinate
+        }
+        
+        // 设置缩放级别
+        if let zoom = position["zoom"] as? Double {
+            status.zoomLevel = CGFloat(zoom)
+        } else {
+            status.zoomLevel = mapView.zoomLevel
+        }
+        
+        // 设置旋转角度
+        if let bearing = position["bearing"] as? Double {
+            status.rotationDegree = CGFloat(bearing)
+        } else {
+            status.rotationDegree = mapView.rotationDegree
+        }
+        
+        // 设置倾斜角度
+        if let tilt = position["tilt"] as? Double {
+            status.cameraDegree = CGFloat(tilt)
+        } else {
+            status.cameraDegree = mapView.cameraDegree
+        }
+        
+        mapView.setMapStatus(status, animated: duration > 0, duration: TimeInterval(duration) / 1000.0)
+    }
+    
+    /**
+     * 设置地图中心点
+     * @param center 中心点坐标
+     * @param animated 是否使用动画
+     */
+    func setCenter(center: [String: Double], animated: Bool) {
+        guard let mapView = mapView,
+              let latitude = center["latitude"],
+              let longitude = center["longitude"] else { return }
+        
+        // 🔑 坐标验证
+        guard latitude >= -90 && latitude <= 90,
+              longitude >= -180 && longitude <= 180 else {
+            return
+        }
+        
+        mapView.setCenter(CLLocationCoordinate2D(latitude: latitude, longitude: longitude), animated: animated)
+    }
+    
+    /**
+     * 设置缩放级别
+     * @param zoom 缩放级别 (3-20)
+     * @param animated 是否使用动画
+     */
+    func setZoomLevel(zoom: CGFloat, animated: Bool) {
+        // 🔑 缩放级别范围限制 (3-20)
+        let validZoom = max(3, min(20, zoom))
+        mapView?.setZoomLevel(validZoom, animated: animated)
+    }
+    
+    // MARK: - 相机信息获取
+    
+    /**
+     * 获取当前相机位置信息
+     * @return 包含 target、zoom、bearing、tilt 的字典
+     */
+    func getCameraPosition() -> [String: Any] {
+        guard let mapView = mapView else { return [:] }
+        let center = mapView.centerCoordinate
+        return [
+            "target": ["latitude": center.latitude, "longitude": center.longitude],
+            "zoom": Double(mapView.zoomLevel),
+            "bearing": Double(mapView.rotationDegree),
+            "tilt": Double(mapView.cameraDegree)
+        ]
+    }
+    
+    /**
+     * 将屏幕坐标转换为地理坐标
+     * @param point 屏幕坐标点 {x, y}
+     * @return 地理坐标 {latitude, longitude}
+     */
+    func getLatLng(point: [String: Double]) -> [String: Double] {
+        guard let mapView = mapView,
+              let x = point["x"],
+              let y = point["y"] else { return [:] }
+        let screenPoint = CGPoint(x: x, y: y)
+        let coordinate = mapView.convert(screenPoint, toCoordinateFrom: mapView)
+        return ["latitude": coordinate.latitude, "longitude": coordinate.longitude]
+    }
+}

package/ios/map/managers/UIManager.swift

@@ -0,0 +1,268 @@
+import AMapNaviKit
+
+/**
+ * UI 和手势管理器
+ * 
+ * 负责:
+ * - 地图类型设置
+ * - 控件显示控制
+ * - 手势交互控制
+ * - 图层显示管理
+ * - 用户位置样式配置
+ */
+class UIManager: NSObject, MAMapViewDelegate {
+    /// 弱引用地图视图,避免循环引用
+    private weak var mapView: MAMapView?
+    
+    /// 定位变化回调
+    var onLocationChanged: ((_ latitude: Double, _ longitude: Double, _ accuracy: Double) -> Void)?
+    
+    init(mapView: MAMapView) {
+        self.mapView = mapView
+        super.init()
+    }
+    
+    // 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 不支持
+    }
+    
+    /**
+     * 设置是否显示指南针
+     */
+    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 }
+        
+        if show {
+            // 设置代理以监听定位更新
+            if mapView.delegate == nil {
+                mapView.delegate = self
+            }
+            mapView.showsUserLocation = true
+            if followUser {
+                mapView.userTrackingMode = .follow
+            } else {
+                mapView.userTrackingMode = .none
+            }
+        } else {
+            mapView.showsUserLocation = false
+            mapView.userTrackingMode = .none
+        }
+    }
+    
+    // MARK: - MAMapViewDelegate
+    
+    /**
+     * 定位更新回调
+     */
+    public func mapView(_ mapView: MAMapView, didUpdate userLocation: MAUserLocation, updatingLocation: Bool) {
+        guard updatingLocation, let location = userLocation.location else { return }
+        
+        // 🔑 坐标验证
+        let latitude = location.coordinate.latitude
+        let longitude = location.coordinate.longitude
+        guard latitude >= -90 && latitude <= 90,
+              longitude >= -180 && longitude <= 180 else {
+            return
+        }
+        
+        onLocationChanged?(latitude, longitude, location.horizontalAccuracy)
+    }
+    
+    /**
+     * 设置用户位置样式
+     * @param config 样式配置字典
+     */
+    func setUserLocationRepresentation(_ config: [String: Any]) {
+        guard let mapView = mapView else { return }
+        let representation = MAUserLocationRepresentation()
+        
+        // 精度圈是否显示
+        if let showsAccuracyRing = config["showsAccuracyRing"] as? Bool {
+            representation.showsAccuracyRing = showsAccuracyRing
+        }
+        
+        // 是否显示方向指示
+        if let showsHeadingIndicator = config["showsHeadingIndicator"] as? Bool {
+            representation.showsHeadingIndicator = showsHeadingIndicator
+        }
+        
+        // 精度圈填充颜色
+        if let fillColor = config["fillColor"] {
+            representation.fillColor = ColorParser.parseColor(fillColor)
+        }
+        
+        // 精度圈边线颜色
+        if let strokeColor = config["strokeColor"] {
+            representation.strokeColor = ColorParser.parseColor(strokeColor)
+        }
+        
+        // 精度圈边线宽度
+        if let lineWidth = config["lineWidth"] as? Double {
+            representation.lineWidth = CGFloat(lineWidth)
+        }
+        
+        // 内部蓝色圆点是否使用律动效果
+        if let enablePulseAnimation = config["enablePulseAnimation"] as? Bool {
+            representation.enablePulseAnnimation = enablePulseAnimation
+        }
+        
+        // 定位点背景色
+        if let locationDotBgColor = config["locationDotBgColor"] {
+            representation.locationDotBgColor = ColorParser.parseColor(locationDotBgColor)
+        }
+        
+        // 定位点蓝色圆点颜色
+        if let locationDotFillColor = config["locationDotFillColor"] {
+            representation.locationDotFillColor = ColorParser.parseColor(locationDotFillColor)
+        }
+        
+        // 定位图标
+        if let imagePath = config["image"] as? String {
+            let imageWidth = config["imageWidth"] as? Double
+            let imageHeight = config["imageHeight"] as? Double
+            
+            if imagePath.hasPrefix("http://") || imagePath.hasPrefix("https://") {
+                // 网络图片 - 异步加载
+                DispatchQueue.global().async {
+                    if let url = URL(string: imagePath),
+                       let data = try? Data(contentsOf: url),
+                       var image = UIImage(data: data) {
+                        if let width = imageWidth, let height = imageHeight {
+                            image = self.resizeImage(image, targetSize: CGSize(width: width, height: height))
+                        }
+                        DispatchQueue.main.async {
+                            representation.image = image
+                            mapView.update(representation)
+                        }
+                    }
+                }
+                return
+            } else if imagePath.hasPrefix("file://") {
+                // 本地文件
+                let path = String(imagePath.dropFirst(7))
+                if var image = UIImage(contentsOfFile: path) {
+                    if let width = imageWidth, let height = imageHeight {
+                        image = resizeImage(image, targetSize: CGSize(width: width, height: height))
+                    }
+                    representation.image = image
+                }
+            } else {
+                // 资源文件
+                if var image = UIImage(named: imagePath) {
+                    if let width = imageWidth, let height = imageHeight {
+                        image = resizeImage(image, targetSize: CGSize(width: width, height: height))
+                    }
+                    representation.image = image
+                }
+            }
+        }
+        
+        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
+            image.draw(in: CGRect(origin: .zero, size: targetSize))
+        }
+    }
+    
+    // MARK: - 图层显示
+    
+    /**
+     * 设置是否显示交通路况
+     */
+    func setShowsTraffic(_ show: Bool) {
+        mapView?.isShowTraffic = show
+    }
+    
+    /**
+     * 设置是否显示建筑物
+     */
+    func setShowsBuildings(_ show: Bool) {
+        mapView?.isShowsBuildings = show
+    }
+    
+    /**
+     * 设置是否显示室内地图
+     */
+    func setShowsIndoorMap(_ show: Bool) {
+        mapView?.isShowsIndoorMap = show
+    }
+}