expo-gaode-map-navigation 2.0.13 → 2.0.15

package/README.md

@@ -7,7 +7,7 @@
 - 🗺️ **地图渲染**：内置完整地图能力，支持 Marker、Polyline、Polygon、Circle、Cluster、HeatMap 等覆盖物。
 - 🔍 **原生搜索**：内置 POI 搜索、周边搜索、沿途搜索、输入提示、逆地理编码等搜索能力。
 - 🚗 **多模式路径规划**：支持驾车、步行、骑行、电动车、货车、摩托车等多种出行方式。
-- 🧭 **实时导航 UI**：提供 `NaviView` 官方嵌入视图，并暴露完整事件与原生参数，方便你自行定制导航界面。
+- 🧭 **实时导航 UI**：提供 `ExpoGaodeMapNaviView` 官方嵌入视图，并暴露完整事件与原生参数，方便你自行定制导航界面。
 - 🛣️ **独立路径规划**：支持“先算路、再导航”的高级模式，可实现多路线对比与选择。
 - ⚙️ **策略丰富**：支持速度优先、避让拥堵、少收费、不走高速等多种算路策略。
 - ✅ **开箱即用**：封装了 Android/iOS 原生导航 SDK，统一 JS 接口。
@@ -30,7 +30,7 @@ npm install expo-gaode-map-navigation
 **⚠️ 重要提示：**
 如果项目中已安装 `expo-gaode-map`，请务必先卸载，否则会导致 Android 端二进制冲突（`3dmap` vs `navi-3dmap`）。`expo-gaode-map` 和 `expo-gaode-map-navigation` 由于 SDK 冲突不能同时安装，二选一使用。
 
-`expo-gaode-map-search` 的独立集成只维护到 `2.2.33`。从下个版本开始，搜索能力随 `expo-gaode-map` / `expo-gaode-map-navigation` 一起维护；在导航包中请直接从 `expo-gaode-map-navigation` 导入搜索 API。
+`expo-gaode-map-search` 的独立集成只维护到 `2.2.33`。从 `2.0.13` 开始，搜索能力随 `expo-gaode-map` / `expo-gaode-map-navigation` 一起维护；在导航包中请直接从 `expo-gaode-map-navigation` 导入搜索 API。
 
 高德官方 Android SDK 在 `10.0.700` 之后将远程依赖由“地图 + 定位”调整为“地图 + 定位 + 搜索”，依赖地址从 `com.amap.api:3dmap:latest.integration` 调整为 `com.amap.api:3dmap-location-search:latest.integration`。继续单独维护 search 模块会带来重复合包和依赖冲突成本，因此搜索能力改为随 core / navigation 一起维护。
 
@@ -80,8 +80,8 @@ npx expo run:ios
 - `enableBackgroundAudio` 仅 iOS 生效（默认随 `enableBackgroundLocation` 自动开启），用于注入 `UIBackgroundModes: audio`，保障后台导航语音持续播报。
 - `enableIOSLiveActivity` 仅 iOS 生效，用于注入 `NSSupportsLiveActivities`。
 - `enableIOSLiveActivityFrequentUpdates` 仅 iOS 生效，用于注入 `NSSupportsLiveActivitiesFrequentUpdates`。
-- 运行时还需要在 `NaviView` 里显式传 `androidBackgroundNavigationNotificationEnabled={true}` 才会在应用退到后台后显示导航常驻通知。
-- iOS 运行时还需要在 `NaviView` 里显式传 `iosLiveActivityEnabled={true}` 才会持续更新 Live Activity。
+- 运行时还需要在 `ExpoGaodeMapNaviView` 里显式传 `androidBackgroundNavigationNotificationEnabled={true}` 才会在应用退到后台后显示导航常驻通知。
+- iOS 运行时还需要在 `ExpoGaodeMapNaviView` 里显式传 `iosLiveActivityEnabled={true}` 才会持续更新 Live Activity。
 
 ## 示例工程
 
@@ -89,7 +89,7 @@ npx expo run:ios
 
 推荐场景：
 
-- 调试 `NaviView` 与示例工程里的自定义 HUD / 车道 HUD / 路况光柱
+- 调试 `ExpoGaodeMapNaviView` 与示例工程里的自定义 HUD / 车道 HUD / 路况光柱
 - 对比官方黑盒页、官方嵌入式页、自绘嵌入式页
 - 验证独立算路、多路线选择、近似跟线导航
 
