expo-gaode-map-navigation 1.1.5 → 1.1.6

package/ios/map/cpp/GeometryEngine.hpp

@@ -0,0 +1,159 @@
+#pragma once
+
+#include <vector>
+#include <string>
+
+namespace gaodemap {
+
+struct GeoPoint {
+    double lat;
+    double lon;
+};
+
+double calculateDistance(double lat1, double lon1, double lat2, double lon2);
+bool isPointInCircle(double pointLat, double pointLon, double centerLat, double centerLon, double radiusMeters);
+bool isPointInPolygon(double pointLat, double pointLon, const std::vector<GeoPoint>& polygon);
+double calculatePolygonArea(const std::vector<GeoPoint>& polygon);
+double calculateRectangleArea(double swLat, double swLon, double neLat, double neLon);
+
+/**
+ * Ramer-Douglas-Peucker 轨迹抽稀算法
+ * @param points 原始轨迹点
+ * @param toleranceMeters 允许的误差（米），值越大点越少
+ * @return 简化后的轨迹点
+ */
+std::vector<GeoPoint> simplifyPolyline(const std::vector<GeoPoint>& points, double toleranceMeters);
+
+/**
+ * 计算路径总长度（米）
+ */
+double calculatePathLength(const std::vector<GeoPoint>& points);
+
+/**
+ * 获取路径上指定距离的点和方向
+ * @param points 路径点
+ * @param distanceMeters 距离起点的米数
+ * @param outLat 输出纬度
+ * @param outLon 输出经度
+ * @param outAngle 输出方向角度 (0-360)
+ * @return 是否成功找到点
+ */
+bool getPointAtDistance(const std::vector<GeoPoint>& points, double distanceMeters, double* outLat, double* outLon, double* outAngle);
+
+// Result structure for nearest point calculation
+struct NearestPointResult {
+    double latitude;
+    double longitude;
+    int index; // Index of the point in the path that starts the segment (or the point itself)
+    double distanceMeters;
+};
+
+// Find the nearest point on the path to a target point
+// Returns the nearest point on the polyline segments
+NearestPointResult getNearestPointOnPath(const std::vector<GeoPoint>& path, const GeoPoint& target);
+
+/**
+ * 计算多边形的质心
+ * @param polygon 多边形点集
+ * @return 质心坐标
+ */
+GeoPoint calculateCentroid(const std::vector<GeoPoint>& polygon);
+
+/**
+ * GeoHash 编码
+ * @param lat 纬度
+ * @param lon 经度
+ * @param precision 精度 (1-12)
+ * @return GeoHash 字符串
+ */
+std::string encodeGeoHash(double lat, double lon, int precision);
+
+/**
+ * 解析高德地图 API 返回的 Polyline 字符串
+ * 格式: "lng,lat;lng,lat;..."
+ * @param polylineStr 高德原始 polyline 字符串
+ * @return 解析后的点集
+ */
+std::vector<GeoPoint> parsePolyline(const std::string& polylineStr);
+
+struct PathBounds {
+    double north;
+    double south;
+    double east;
+    double west;
+    double centerLat;
+    double centerLon;
+};
+
+/**
+ * 计算路径的边界和中心点
+ * @param points 路径点
+ * @return 边界信息
+ */
+PathBounds calculatePathBounds(const std::vector<GeoPoint>& points);
+
+// --- 瓦片与坐标转换 ---
+
+struct TileResult {
+    int x;
+    int y;
+    int z;
+};
+
+struct PixelResult {
+    double x;
+    double y;
+};
+
+/**
+ * 经纬度转瓦片坐标
+ */
+TileResult latLngToTile(double lat, double lon, int zoom);
+
+/**
+ * 瓦片坐标转经纬度
+ */
+GeoPoint tileToLatLng(int x, int y, int zoom);
+
+/**
+ * 经纬度转像素坐标
+ */
+PixelResult latLngToPixel(double lat, double lon, int zoom);
+
+/**
+ * 像素坐标转经纬度
+ */
+GeoPoint pixelToLatLng(double x, double y, int zoom);
+
+// --- 批量地理围栏与热力图 ---
+
+/**
+ * 批量判断点是否在多个多边形内 (优化版)
+ * @param pointLat 点纬度
+ * @param pointLon 点经度
+ * @param polygons 多个多边形的集合
+ * @return 所在的第一个多边形的索引，若不在任何多边形内返回 -1
+ */
+int findPointInPolygons(double pointLat, double pointLon, const std::vector<std::vector<GeoPoint>>& polygons);
+
+struct HeatmapPoint {
+    double lat;
+    double lon;
+    double weight;
+};
+
+struct HeatmapGridCell {
+    double lat;
+    double lon;
+    double intensity;
+};
+
+/**
+ * 生成热力图网格数据
+ * @param points 原始点集
+ * @param gridSizeMeters 网格大小（米）
+ * @return 网格中心点及其强度
+ */
+std::vector<HeatmapGridCell> generateHeatmapGrid(const std::vector<HeatmapPoint>& points, double gridSizeMeters);
+
+} // namespace gaodemap