@@ -170,15 +170,16 @@ export default function BasicMapScreen() {
 
 ### 2. 嵌入导航视图
 
-使用 `NaviView` 组件直接嵌入导航界面：
+使用 `ExpoGaodeMapNaviView` 组件直接嵌入导航界面：
 
 ```tsx
 import React, { useEffect, useRef } from 'react';
 import { View } from 'react-native';
-import { NaviView, type NaviViewRef } from 'expo-gaode-map-navigation';
+import { ExpoGaodeMapNaviView } from 'expo-gaode-map-navigation';
+import type { ExpoGaodeMapNaviViewRef } from 'expo-gaode-map-navigation';
 
 export default function NavigationScreen() {
-  const naviRef = useRef<NaviViewRef>(null);
+  const naviRef = useRef<ExpoGaodeMapNaviViewRef>(null);
 
   useEffect(() => {
     // 延迟 1 秒后开始导航
@@ -196,7 +197,7 @@ export default function NavigationScreen() {
 
   return (
     <View style={{ flex: 1 }}>
-      <NaviView
+      <ExpoGaodeMapNaviView
         ref={naviRef}
         style={{ flex: 1 }}
         showCamera={true} // 显示摄像头
@@ -211,17 +212,17 @@ export default function NavigationScreen() {
 
 ### 3. 自定义嵌入式导航 UI
 
-如果你要做“嵌入在自己页面里的导航页”，库本身提供的是底层 `NaviView`、导航事件和原生参数；完整的自定义 HUD / 车道 HUD / 路况光柱参考实现，已经迁移到仓库内的 [`example-navigation`](/Volumes/xinxin/expo-gaode-map/example-navigation/README.md)。
+如果你要做“嵌入在自己页面里的导航页”，库本身提供的是底层 `ExpoGaodeMapNaviView`、导航事件和原生参数；完整的自定义 HUD / 车道 HUD / 路况光柱参考实现，已经迁移到仓库内的 [`example-navigation`](/Volumes/xinxin/expo-gaode-map/example-navigation/README.md)。
 
 建议做法：
 
-- 用 `NaviView` 负责底层导航地图、语音、车道事件、路况事件、路口大图事件
+- 用 `ExpoGaodeMapNaviView` 负责底层导航地图、语音、车道事件、路况事件、路口大图事件
 - 用 `onNaviInfoUpdate`、`onLaneInfoUpdate`、`onTrafficStatusesUpdate`、`onNaviVisualStateChange` 在业务侧自绘 HUD
 - 直接参考 `example-navigation/lib/navigation-ui/EmbeddedNaviView.tsx` 及配套 UI 文件，按你的产品需求裁剪
 
 注意：
 
-- Android 官方嵌入式 `NaviView` 在部分 React Native / Expo 宿主中，顶部信息区、车道条、路口大图联动效果可能与高德官方 Demo 不完全一致
+- Android 官方嵌入式 `ExpoGaodeMapNaviView` 在部分 React Native / Expo 宿主中，顶部信息区、车道条、路口大图联动效果可能与高德官方 Demo 不完全一致
 - 如果你要验证官方嵌入式 UI 本身，请直接跑 `example-navigation` 里的 `official-embedded` 示例页
 - 如果你要交付稳定的嵌入式导航页，建议以示例工程里的“自定义 UI 导航界面”作为起点
 
@@ -494,6 +495,13 @@ const result = await calculateTransitRoute({
 - 可共享的范围仅限纯 TS 的 route / AOI 数据适配工具、文档和测试思路
 - 原生地图桥接、overlay 宿主逻辑、MapView facade 不会和核心包合并
 
+### 导入入口
+
+- 运行时能力优先使用命名导出，例如 `calculateRoute`、`ExpoGaodeMapNaviView`、`openOfficialNaviPage`
+- 类型请用 `import type`，例如 `RouteOptions`、`FollowWebPlannedRouteResult`
+- 默认导出保留给需要整包挂载的场景，内容与常用路径规划和导航函数一致
+- `NaviView` / `NaviViewRef` 仍作为兼容别名保留，新代码建议使用 `ExpoGaodeMapNaviView` / `ExpoGaodeMapNaviViewRef`
+
 ## API 参考
 
 ### DriveStrategy (驾车策略)
@@ -527,7 +535,7 @@ const result = await calculateTransitRoute({
 - 基于 `onTrafficStatusesUpdate` 的自绘路况光柱
 - “全览 / 锁车”与路况开关等浮层控制按钮
 
-### NaviView Props
+### ExpoGaodeMapNaviView Props
 
 | 属性 | 类型 | 说明 |
 |---|---|---|
@@ -569,7 +577,7 @@ const result = await calculateTransitRoute({
 | `onNaviInfoUpdate` | function | 导航信息更新（剩余距离、时间等） |
 | `onLaneInfoUpdate` | function | Android / iOS 车道信息更新，用于自绘车道 HUD |
 
-### NaviView UI 能力清单
+### ExpoGaodeMapNaviView UI 能力清单
 
 已开放且两端都有实现：
 
@@ -641,7 +649,7 @@ const result = await calculateTransitRoute({
 2.  **Web API**：如果需要更灵活的 HTTP 算路（如公交跨城规划、Web端展示），推荐配合 `expo-gaode-map-web-api` 使用。
 3.  **权限**：使用导航功能前，请确保应用已获取定位权限（`ACCESS_FINE_LOCATION`）。
 4.  **Android 状态栏兼容性**：`naviStatusBarEnabled` 依赖高德 Android 导航 SDK 某些版本才提供的 `AMapNaviViewOptions.setNaviStatusBarEnabled(...)`。当前封装已做兼容处理：若宿主工程解析到的 SDK 不包含该方法，则不会再编译失败，而是在运行时跳过该设置并输出 warning。此时该 prop 在 Android 上等价于 no-op。
-5.  **嵌入式 UI 边界**：库导出的是底层 `NaviView` 能力；完整自定义导航界面请参考 `example-navigation` 里的示例实现，它也不是高德官方黑盒导航页的 UI 替代品。
+5.  **嵌入式 UI 边界**：库导出的是底层 `ExpoGaodeMapNaviView` 能力；完整自定义导航界面请参考 `example-navigation` 里的示例实现，它也不是高德官方黑盒导航页的 UI 替代品。
 
 
 ## 📚 文档与资源

package/android/.project

@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>expo-gaode-map-navigation</name>
+	<comment>Project example-navigation-android-expo-gaode-map-navigation created by Buildship.</comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>org.eclipse.jdt.core.javabuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+		<buildCommand>
+			<name>org.eclipse.buildship.core.gradleprojectbuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>org.eclipse.jdt.core.javanature</nature>
+		<nature>org.eclipse.buildship.core.gradleprojectnature</nature>
+	</natures>
+	<filteredResources>
+		<filter>
+			<id>1778483172220</id>
+			<name></name>
+			<type>30</type>
+			<matcher>
+				<id>org.eclipse.core.resources.regexFilterMatcher</id>
+				<arguments>node_modules|\.git|__CREATED_BY_JAVA_LANGUAGE_SERVER__</arguments>
+			</matcher>
+		</filter>
+	</filteredResources>
+</projectDescription>

package/android/src/main/java/expo/modules/gaodemap/map/ExpoGaodeMapModule.kt

@@ -27,6 +27,8 @@ class ExpoGaodeMapModule : Module() {
   /** 定位管理器实例 */
   private var locationManager: LocationManager? = null
 
+  private fun jsValue(value: Any?): Any? = value
+
   override fun definition() = ModuleDefinition {
     Name("ExpoGaodeMap")
 
@@ -93,7 +95,7 @@ class ExpoGaodeMapModule : Module() {
     }
 
     Function("getPrivacyStatus") {
-      SDKInitializer.getPrivacyStatus()
+      jsValue(SDKInitializer.getPrivacyStatus())
     }
 
     /**
@@ -109,14 +111,14 @@ class ExpoGaodeMapModule : Module() {
      * @return SDK 版本号
      */
     Function("getVersion") {
-      SDKInitializer.getVersion()
+      jsValue(SDKInitializer.getVersion())
     }
 
     /**
     * 检查原生 SDK 是否已配置 API Key
     */
     Function("isNativeSDKConfigured") {
-      try {
+      jsValue(try {
         val context = appContext.reactContext!!
         val apiKey = context.packageManager
           .getApplicationInfo(context.packageName, android.content.pm.PackageManager.GET_META_DATA)
@@ -124,7 +126,7 @@ class ExpoGaodeMapModule : Module() {
         !apiKey.isNullOrEmpty()
       } catch (_: Exception) {
         false
-      }
+      })
     }
 
 
@@ -187,11 +189,11 @@ class ExpoGaodeMapModule : Module() {
     Function("distanceBetweenCoordinates") { p1: Map<String, Any>?, p2: Map<String, Any>? ->
       val coord1 = LatLngParser.parseLatLng(p1)
       val coord2 = LatLngParser.parseLatLng(p2)
-      if (coord1 != null && coord2 != null) {
+      jsValue(if (coord1 != null && coord2 != null) {
         GeometryUtils.calculateDistance(coord1, coord2)
       } else {
         0.0
-      }
+      })
     }
 
     /**
@@ -213,16 +215,16 @@ class ExpoGaodeMapModule : Module() {
       val normalized = LatLngParser.parseLatLngList(points)
       val safeMinZoom = minZoom ?: 3
       val safeMaxZoom = maxZoom ?: 20
-      if (normalized.isEmpty()) return@Function safeMinZoom.toDouble()
+      if (normalized.isEmpty()) return@Function jsValue(safeMinZoom.toDouble())
 
-      GeometryUtils.calculateFitZoom(
+      jsValue(GeometryUtils.calculateFitZoom(
         normalized,
         viewportWidthPx ?: 390.0,
         viewportHeightPx ?: 844.0,
         paddingPx ?: 48.0,
         safeMinZoom,
         safeMaxZoom
-      )
+      ))
     }
 
     /**
@@ -232,7 +234,7 @@ class ExpoGaodeMapModule : Module() {
      */
     Function("calculatePolygonArea") { points: List<Any>? ->
       val rings = LatLngParser.parseLatLngListList(points)
-      if (rings.isEmpty()) return@Function 0.0
+      if (rings.isEmpty()) return@Function jsValue(0.0)
       
       // 第一项是外轮廓
       var totalArea = GeometryUtils.calculatePolygonArea(rings[0])
@@ -245,7 +247,7 @@ class ExpoGaodeMapModule : Module() {
       }
       
       // 确保面积不为负数
-      max(0.0, totalArea)
+      jsValue(max(0.0, totalArea))
     }
 
     /**
@@ -255,24 +257,24 @@ class ExpoGaodeMapModule : Module() {
      * @return 是否在多边形内
      */
     Function("isPointInPolygon") { point: Map<String, Any>?, polygon: List<Any>? ->
-      val pt = LatLngParser.parseLatLng(point) ?: return@Function false
+      val pt = LatLngParser.parseLatLng(point) ?: return@Function jsValue(false)
       val rings = LatLngParser.parseLatLngListList(polygon)
-      if (rings.isEmpty()) return@Function false
+      if (rings.isEmpty()) return@Function jsValue(false)
       
       // 点必须在外轮廓内
       val inOuter = GeometryUtils.isPointInPolygon(pt, rings[0])
-      if (!inOuter) return@Function false
+      if (!inOuter) return@Function jsValue(false)
       
       // 点不能在任何内孔内
       if (rings.size > 1) {
         for (i in 1 until rings.size) {
           if (GeometryUtils.isPointInPolygon(pt, rings[i])) {
-            return@Function false
+            return@Function jsValue(false)
           }
         }
       }
       
-      true
+      jsValue(true)
     }
 
     /**
@@ -285,11 +287,11 @@ class ExpoGaodeMapModule : Module() {
     Function("isPointInCircle") { point: Map<String, Any>?, center: Map<String, Any>?, radius: Double ->
       val pt = LatLngParser.parseLatLng(point)
       val cn = LatLngParser.parseLatLng(center)
-      if (pt != null && cn != null) {
+      jsValue(if (pt != null && cn != null) {
         GeometryUtils.isPointInCircle(pt, cn, radius)
       } else {
         false
-      }
+      })
     }
 
     /**
@@ -301,11 +303,11 @@ class ExpoGaodeMapModule : Module() {
     Function("calculateRectangleArea") { southWest: Map<String, Any>?, northEast: Map<String, Any>? ->
       val sw = LatLngParser.parseLatLng(southWest)
       val ne = LatLngParser.parseLatLng(northEast)
-      if (sw != null && ne != null) {
+      jsValue(if (sw != null && ne != null) {
         GeometryUtils.calculateRectangleArea(sw, ne)
       } else {
         0.0
-      }
+      })
     }
 
     /**
@@ -318,7 +320,7 @@ class ExpoGaodeMapModule : Module() {
       val pathPoints = LatLngParser.parseLatLngList(path)
       val targetPoint = LatLngParser.parseLatLng(target)
       
-      if (targetPoint != null && pathPoints.isNotEmpty()) {
+      jsValue(if (targetPoint != null && pathPoints.isNotEmpty()) {
         val result = GeometryUtils.getNearestPointOnPath(pathPoints, targetPoint)
         if (result != null) {
           mapOf(
@@ -332,7 +334,7 @@ class ExpoGaodeMapModule : Module() {
         }
       } else {
         null
-      }
+      })
     }
 
     /**
@@ -342,16 +344,16 @@ class ExpoGaodeMapModule : Module() {
      */
     Function("calculateCentroid") { polygon: List<Any>? ->
       val rings = LatLngParser.parseLatLngListList(polygon)
-      if (rings.isEmpty()) return@Function null
+      if (rings.isEmpty()) return@Function jsValue(null)
       
       if (rings.size == 1) {
         val result = GeometryUtils.calculateCentroid(rings[0])
-        return@Function result?.let {
+        return@Function jsValue(result?.let {
           mapOf(
             "latitude" to it.latitude,
             "longitude" to it.longitude
           )
-        }
+        })
       }
       
       // 带孔多边形的质心计算: Σ(Area_i * Centroid_i) / Σ(Area_i)
@@ -376,14 +378,14 @@ class ExpoGaodeMapModule : Module() {
         }
       }
       
-      if (abs(totalArea) > 1e-9) {
+      jsValue(if (abs(totalArea) > 1e-9) {
         mapOf(
           "latitude" to sumLat / totalArea,
           "longitude" to sumLon / totalArea
         )
       } else {
         null
-      }
+      })
     }
 
     /**
@@ -393,10 +395,10 @@ class ExpoGaodeMapModule : Module() {
      */
     Function("calculatePathBounds") { pointsList: List<Any>? ->
       val points = LatLngParser.parseLatLngList(pointsList)
-      if (points.isEmpty()) return@Function null
+      if (points.isEmpty()) return@Function jsValue(null)
 
       val result = GeometryUtils.calculatePathBounds(points)
-      result?.let {
+      jsValue(result?.let {
         mapOf(
           "north" to it.north,
           "south" to it.south,
@@ -407,7 +409,7 @@ class ExpoGaodeMapModule : Module() {
             "longitude" to it.centerLon
           )
         )
-      }
+      })
     }
 
     /**
@@ -418,11 +420,11 @@ class ExpoGaodeMapModule : Module() {
      */
     Function("encodeGeoHash") { coordinate: Map<String, Any>?, precision: Int ->
       val latLng = LatLngParser.parseLatLng(coordinate)
-      if (latLng != null) {
+      jsValue(if (latLng != null) {
         GeometryUtils.encodeGeoHash(latLng, precision)
       } else {
         ""
-      }
+      })
     }
 
     /**
@@ -434,12 +436,12 @@ class ExpoGaodeMapModule : Module() {
     Function("simplifyPolyline") { points: List<Any>?, tolerance: Double ->
       val poly = LatLngParser.parseLatLngList(points)
       val simplified = GeometryUtils.simplifyPolyline(poly, tolerance)
-      simplified.map {
+      jsValue(simplified.map {
         mapOf(
           "latitude" to it.latitude,
           "longitude" to it.longitude
         )
-      }
+      })
     }
 
     /**
@@ -449,7 +451,7 @@ class ExpoGaodeMapModule : Module() {
      */
     Function("calculatePathLength") { points: List<Any>? ->
       val poly = LatLngParser.parseLatLngList(points)
-      GeometryUtils.calculatePathLength(poly)
+      jsValue(GeometryUtils.calculatePathLength(poly))
     }
 
     /**
@@ -459,12 +461,12 @@ class ExpoGaodeMapModule : Module() {
      */
     Function("parsePolyline") { polylineStr: String? ->
       val result = GeometryUtils.parsePolyline(polylineStr)
-      result.map {
+      jsValue(result.map {
         mapOf(
           "latitude" to it.latitude,
           "longitude" to it.longitude
         )
-      }
+      })
     }
 
     /**
@@ -476,7 +478,7 @@ class ExpoGaodeMapModule : Module() {
     Function("getPointAtDistance") { points: List<Any>?, distance: Double ->
       val poly = LatLngParser.parseLatLngList(points)
       val result = GeometryUtils.getPointAtDistance(poly, distance)
-      if (result != null) {
+      jsValue(if (result != null) {
         mapOf(
           "latitude" to result.point.latitude,
           "longitude" to result.point.longitude,
@@ -484,7 +486,7 @@ class ExpoGaodeMapModule : Module() {
         )
       } else {
         null
-      }
+      })
     }
 
     /**
@@ -495,7 +497,7 @@ class ExpoGaodeMapModule : Module() {
      */
     Function("latLngToTile") { coordinate: Map<String, Any>?, zoom: Int ->
       val latLng = LatLngParser.parseLatLng(coordinate)
-      if (latLng != null) {
+      jsValue(if (latLng != null) {
         val result = GeometryUtils.latLngToTile(latLng, zoom)
         if (result != null && result.size >= 2) {
           mapOf("x" to result[0], "y" to result[1])
@@ -504,7 +506,7 @@ class ExpoGaodeMapModule : Module() {
         }
       } else {
         null
-      }
+      })
     }
 
     /**
@@ -517,9 +519,9 @@ class ExpoGaodeMapModule : Module() {
       val y = (tile?.get("y") as? Number)?.toInt() ?: 0
       val zoom = (tile?.get("z") as? Number)?.toInt() ?: (tile?.get("zoom") as? Number)?.toInt() ?: 0
       val result = GeometryUtils.tileToLatLng(x, y, zoom)
-      result?.let {
+      jsValue(result?.let {
         mapOf("latitude" to it.latitude, "longitude" to it.longitude)
-      }
+      })
     }
 
     /**
@@ -530,7 +532,7 @@ class ExpoGaodeMapModule : Module() {
      */
     Function("latLngToPixel") { coordinate: Map<String, Any>?, zoom: Int ->
       val latLng = LatLngParser.parseLatLng(coordinate)
-      if (latLng != null) {
+      jsValue(if (latLng != null) {
         val result = GeometryUtils.latLngToPixel(latLng, zoom)
         if (result != null && result.size >= 2) {
           mapOf("x" to result[0], "y" to result[1])
@@ -539,7 +541,7 @@ class ExpoGaodeMapModule : Module() {
         }
       } else {
         null
-      }
+      })
     }
 
     /**
@@ -552,9 +554,9 @@ class ExpoGaodeMapModule : Module() {
       val x = (pixel?.get("x") as? Number)?.toDouble() ?: 0.0
       val y = (pixel?.get("y") as? Number)?.toDouble() ?: 0.0
       val result = GeometryUtils.pixelToLatLng(x, y, zoom)
-      result?.let {
+      jsValue(result?.let {
         mapOf("latitude" to it.latitude, "longitude" to it.longitude)
-      }
+      })
     }
 
     /**
@@ -566,11 +568,11 @@ class ExpoGaodeMapModule : Module() {
     Function("findPointInPolygons") { point: Map<String, Any>?, polygons: List<List<Any>>? ->
       val pt = LatLngParser.parseLatLng(point)
       val polys = polygons?.map { LatLngParser.parseLatLngList(it) }
-      if (pt != null && polys != null) {
+      jsValue(if (pt != null && polys != null) {
         GeometryUtils.findPointInPolygons(pt, polys)
       } else {
         -1
-      }
+      })
     }
 
     /**
@@ -579,7 +581,7 @@ class ExpoGaodeMapModule : Module() {
      * @param gridSizeMeters 网格大小（米）
      */
     Function("generateHeatmapGrid") { points: List<Map<String, Any>>?, gridSizeMeters: Double ->
-      if (points == null || points.isEmpty()) return@Function emptyList<Map<String, Any>>()
+      if (points == null || points.isEmpty()) return@Function jsValue(emptyList<Map<String, Any>>())
       
       val count = points.size
       val latitudes = DoubleArray(count)
@@ -593,13 +595,13 @@ class ExpoGaodeMapModule : Module() {
       }
       
       val result = GeometryUtils.generateHeatmapGrid(latitudes, longitudes, weights, gridSizeMeters)
-      result.map {
+      jsValue(result.map {
         mapOf(
           "latitude" to it.latitude,
           "longitude" to it.longitude,
           "intensity" to it.intensity
         )
-      }
+      })
     }
 
     // ==================== 定位配置 ====================