package/ios/map/cpp/QuadTree.cpp

@@ -0,0 +1,92 @@
+#include "QuadTree.hpp"
+
+namespace gaodemap {
+
+bool BoundingBox::contains(double lat, double lon) const {
+    return lat >= minLat && lat <= maxLat && lon >= minLon && lon <= maxLon;
+}
+
+bool BoundingBox::intersects(const BoundingBox& other) const {
+    return !(other.minLat > maxLat || other.maxLat < minLat || 
+             other.minLon > maxLon || other.maxLon < minLon);
+}
+
+QuadTree::QuadTree(const BoundingBox& bounds, int capacity)
+    : bounds(bounds), capacity(capacity) {}
+
+bool QuadTree::insert(const ClusterPoint& point) {
+    if (!bounds.contains(point.lat, point.lon)) {
+        return false;
+    }
+
+    if (points.size() < capacity && !subdivided) {
+        points.push_back(point);
+        return true;
+    }
+
+    if (!subdivided) {
+        subdivide();
+    }
+
+    if (northWest->insert(point)) return true;
+    if (northEast->insert(point)) return true;
+    if (southWest->insert(point)) return true;
+    if (southEast->insert(point)) return true;
+
+    // Point might be exactly on the boundary of the QuadTree but not accepted by children?
+    // In our logic, children cover the full range of the parent.
+    // However, floating point precision might be tricky.
+    // As a fallback, if we are subdivided but children didn't take it (rare), 
+    // we can keep it here or force insert.
+    // Given the subdivision logic, it should cover all space.
+    return false;
+}
+
+void QuadTree::subdivide() {
+    double midLat = (bounds.minLat + bounds.maxLat) / 2.0;
+    double midLon = (bounds.minLon + bounds.maxLon) / 2.0;
+
+    northWest = std::make_unique<QuadTree>(BoundingBox{midLat, bounds.minLon, bounds.maxLat, midLon}, capacity);
+    northEast = std::make_unique<QuadTree>(BoundingBox{midLat, midLon, bounds.maxLat, bounds.maxLon}, capacity);
+    southWest = std::make_unique<QuadTree>(BoundingBox{bounds.minLat, bounds.minLon, midLat, midLon}, capacity);
+    southEast = std::make_unique<QuadTree>(BoundingBox{bounds.minLat, midLon, midLat, bounds.maxLon}, capacity);
+
+    subdivided = true;
+    
+    // Redistribute existing points
+    for (const auto& p : points) {
+        northWest->insert(p) || northEast->insert(p) || 
+        southWest->insert(p) || southEast->insert(p);
+    }
+    points.clear();
+}
+
+void QuadTree::query(const BoundingBox& range, std::vector<ClusterPoint>& found) const {
+    if (!bounds.intersects(range)) {
+        return;
+    }
+
+    for (const auto& p : points) {
+        if (range.contains(p.lat, p.lon)) {
+            found.push_back(p);
+        }
+    }
+
+    if (subdivided) {
+        northWest->query(range, found);
+        northEast->query(range, found);
+        southWest->query(range, found);
+        southEast->query(range, found);
+    }
+}
+
+void QuadTree::clear() {
+    points.clear();
+    northWest.reset();
+    northEast.reset();
+    southWest.reset();
+    southEast.reset();
+    subdivided = false;
+}
+
+}

package/ios/map/cpp/QuadTree.hpp

@@ -0,0 +1,42 @@
+#pragma once
+
+#include <vector>
+#include <memory>
+#include "ClusterEngine.hpp"
+
+namespace gaodemap {
+
+struct BoundingBox {
+    double minLat;
+    double minLon;
+    double maxLat;
+    double maxLon;
+
+    bool contains(double lat, double lon) const;
+    bool intersects(const BoundingBox& other) const;
+};
+
+class QuadTree {
+public:
+    QuadTree(const BoundingBox& bounds, int capacity = 20);
+    ~QuadTree() = default;
+
+    bool insert(const ClusterPoint& point);
+    void query(const BoundingBox& range, std::vector<ClusterPoint>& found) const;
+    void clear();
+
+private:
+    BoundingBox bounds;
+    int capacity;
+    std::vector<ClusterPoint> points;
+    bool subdivided = false;
+
+    std::unique_ptr<QuadTree> northWest;
+    std::unique_ptr<QuadTree> northEast;
+    std::unique_ptr<QuadTree> southWest;
+    std::unique_ptr<QuadTree> southEast;
+
+    void subdivide();
+};
+
+}

package/ios/map/cpp/README.md

@@ -0,0 +1,55 @@
+# C++ 共享核心库 (Shared Core)
+
+该目录包含了 `expo-gaode-map` 跨平台核心逻辑的 C++ 实现。这些代码被 Android 和 iOS 平台共享，以确保计算逻辑的一致性并提升高性能计算场景（如点聚合、几何计算）的处理速度。
+
+## 模块说明
+
+### 1. GeometryEngine (几何引擎)
+[GeometryEngine.hpp](file:///Users/wangqiang/Desktop/expo-gaode-map/packages/core/shared/cpp/GeometryEngine.hpp)
+提供地理空间相关的数学计算：
+- **距离计算**: 基于 Haversine 公式计算经纬度点之间的球面距离。
+- **点位判断**: 判断点是否在多边形 (Point-in-Polygon) 或圆形内。
+- **面积计算**: 计算多边形或矩形的地理面积。
+- **轨迹处理**:
+    - **抽稀算法**: 实现 Ramer-Douglas-Peucker 算法，用于简化复杂的折线轨迹。
+    - **路径长度**: 计算折线段的总长度。
+    - **路径插值**: 获取路径上指定距离的点坐标及其切线方向。
+- **GeoHash**: 支持经纬度到 GeoHash 字符串的编码。
+- **质心计算**: 计算多边形的几何质心。
+
+### 2. ClusterEngine (点聚合引擎)
+[ClusterEngine.hpp](file:///Users/wangqiang/Desktop/expo-gaode-map/packages/core/shared/cpp/ClusterEngine.hpp)
+负责大规模地图标记点的聚合计算：
+- 使用 **QuadTree** 进行空间索引优化。
+- 支持基于半径的聚合逻辑。
+- 高性能处理，适用于数千甚至数万个点的实时聚合。
+
+### 3. QuadTree (四叉树)
+[QuadTree.hpp](file:///Users/wangqiang/Desktop/expo-gaode-map/packages/core/shared/cpp/QuadTree.hpp)
+为地理坐标提供高效的空间索引结构：
+- **空间分割**: 自动将空间划分为四个象限。
+- **范围查询**: 快速检索指定矩形区域内的所有点位。
+- 被 `ClusterEngine` 用于加速近邻点搜索。
+
+### 4. ColorParser (颜色解析器)
+[ColorParser.hpp](file:///Users/wangqiang/Desktop/expo-gaode-map/packages/core/shared/cpp/ColorParser.hpp)
+跨平台的颜色字符串解析工具：
+- 支持 **Hex** 格式 (如 `#RRGGBB`, `#AARRGGBB`, `#RGB`)。
+- 支持 **RGB/RGBA** 函数格式 (如 `rgba(255, 0, 0, 0.5)`)。
+- 支持 **命名颜色** (如 `red`, `blue`, `transparent`)。
+- 统一输出为 `0xAARRGGBB` 格式的 32 位整数。
+
+## 测试
+
+测试用例位于 `tests/` 目录。
+
+### 运行测试
+在 macOS/Linux 环境下，可以通过以下命令运行 C++ 单元测试：
+
+```bash
+cd tests
+chmod +x run.sh
+./run.sh
+```
+
+该脚本会使用 `clang++` 编译源代码并运行生成的测试二进制文件，验证各核心模块的逻辑准确性。

package/ios/map/managers/UIManager.swift

@@ -17,6 +17,9 @@ class UIManager: NSObject, MAMapViewDelegate {
     /// 定位变化回调
     var onLocationChanged: ((_ latitude: Double, _ longitude: Double, _ accuracy: Double) -> Void)?
     
+    /// 缓存的自定义样式配置
+    private var cachedCustomStyleOptions: MAMapCustomStyleOptions?
+    
     init(mapView: MAMapView) {
         self.mapView = mapView
         super.init()
@@ -36,6 +39,13 @@ class UIManager: NSObject, MAMapViewDelegate {
         case 3: mapView.mapType = .navi
         default: mapView.mapType = .standard
         }
+        
+        // 🔑 关键修复：切换地图类型后重新应用自定义样式
+        // 某些地图类型切换可能会重置样式设置
+        if let cachedOptions = cachedCustomStyleOptions {
+            mapView.setCustomMapStyleOptions(cachedOptions)
+            mapView.customMapStyleEnabled = true
+        }
     }
     
     // MARK: - 控件显示
@@ -109,7 +119,8 @@ class UIManager: NSObject, MAMapViewDelegate {
             }
             mapView.showsUserLocation = true
             if followUser {
-                mapView.userTrackingMode = .follow
+                // 🔑 使用 followWithHeading 模式以支持方向指示器
+                mapView.userTrackingMode = .followWithHeading
             } else {
                 mapView.userTrackingMode = .none
             }
@@ -146,6 +157,12 @@ class UIManager: NSObject, MAMapViewDelegate {
         guard let mapView = mapView else { return }
         let representation = MAUserLocationRepresentation()
         
+        // 是否显示定位蓝点 (showMyLocation) - 对应 Android 的 showMyLocation
+        // iOS 通过 mapView.showsUserLocation 控制，这里提供统一的 API
+        if let showMyLocation = config["showMyLocation"] as? Bool {
+            mapView.showsUserLocation = showMyLocation
+        }
+        
         // 精度圈是否显示
         if let showsAccuracyRing = config["showsAccuracyRing"] as? Bool {
             representation.showsAccuracyRing = showsAccuracyRing
@@ -265,4 +282,58 @@ class UIManager: NSObject, MAMapViewDelegate {
     func setShowsIndoorMap(_ show: Bool) {
         mapView?.isShowsIndoorMap = show
     }
+    
+    // MARK: - 自定义地图样式
+    
+    /**
+     * 设置自定义地图样式
+     * @param styleData 样式数据，支持以下格式：
+     *   - styleId: String - 在线样式ID（从高德开放平台获取）
+     *   - styleDataPath: String - 本地样式文件路径
+     *   - extraStyleDataPath: String - 额外样式文件路径（可选）
+     */
+    func setCustomMapStyle(_ styleData: [String: Any]) {
+        guard let mapView = mapView else { return }
+        
+        // 在线样式 ID
+        if let styleId = styleData["styleId"] as? String, !styleId.isEmpty {
+            let customStyle = MAMapCustomStyleOptions()
+            customStyle.styleId = styleId
+            
+            // 🔑 缓存样式配置
+            cachedCustomStyleOptions = customStyle
+            
+            mapView.setCustomMapStyleOptions(customStyle)
+            mapView.customMapStyleEnabled = true
+            return
+        }
+        
+        // 本地样式文件
+        if let styleDataPath = styleData["styleDataPath"] as? String, !styleDataPath.isEmpty {
+            // 读取样式文件数据
+            if let stylePath = Bundle.main.path(forResource: styleDataPath, ofType: nil),
+               let styleFileData = try? Data(contentsOf: URL(fileURLWithPath: stylePath)) {
+                let customStyle = MAMapCustomStyleOptions()
+                customStyle.styleData = styleFileData
+                
+                // 额外样式文件（可选）
+                if let extraPath = styleData["extraStyleDataPath"] as? String, !extraPath.isEmpty,
+                   let extraFilePath = Bundle.main.path(forResource: extraPath, ofType: nil),
+                   let extraFileData = try? Data(contentsOf: URL(fileURLWithPath: extraFilePath)) {
+                    customStyle.styleExtraData = extraFileData
+                }
+                
+                // 🔑 缓存样式配置
+                cachedCustomStyleOptions = customStyle
+                
+                mapView.setCustomMapStyleOptions(customStyle)
+                mapView.customMapStyleEnabled = true
+                return
+            }
+        }
+        
+        // 如果没有提供任何样式，禁用自定义样式并清除缓存
+        cachedCustomStyleOptions = nil
+        mapView.customMapStyleEnabled = false
+    }
 }