expo-gaode-map 1.0.1 → 1.0.3

package/build/components/overlays/Polyline.d.ts

@@ -1,20 +1,18 @@
 import type { PolylineProps } from '../../types';
 /**
- * 地图折线组件
+ * Polyline 组件用于在高德地图上绘制折线
  *
- * @example
- * ```tsx
- * <MapView>
- *   <Polyline
- *     points={[
- *       { latitude: 39.9, longitude: 116.4 },
- *       { latitude: 39.91, longitude: 116.41 },
- *     ]}
- *     color="#FF0000"
- *     width={5}
- *   />
- * </MapView>
- * ```
+ * @param props - 折线的配置属性
+ * @param props.points - 折线的坐标点数组
+ * @param props.width - 折线的宽度（像素）
+ * @param props.color - 折线的颜色（十六进制或RGBA）
+ * @param [props.texture] - 可选，折线的纹理样式
+ *
+ * @remarks
+ * 组件内部使用 React 的 useEffect 钩子来管理折线的生命周期：
+ * 1. 组件挂载时创建折线并添加到地图
+ * 2. 组件卸载时自动从地图移除折线
+ * 3. 使用 ref 保存折线ID以便清理
  */
 export default function Polyline(props: PolylineProps): null;
 //# sourceMappingURL=Polyline.d.ts.map

package/build/components/overlays/Polyline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Polyline.d.ts","sourceRoot":"","sources":["../../../src/components/overlays/Polyline.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,KAAK,EAAE,aAAa,QAyBpD"}
+{"version":3,"file":"Polyline.d.ts","sourceRoot":"","sources":["../../../src/components/overlays/Polyline.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,KAAK,EAAE,aAAa,QAuCpD"}

package/build/components/overlays/Polyline.js

@@ -1,49 +1,48 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-13 15:01:30
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-15 01:08:27
- * @FilePath     : /expo-gaode-map/src/components/overlays/Polyline.tsx
- * @Description  : 地图折线组件 - 使用命令式 API
- *
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved.
- */
 import * as React from 'react';
 import { MapContext } from '../../ExpoGaodeMapView';
 /**
- * 地图折线组件
+ * Polyline 组件用于在高德地图上绘制折线
  *
- * @example
- * ```tsx
- * <MapView>
- *   <Polyline
- *     points={[
- *       { latitude: 39.9, longitude: 116.4 },
- *       { latitude: 39.91, longitude: 116.41 },
- *     ]}
- *     color="#FF0000"
- *     width={5}
- *   />
- * </MapView>
- * ```
+ * @param props - 折线的配置属性
+ * @param props.points - 折线的坐标点数组
+ * @param props.width - 折线的宽度（像素）
+ * @param props.color - 折线的颜色（十六进制或RGBA）
+ * @param [props.texture] - 可选，折线的纹理样式
+ *
+ * @remarks
+ * 组件内部使用 React 的 useEffect 钩子来管理折线的生命周期：
+ * 1. 组件挂载时创建折线并添加到地图
+ * 2. 组件卸载时自动从地图移除折线
+ * 3. 使用 ref 保存折线ID以便清理
  */
 export default function Polyline(props) {
     const mapRef = React.useContext(MapContext);
     const polylineIdRef = React.useRef(null);
-    // 添加折线
+    const propsRef = React.useRef(props);
+    React.useEffect(() => {
+        propsRef.current = props;
+    }, [props]);
     React.useEffect(() => {
-        const polylineId = `polyline_${Date.now()}_${Math.random()}`;
-        polylineIdRef.current = polylineId;
-        // 只传递必要的属性
-        const polylineProps = {
-            points: props.points,
-            width: props.width,
-            color: props.color,
-            ...(props.texture && { texture: props.texture }),
+        const checkAndAdd = () => {
+            if (!mapRef?.current) {
+                setTimeout(checkAndAdd, 50);
+                return;
+            }
+            const polylineId = `polyline_${Date.now()}_${Math.random()}`;
+            polylineIdRef.current = polylineId;
+            const polylineProps = {
+                points: propsRef.current.points,
+                width: propsRef.current.width,
+                color: propsRef.current.color,
+                ...(propsRef.current.texture && { texture: propsRef.current.texture }),
+            };
+            mapRef.current.addPolyline(polylineId, polylineProps);
         };
-        mapRef?.current?.addPolyline?.(polylineId, polylineProps);
+        checkAndAdd();
         return () => {
-            mapRef?.current?.removePolyline?.(polylineId);
+            if (polylineIdRef.current && mapRef?.current) {
+                mapRef.current.removePolyline(polylineIdRef.current);
+            }
         };
     }, []);
     return null;

package/build/components/overlays/Polyline.js.map

@@ -1 +1 @@
-{"version":3,"file":"Polyline.js","sourceRoot":"","sources":["../../../src/components/overlays/Polyline.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,KAAoB;IACnD,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAgB,IAAI,CAAC,CAAC;IAExD,OAAO;IACP,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,MAAM,UAAU,GAAG,YAAY,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QAC7D,aAAa,CAAC,OAAO,GAAG,UAAU,CAAC;QAEnC,WAAW;QACX,MAAM,aAAa,GAAG;YACpB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;SACjD,CAAC;QAEF,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QAE1D,OAAO,GAAG,EAAE;YACV,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,UAAU,CAAC,CAAC;QAChD,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["/*\n * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @Date         : 2025-11-13 15:01:30\n * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @LastEditTime : 2025-11-15 01:08:27\n * @FilePath     : /expo-gaode-map/src/components/overlays/Polyline.tsx\n * @Description  : 地图折线组件 - 使用命令式 API\n * \n * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. \n */\n\nimport * as React from 'react';\nimport { MapContext } from '../../ExpoGaodeMapView';\nimport type { PolylineProps } from '../../types';\n\n/**\n * 地图折线组件\n * \n * @example\n * ```tsx\n * <MapView>\n *   <Polyline\n *     points={[\n *       { latitude: 39.9, longitude: 116.4 },\n *       { latitude: 39.91, longitude: 116.41 },\n *     ]}\n *     color=\"#FF0000\"\n *     width={5}\n *   />\n * </MapView>\n * ```\n */\nexport default function Polyline(props: PolylineProps) {\n  const mapRef = React.useContext(MapContext);\n  const polylineIdRef = React.useRef<string | null>(null);\n\n  // 添加折线\n  React.useEffect(() => {\n    const polylineId = `polyline_${Date.now()}_${Math.random()}`;\n    polylineIdRef.current = polylineId;\n    \n    // 只传递必要的属性\n    const polylineProps = {\n      points: props.points,\n      width: props.width,\n      color: props.color,\n      ...(props.texture && { texture: props.texture }),\n    };\n    \n    mapRef?.current?.addPolyline?.(polylineId, polylineProps);\n\n    return () => {\n      mapRef?.current?.removePolyline?.(polylineId);\n    };\n  }, []);\n\n  return null;\n}\n"]}
+{"version":3,"file":"Polyline.js","sourceRoot":"","sources":["../../../src/components/overlays/Polyline.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAIpD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,KAAoB;IACnD,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAgB,IAAI,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAErC,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC;IAC3B,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,MAAM,WAAW,GAAG,GAAG,EAAE;YACvB,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBACrB,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;gBAC5B,OAAO;YACT,CAAC;YAED,MAAM,UAAU,GAAG,YAAY,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7D,aAAa,CAAC,OAAO,GAAG,UAAU,CAAC;YAEnC,MAAM,aAAa,GAAG;gBACpB,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM;gBAC/B,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK;gBAC7B,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK;gBAC7B,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;aACvE,CAAC;YAEF,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QACxD,CAAC,CAAC;QAEF,WAAW,EAAE,CAAC;QAEd,OAAO,GAAG,EAAE;YACV,IAAI,aAAa,CAAC,OAAO,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBAC7C,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YACvD,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["\nimport * as React from 'react';\nimport { MapContext } from '../../ExpoGaodeMapView';\nimport type { PolylineProps } from '../../types';\n\n\n/**\n * Polyline 组件用于在高德地图上绘制折线\n * \n * @param props - 折线的配置属性\n * @param props.points - 折线的坐标点数组\n * @param props.width - 折线的宽度（像素）\n * @param props.color - 折线的颜色（十六进制或RGBA）\n * @param [props.texture] - 可选，折线的纹理样式\n * \n * @remarks\n * 组件内部使用 React 的 useEffect 钩子来管理折线的生命周期：\n * 1. 组件挂载时创建折线并添加到地图\n * 2. 组件卸载时自动从地图移除折线\n * 3. 使用 ref 保存折线ID以便清理\n */\nexport default function Polyline(props: PolylineProps) {\n  const mapRef = React.useContext(MapContext);\n  const polylineIdRef = React.useRef<string | null>(null);\n  const propsRef = React.useRef(props);\n  \n  React.useEffect(() => {\n    propsRef.current = props;\n  }, [props]);\n  \n  React.useEffect(() => {\n    const checkAndAdd = () => {\n      if (!mapRef?.current) {\n        setTimeout(checkAndAdd, 50);\n        return;\n      }\n      \n      const polylineId = `polyline_${Date.now()}_${Math.random()}`;\n      polylineIdRef.current = polylineId;\n      \n      const polylineProps = {\n        points: propsRef.current.points,\n        width: propsRef.current.width,\n        color: propsRef.current.color,\n        ...(propsRef.current.texture && { texture: propsRef.current.texture }),\n      };\n      \n      mapRef.current.addPolyline(polylineId, polylineProps);\n    };\n    \n    checkAndAdd();\n    \n    return () => {\n      if (polylineIdRef.current && mapRef?.current) {\n        mapRef.current.removePolyline(polylineIdRef.current);\n      }\n    };\n  }, []);\n\n  return null;\n}\n"]}

package/build/components/overlays/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/overlays/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/overlays/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/build/components/overlays/index.js

@@ -1,13 +1,3 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-13 15:03:10
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-13 15:03:22
- * @FilePath     : /expo-gaode-map/src/components/overlays/index.ts
- * @Description  : 覆盖物组件统一导出
- *
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved.
- */
 export { default as Marker } from './Marker';
 export { default as Polyline } from './Polyline';
 export { default as Polygon } from './Polygon';

package/build/components/overlays/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/overlays/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC","sourcesContent":["/*\n * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @Date         : 2025-11-13 15:03:10\n * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @LastEditTime : 2025-11-13 15:03:22\n * @FilePath     : /expo-gaode-map/src/components/overlays/index.ts\n * @Description  : 覆盖物组件统一导出\n * \n * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. \n */\n\nexport { default as Marker } from './Marker';\nexport { default as Polyline } from './Polyline';\nexport { default as Polygon } from './Polygon';\nexport { default as Circle } from './Circle';\nexport { default as HeatMap } from './HeatMap';\nexport { default as MultiPoint } from './MultiPoint';\nexport { default as Cluster } from './Cluster';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/overlays/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,WAAW,CAAC","sourcesContent":["export { default as Marker } from './Marker';\nexport { default as Polyline } from './Polyline';\nexport { default as Polygon } from './Polygon';\nexport { default as Circle } from './Circle';\nexport { default as HeatMap } from './HeatMap';\nexport { default as MultiPoint } from './MultiPoint';\nexport { default as Cluster } from './Cluster';\n"]}

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGrE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG5E,OAAO,EACL,OAAO,IAAI,YAAY,EACvB,SAAS,EACT,KAAK,EACL,IAAI,EACJ,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,OAAO,IAAI,eAAe,EAC1B,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAMlE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EACL,MAAM,EACN,QAAQ,EACR,OAAO,EACP,MAAM,EACN,OAAO,EACP,UAAU,EACV,OAAO,GACR,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGrE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG5E,OAAO,EACL,OAAO,IAAI,YAAY,EACvB,SAAS,EACT,KAAK,EACL,IAAI,EACJ,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,OAAO,IAAI,eAAe,EAC1B,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAMlE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EACL,MAAM,EACN,QAAQ,EACR,OAAO,EACP,MAAM,EACN,OAAO,EACP,UAAU,EACV,OAAO,GACR,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC"}

package/build/index.js

@@ -1,13 +1,3 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-13 14:45:15
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-15 02:21:17
- * @FilePath     : /expo-gaode-map/src/index.ts
- * @Description  : 高德地图 Expo Module 主导出文件
- *
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved.
- */
 // 导出类型定义
 export * from './ExpoGaodeMap.types';
 export * from './types';

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,SAAS;AACT,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AAExB,SAAS;AACT,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAErE,YAAY;AACZ,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE5E,SAAS;AACT,OAAO,EACL,OAAO,IAAI,YAAY,EACvB,SAAS,EACT,KAAK,EACL,IAAI,EACJ,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAEhC,WAAW;AACX,OAAO,EACL,OAAO,IAAI,eAAe,EAC1B,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAGnC,6BAA6B;AAC7B,+EAA+E;AAE/E,WAAW;AACX,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGxD,UAAU;AACV,OAAO,EACL,MAAM,EACN,QAAQ,EACR,OAAO,EACP,MAAM,EACN,OAAO,EACP,UAAU,EACV,OAAO,GACR,MAAM,uBAAuB,CAAC;AAE/B,kBAAkB;AAClB,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["/*\n * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @Date         : 2025-11-13 14:45:15\n * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @LastEditTime : 2025-11-15 02:21:17\n * @FilePath     : /expo-gaode-map/src/index.ts\n * @Description  : 高德地图 Expo Module 主导出文件\n * \n * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. \n */\n\n// 导出类型定义\nexport * from './ExpoGaodeMap.types';\nexport * from './types';\n\n// 导出原生模块\nexport { default as ExpoGaodeMapModule } from './ExpoGaodeMapModule';\n\n// 导出 SDK 模块\nexport { default as AMapSDK, initSDK, getVersion } from './modules/AMapSDK';\n\n// 导出定位模块\nexport {\n  default as AMapLocation,\n  configure,\n  start,\n  stop,\n  isStarted,\n  getCurrentLocation,\n  addLocationListener,\n  coordinateConvert,\n  startUpdatingHeading,\n  stopUpdatingHeading,\n} from './modules/AMapLocation';\n\n// 导出权限管理模块\nexport {\n  default as AMapPermissions,\n  checkLocationPermission,\n  requestLocationPermission,\n} from './modules/AMapPermissions';\nexport type { PermissionStatus } from './modules/AMapPermissions';\n\n// 地图视图控制已移至 MapView 的 ref 调用\n// 使用方式: const mapRef = useRef<MapViewRef>(null); mapRef.current.moveCamera() 等\n\n// 导出地图视图组件\nexport { default as MapView } from './ExpoGaodeMapView';\nexport type { MapViewRef } from './ExpoGaodeMapView';\n\n// 导出覆盖物组件\nexport {\n  Marker,\n  Polyline,\n  Polygon,\n  Circle,\n  HeatMap,\n  MultiPoint,\n  Cluster,\n} from './components/overlays';\n\n// 默认导出：直接重新导出所有模块\nexport { default } from './ExpoGaodeMapModule';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,SAAS;AACT,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AAExB,SAAS;AACT,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAErE,YAAY;AACZ,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE5E,SAAS;AACT,OAAO,EACL,OAAO,IAAI,YAAY,EACvB,SAAS,EACT,KAAK,EACL,IAAI,EACJ,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAEhC,WAAW;AACX,OAAO,EACL,OAAO,IAAI,eAAe,EAC1B,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAGnC,6BAA6B;AAC7B,+EAA+E;AAE/E,WAAW;AACX,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGxD,UAAU;AACV,OAAO,EACL,MAAM,EACN,QAAQ,EACR,OAAO,EACP,MAAM,EACN,OAAO,EACP,UAAU,EACV,OAAO,GACR,MAAM,uBAAuB,CAAC;AAE/B,kBAAkB;AAClB,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["// 导出类型定义\nexport * from './ExpoGaodeMap.types';\nexport * from './types';\n\n// 导出原生模块\nexport { default as ExpoGaodeMapModule } from './ExpoGaodeMapModule';\n\n// 导出 SDK 模块\nexport { default as AMapSDK, initSDK, getVersion } from './modules/AMapSDK';\n\n// 导出定位模块\nexport {\n  default as AMapLocation,\n  configure,\n  start,\n  stop,\n  isStarted,\n  getCurrentLocation,\n  addLocationListener,\n  coordinateConvert,\n  startUpdatingHeading,\n  stopUpdatingHeading,\n} from './modules/AMapLocation';\n\n// 导出权限管理模块\nexport {\n  default as AMapPermissions,\n  checkLocationPermission,\n  requestLocationPermission,\n} from './modules/AMapPermissions';\nexport type { PermissionStatus } from './modules/AMapPermissions';\n\n// 地图视图控制已移至 MapView 的 ref 调用\n// 使用方式: const mapRef = useRef<MapViewRef>(null); mapRef.current.moveCamera() 等\n\n// 导出地图视图组件\nexport { default as MapView } from './ExpoGaodeMapView';\nexport type { MapViewRef } from './ExpoGaodeMapView';\n\n// 导出覆盖物组件\nexport {\n  Marker,\n  Polyline,\n  Polygon,\n  Circle,\n  HeatMap,\n  MultiPoint,\n  Cluster,\n} from './components/overlays';\n\n// 默认导出：直接重新导出所有模块\nexport { default } from './ExpoGaodeMapModule';\n"]}

package/build/modules/AMapLocation.d.ts

@@ -1,45 +1,82 @@
 import { EventSubscription } from 'expo-modules-core';
 import type { Coordinates, ReGeocode, LocationOptions, LocationListener, LatLng, CoordinateType } from '../types';
 /**
- * 配置定位选项
+ * 配置高德地图定位服务的各项参数
+ * @param {LocationOptions} options - 定位配置选项对象
+ * @param {boolean} [options.withReGeocode] - 是否返回逆地理编码信息
+ * @param {number} [options.accuracy] - 定位精度设置
+ * @param {string} [options.mode] - 定位模式
+ * @param {boolean} [options.onceLocation] - 是否单次定位
+ * @param {number} [options.interval] - 定位间隔(毫秒)
+ * @param {number} [options.timeout] - 定位超时时间(毫秒)
+ * @param {number} [options.reGeocodeTimeout] - 逆地理编码超时时间(毫秒)
+ * @param {number} [options.distanceFilter] - 位置更新最小距离(米)
+ * @param {boolean} [options.sensorEnable] - 是否启用传感器
+ * @param {boolean} [options.wifiScan] - 是否开启WiFi扫描
+ * @param {boolean} [options.gpsFirst] - 是否优先使用GPS
+ * @param {boolean} [options.onceLocationLatest] - 是否获取最近3秒内最精确的位置
+ * @param {string} [options.geoLanguage] - 地理编码语言
+ * @param {boolean} [options.allowsBackgroundLocationUpdates] - 是否允许后台定位
+ * @param {boolean} [options.pausesLocationUpdatesAutomatically] - 是否自动暂停定位
+ * @param {boolean} [options.locationCacheEnable] - 是否启用定位缓存
+ * @param {number} [options.httpTimeout] - 网络请求超时时间(毫秒)
+ * @param {string} [options.protocol] - 定位协议
  */
 export declare function configure(options: LocationOptions): void;
 /**
- * 开始连续定位
+ * 启动高德地图模块,开始连续定位
+ * @throws 如果模块未初始化或启动失败时抛出异常
  */
 export declare function start(): void;
 /**
- * 停止定位
+ * 停止高德地图相关功能,停止定位
+ * @returns {void} 无返回值
  */
 export declare function stop(): void;
 /**
- * 是否正在定位
+ * 检查高德地图模块是否已启动,是否正在定位
+ * @returns {Promise<boolean>} 返回一个Promise，解析为布尔值表示模块是否已启动
  */
 export declare function isStarted(): Promise<boolean>;
 /**
- * 获取当前位置（单次定位）
+ * 获取设备当前位置信息,单次定位
+ * @returns {Promise<Coordinates | ReGeocode>} 返回包含坐标或逆地理编码信息的Promise
+ * @throws 如果定位服务不可用或权限被拒绝时抛出错误
  */
 export declare function getCurrentLocation(): Promise<Coordinates | ReGeocode>;
 /**
- * 添加定位监听器
+ * 添加位置更新监听器
+ * @param {LocationListener} listener - 位置更新时的回调函数
+ * @returns {EventSubscription} 事件订阅对象，包含移除监听器的方法
+ * @throws 如果底层模块不可用，返回一个空操作的订阅对象
  */
 export declare function addLocationListener(listener: LocationListener): EventSubscription;
 /**
- * 坐标转换
+ * 将坐标点转换为指定坐标系下的坐标
+ * @param {LatLng} coordinate - 需要转换的原始坐标点
+ * @param {CoordinateType} type - 目标坐标系类型
+ * @returns {Promise<LatLng>} 转换后的坐标点Promise
+ * @throws 如果底层模块不可用，则返回原始坐标
  */
 export declare function coordinateConvert(coordinate: LatLng, type: CoordinateType): Promise<LatLng>;
 /**
- * 开始获取设备朝向
+ * 开始更新设备方向（罗盘朝向）
+ * 调用原生模块方法启动方向更新功能
+ * @throws 如果原生模块未实现此方法会抛出异常
  * @platform ios
  */
 export declare function startUpdatingHeading(): void;
 /**
- * 停止获取设备朝向
+ * 停止更新设备方向（罗盘朝向）
+ * 调用原生模块方法停止监听设备方向变化
+ * @throws 如果原生模块未实现此方法会抛出异常
  * @platform ios
  */
 export declare function stopUpdatingHeading(): void;
 /**
- * 设置 API Key
+ * 设置高德地图的API密钥
+ * @param {string} key - 高德地图的API密钥
+ * @returns {void}
  */
 export declare function setApiKey(key: string): void;
 declare const _default: {

package/build/modules/AMapLocation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AMapLocation.d.ts","sourceRoot":"","sources":["../../src/modules/AMapLocation.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,MAAM,EACN,cAAc,EACf,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAuDxD;AAED;;GAEG;AACH,wBAAgB,KAAK,IAAI,IAAI,CAE5B;AAED;;GAEG;AACH,wBAAgB,IAAI,IAAI,IAAI,CAE3B;AAED;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAElD;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAE3E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,iBAAiB,CAIjF;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE3C;;;;;;;;;;;;;AAED,wBAWE"}
+{"version":3,"file":"AMapLocation.d.ts","sourceRoot":"","sources":["../../src/modules/AMapLocation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,MAAM,EACN,cAAc,EACf,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAuDxD;AAGD;;;GAGG;AACH,wBAAgB,KAAK,IAAI,IAAI,CAE5B;AAGD;;;GAGG;AACH,wBAAgB,IAAI,IAAI,IAAI,CAE3B;AAGD;;;GAGG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAElD;AAGD;;;;GAIG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAE3E;AAGD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,iBAAiB,CAIjF;AAGD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,MAAM,CAAC,CAEjB;AAGD;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAGD;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE3C;;;;;;;;;;;;;AAED,wBAWE"}

package/build/modules/AMapLocation.js

@@ -1,16 +1,26 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-13 14:42:10
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-13 14:42:15
- * @FilePath     : /expo-gaode-map/src/modules/AMapLocation.ts
- * @Description  : 高德地图定位模块
- *
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved.
- */
+//高德地图定位模块
 import ExpoGaodeMapModule from '../ExpoGaodeMapModule';
 /**
- * 配置定位选项
+ * 配置高德地图定位服务的各项参数
+ * @param {LocationOptions} options - 定位配置选项对象
+ * @param {boolean} [options.withReGeocode] - 是否返回逆地理编码信息
+ * @param {number} [options.accuracy] - 定位精度设置
+ * @param {string} [options.mode] - 定位模式
+ * @param {boolean} [options.onceLocation] - 是否单次定位
+ * @param {number} [options.interval] - 定位间隔(毫秒)
+ * @param {number} [options.timeout] - 定位超时时间(毫秒)
+ * @param {number} [options.reGeocodeTimeout] - 逆地理编码超时时间(毫秒)
+ * @param {number} [options.distanceFilter] - 位置更新最小距离(米)
+ * @param {boolean} [options.sensorEnable] - 是否启用传感器
+ * @param {boolean} [options.wifiScan] - 是否开启WiFi扫描
+ * @param {boolean} [options.gpsFirst] - 是否优先使用GPS
+ * @param {boolean} [options.onceLocationLatest] - 是否获取最近3秒内最精确的位置
+ * @param {string} [options.geoLanguage] - 地理编码语言
+ * @param {boolean} [options.allowsBackgroundLocationUpdates] - 是否允许后台定位
+ * @param {boolean} [options.pausesLocationUpdatesAutomatically] - 是否自动暂停定位
+ * @param {boolean} [options.locationCacheEnable] - 是否启用定位缓存
+ * @param {number} [options.httpTimeout] - 网络请求超时时间(毫秒)
+ * @param {string} [options.protocol] - 定位协议
  */
 export function configure(options) {
     if (options.withReGeocode !== undefined) {
@@ -69,31 +79,39 @@ export function configure(options) {
     }
 }
 /**
- * 开始连续定位
+ * 启动高德地图模块,开始连续定位
+ * @throws 如果模块未初始化或启动失败时抛出异常
  */
 export function start() {
     ExpoGaodeMapModule.start?.();
 }
 /**
- * 停止定位
+ * 停止高德地图相关功能,停止定位
+ * @returns {void} 无返回值
  */
 export function stop() {
     ExpoGaodeMapModule.stop?.();
 }
 /**
- * 是否正在定位
+ * 检查高德地图模块是否已启动,是否正在定位
+ * @returns {Promise<boolean>} 返回一个Promise，解析为布尔值表示模块是否已启动
  */
 export async function isStarted() {
     return ExpoGaodeMapModule.isStarted?.() || Promise.resolve(false);
 }
 /**
- * 获取当前位置（单次定位）
+ * 获取设备当前位置信息,单次定位
+ * @returns {Promise<Coordinates | ReGeocode>} 返回包含坐标或逆地理编码信息的Promise
+ * @throws 如果定位服务不可用或权限被拒绝时抛出错误
  */
 export async function getCurrentLocation() {
     return ExpoGaodeMapModule.getCurrentLocation?.();
 }
 /**
- * 添加定位监听器
+ * 添加位置更新监听器
+ * @param {LocationListener} listener - 位置更新时的回调函数
+ * @returns {EventSubscription} 事件订阅对象，包含移除监听器的方法
+ * @throws 如果底层模块不可用，返回一个空操作的订阅对象
  */
 export function addLocationListener(listener) {
     return ExpoGaodeMapModule.addListener?.('onLocationUpdate', listener) || {
@@ -101,27 +119,37 @@ export function addLocationListener(listener) {
     };
 }
 /**
- * 坐标转换
+ * 将坐标点转换为指定坐标系下的坐标
+ * @param {LatLng} coordinate - 需要转换的原始坐标点
+ * @param {CoordinateType} type - 目标坐标系类型
+ * @returns {Promise<LatLng>} 转换后的坐标点Promise
+ * @throws 如果底层模块不可用，则返回原始坐标
  */
 export async function coordinateConvert(coordinate, type) {
     return ExpoGaodeMapModule.coordinateConvert?.(coordinate, type) || Promise.resolve(coordinate);
 }
 /**
- * 开始获取设备朝向
+ * 开始更新设备方向（罗盘朝向）
+ * 调用原生模块方法启动方向更新功能
+ * @throws 如果原生模块未实现此方法会抛出异常
  * @platform ios
  */
 export function startUpdatingHeading() {
     ExpoGaodeMapModule.startUpdatingHeading?.();
 }
 /**
- * 停止获取设备朝向
+ * 停止更新设备方向（罗盘朝向）
+ * 调用原生模块方法停止监听设备方向变化
+ * @throws 如果原生模块未实现此方法会抛出异常
  * @platform ios
  */
 export function stopUpdatingHeading() {
     ExpoGaodeMapModule.stopUpdatingHeading?.();
 }
 /**
- * 设置 API Key
+ * 设置高德地图的API密钥
+ * @param {string} key - 高德地图的API密钥
+ * @returns {void}
  */
 export function setApiKey(key) {
     ExpoGaodeMapModule.setApiKey?.(key);

package/build/modules/AMapLocation.js.map

@@ -1 +1 @@
-{"version":3,"file":"AMapLocation.js","sourceRoot":"","sources":["../../src/modules/AMapLocation.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @Date         : 2025-11-13 14:42:10\n * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @LastEditTime : 2025-11-13 14:42:15\n * @FilePath     : /expo-gaode-map/src/modules/AMapLocation.ts\n * @Description  : 高德地图定位模块\n * \n * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. \n */\n\nimport { EventSubscription } from 'expo-modules-core';\nimport ExpoGaodeMapModule from '../ExpoGaodeMapModule';\nimport type {\n  Coordinates,\n  ReGeocode,\n  LocationOptions,\n  LocationListener,\n  LatLng,\n  CoordinateType,\n} from '../types';\n\n/**\n * 配置定位选项\n */\nexport function configure(options: LocationOptions): void {\n  if (options.withReGeocode !== undefined) {\n    ExpoGaodeMapModule.setLocatingWithReGeocode?.(options.withReGeocode);\n  }\n  if (options.accuracy !== undefined) {\n    ExpoGaodeMapModule.setDesiredAccuracy?.(options.accuracy);\n  }\n  if (options.mode !== undefined) {\n    ExpoGaodeMapModule.setLocationMode?.(options.mode);\n  }\n  if (options.onceLocation !== undefined) {\n    ExpoGaodeMapModule.setOnceLocation?.(options.onceLocation);\n  }\n  if (options.interval !== undefined) {\n    ExpoGaodeMapModule.setInterval?.(options.interval);\n  }\n  if (options.timeout !== undefined) {\n    ExpoGaodeMapModule.setLocationTimeout?.(options.timeout);\n  }\n  if (options.reGeocodeTimeout !== undefined) {\n    ExpoGaodeMapModule.setReGeocodeTimeout?.(options.reGeocodeTimeout);\n  }\n  if (options.distanceFilter !== undefined) {\n    ExpoGaodeMapModule.setDistanceFilter?.(options.distanceFilter);\n  }\n  if (options.sensorEnable !== undefined) {\n    ExpoGaodeMapModule.setSensorEnable?.(options.sensorEnable);\n  }\n  if (options.wifiScan !== undefined) {\n    ExpoGaodeMapModule.setWifiScan?.(options.wifiScan);\n  }\n  if (options.gpsFirst !== undefined) {\n    ExpoGaodeMapModule.setGpsFirst?.(options.gpsFirst);\n  }\n  if (options.onceLocationLatest !== undefined) {\n    ExpoGaodeMapModule.setOnceLocationLatest?.(options.onceLocationLatest);\n  }\n  if (options.geoLanguage !== undefined) {\n    ExpoGaodeMapModule.setGeoLanguage?.(options.geoLanguage);\n  }\n  if (options.allowsBackgroundLocationUpdates !== undefined) {\n    ExpoGaodeMapModule.setAllowsBackgroundLocationUpdates?.(options.allowsBackgroundLocationUpdates);\n  }\n  if (options.pausesLocationUpdatesAutomatically !== undefined) {\n    ExpoGaodeMapModule.setPausesLocationUpdatesAutomatically?.(options.pausesLocationUpdatesAutomatically);\n  }\n  if (options.locationCacheEnable !== undefined) {\n    ExpoGaodeMapModule.setLocationCacheEnable?.(options.locationCacheEnable);\n  }\n  if (options.httpTimeout !== undefined) {\n    ExpoGaodeMapModule.setHttpTimeOut?.(options.httpTimeout);\n  }\n  if (options.protocol !== undefined) {\n    ExpoGaodeMapModule.setLocationProtocol?.(options.protocol);\n  }\n}\n\n/**\n * 开始连续定位\n */\nexport function start(): void {\n  ExpoGaodeMapModule.start?.();\n}\n\n/**\n * 停止定位\n */\nexport function stop(): void {\n  ExpoGaodeMapModule.stop?.();\n}\n\n/**\n * 是否正在定位\n */\nexport async function isStarted(): Promise<boolean> {\n  return ExpoGaodeMapModule.isStarted?.() || Promise.resolve(false);\n}\n\n/**\n * 获取当前位置（单次定位）\n */\nexport async function getCurrentLocation(): Promise<Coordinates | ReGeocode> {\n  return ExpoGaodeMapModule.getCurrentLocation?.();\n}\n\n/**\n * 添加定位监听器\n */\nexport function addLocationListener(listener: LocationListener): EventSubscription {\n  return ExpoGaodeMapModule.addListener?.('onLocationUpdate', listener) || {\n    remove: () => {},\n  } as EventSubscription;\n}\n\n/**\n * 坐标转换\n */\nexport async function coordinateConvert(\n  coordinate: LatLng,\n  type: CoordinateType\n): Promise<LatLng> {\n  return ExpoGaodeMapModule.coordinateConvert?.(coordinate, type) || Promise.resolve(coordinate);\n}\n\n/**\n * 开始获取设备朝向\n * @platform ios\n */\nexport function startUpdatingHeading(): void {\n  ExpoGaodeMapModule.startUpdatingHeading?.();\n}\n\n/**\n * 停止获取设备朝向\n * @platform ios\n */\nexport function stopUpdatingHeading(): void {\n  ExpoGaodeMapModule.stopUpdatingHeading?.();\n}\n\n/**\n * 设置 API Key\n */\nexport function setApiKey(key: string): void {\n  ExpoGaodeMapModule.setApiKey?.(key);\n}\n\nexport default {\n  configure,\n  start,\n  stop,\n  isStarted,\n  getCurrentLocation,\n  addLocationListener,\n  coordinateConvert,\n  startUpdatingHeading,\n  stopUpdatingHeading,\n  setApiKey,\n};\n"]}
+{"version":3,"file":"AMapLocation.js","sourceRoot":"","sources":["../../src/modules/AMapLocation.ts"],"names":[],"mappings":"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","sourcesContent":["//高德地图定位模块\n\nimport { EventSubscription } from 'expo-modules-core';\nimport ExpoGaodeMapModule from '../ExpoGaodeMapModule';\nimport type {\n  Coordinates,\n  ReGeocode,\n  LocationOptions,\n  LocationListener,\n  LatLng,\n  CoordinateType,\n} from '../types';\n\n/**\n * 配置高德地图定位服务的各项参数\n * @param {LocationOptions} options - 定位配置选项对象\n * @param {boolean} [options.withReGeocode] - 是否返回逆地理编码信息\n * @param {number} [options.accuracy] - 定位精度设置\n * @param {string} [options.mode] - 定位模式\n * @param {boolean} [options.onceLocation] - 是否单次定位\n * @param {number} [options.interval] - 定位间隔(毫秒)\n * @param {number} [options.timeout] - 定位超时时间(毫秒)\n * @param {number} [options.reGeocodeTimeout] - 逆地理编码超时时间(毫秒)\n * @param {number} [options.distanceFilter] - 位置更新最小距离(米)\n * @param {boolean} [options.sensorEnable] - 是否启用传感器\n * @param {boolean} [options.wifiScan] - 是否开启WiFi扫描\n * @param {boolean} [options.gpsFirst] - 是否优先使用GPS\n * @param {boolean} [options.onceLocationLatest] - 是否获取最近3秒内最精确的位置\n * @param {string} [options.geoLanguage] - 地理编码语言\n * @param {boolean} [options.allowsBackgroundLocationUpdates] - 是否允许后台定位\n * @param {boolean} [options.pausesLocationUpdatesAutomatically] - 是否自动暂停定位\n * @param {boolean} [options.locationCacheEnable] - 是否启用定位缓存\n * @param {number} [options.httpTimeout] - 网络请求超时时间(毫秒)\n * @param {string} [options.protocol] - 定位协议\n */\nexport function configure(options: LocationOptions): void {\n  if (options.withReGeocode !== undefined) {\n    ExpoGaodeMapModule.setLocatingWithReGeocode?.(options.withReGeocode);\n  }\n  if (options.accuracy !== undefined) {\n    ExpoGaodeMapModule.setDesiredAccuracy?.(options.accuracy);\n  }\n  if (options.mode !== undefined) {\n    ExpoGaodeMapModule.setLocationMode?.(options.mode);\n  }\n  if (options.onceLocation !== undefined) {\n    ExpoGaodeMapModule.setOnceLocation?.(options.onceLocation);\n  }\n  if (options.interval !== undefined) {\n    ExpoGaodeMapModule.setInterval?.(options.interval);\n  }\n  if (options.timeout !== undefined) {\n    ExpoGaodeMapModule.setLocationTimeout?.(options.timeout);\n  }\n  if (options.reGeocodeTimeout !== undefined) {\n    ExpoGaodeMapModule.setReGeocodeTimeout?.(options.reGeocodeTimeout);\n  }\n  if (options.distanceFilter !== undefined) {\n    ExpoGaodeMapModule.setDistanceFilter?.(options.distanceFilter);\n  }\n  if (options.sensorEnable !== undefined) {\n    ExpoGaodeMapModule.setSensorEnable?.(options.sensorEnable);\n  }\n  if (options.wifiScan !== undefined) {\n    ExpoGaodeMapModule.setWifiScan?.(options.wifiScan);\n  }\n  if (options.gpsFirst !== undefined) {\n    ExpoGaodeMapModule.setGpsFirst?.(options.gpsFirst);\n  }\n  if (options.onceLocationLatest !== undefined) {\n    ExpoGaodeMapModule.setOnceLocationLatest?.(options.onceLocationLatest);\n  }\n  if (options.geoLanguage !== undefined) {\n    ExpoGaodeMapModule.setGeoLanguage?.(options.geoLanguage);\n  }\n  if (options.allowsBackgroundLocationUpdates !== undefined) {\n    ExpoGaodeMapModule.setAllowsBackgroundLocationUpdates?.(options.allowsBackgroundLocationUpdates);\n  }\n  if (options.pausesLocationUpdatesAutomatically !== undefined) {\n    ExpoGaodeMapModule.setPausesLocationUpdatesAutomatically?.(options.pausesLocationUpdatesAutomatically);\n  }\n  if (options.locationCacheEnable !== undefined) {\n    ExpoGaodeMapModule.setLocationCacheEnable?.(options.locationCacheEnable);\n  }\n  if (options.httpTimeout !== undefined) {\n    ExpoGaodeMapModule.setHttpTimeOut?.(options.httpTimeout);\n  }\n  if (options.protocol !== undefined) {\n    ExpoGaodeMapModule.setLocationProtocol?.(options.protocol);\n  }\n}\n\n\n/**\n * 启动高德地图模块,开始连续定位\n * @throws 如果模块未初始化或启动失败时抛出异常\n */\nexport function start(): void {\n  ExpoGaodeMapModule.start?.();\n}\n\n\n/**\n * 停止高德地图相关功能,停止定位\n * @returns {void} 无返回值\n */\nexport function stop(): void {\n  ExpoGaodeMapModule.stop?.();\n}\n\n\n/**\n * 检查高德地图模块是否已启动,是否正在定位\n * @returns {Promise<boolean>} 返回一个Promise，解析为布尔值表示模块是否已启动\n */\nexport async function isStarted(): Promise<boolean> {\n  return ExpoGaodeMapModule.isStarted?.() || Promise.resolve(false);\n}\n\n\n/**\n * 获取设备当前位置信息,单次定位\n * @returns {Promise<Coordinates | ReGeocode>} 返回包含坐标或逆地理编码信息的Promise\n * @throws 如果定位服务不可用或权限被拒绝时抛出错误\n */\nexport async function getCurrentLocation(): Promise<Coordinates | ReGeocode> {\n  return ExpoGaodeMapModule.getCurrentLocation?.();\n}\n\n\n/**\n * 添加位置更新监听器\n * @param {LocationListener} listener - 位置更新时的回调函数\n * @returns {EventSubscription} 事件订阅对象，包含移除监听器的方法\n * @throws 如果底层模块不可用，返回一个空操作的订阅对象\n */\nexport function addLocationListener(listener: LocationListener): EventSubscription {\n  return ExpoGaodeMapModule.addListener?.('onLocationUpdate', listener) || {\n    remove: () => {},\n  } as EventSubscription;\n}\n\n\n/**\n * 将坐标点转换为指定坐标系下的坐标\n * @param {LatLng} coordinate - 需要转换的原始坐标点\n * @param {CoordinateType} type - 目标坐标系类型\n * @returns {Promise<LatLng>} 转换后的坐标点Promise\n * @throws 如果底层模块不可用，则返回原始坐标\n */\nexport async function coordinateConvert(\n  coordinate: LatLng,\n  type: CoordinateType\n): Promise<LatLng> {\n  return ExpoGaodeMapModule.coordinateConvert?.(coordinate, type) || Promise.resolve(coordinate);\n}\n\n\n/**\n * 开始更新设备方向（罗盘朝向）\n * 调用原生模块方法启动方向更新功能\n * @throws 如果原生模块未实现此方法会抛出异常\n * @platform ios\n */\nexport function startUpdatingHeading(): void {\n  ExpoGaodeMapModule.startUpdatingHeading?.();\n}\n\n\n/**\n * 停止更新设备方向（罗盘朝向）\n * 调用原生模块方法停止监听设备方向变化\n * @throws 如果原生模块未实现此方法会抛出异常\n * @platform ios\n */\nexport function stopUpdatingHeading(): void {\n  ExpoGaodeMapModule.stopUpdatingHeading?.();\n}\n\n/**\n * 设置高德地图的API密钥\n * @param {string} key - 高德地图的API密钥\n * @returns {void}\n */\nexport function setApiKey(key: string): void {\n  ExpoGaodeMapModule.setApiKey?.(key);\n}\n\nexport default {\n  configure,\n  start,\n  stop,\n  isStarted,\n  getCurrentLocation,\n  addLocationListener,\n  coordinateConvert,\n  startUpdatingHeading,\n  stopUpdatingHeading,\n  setApiKey,\n};\n"]}

package/build/modules/AMapPermissions.d.ts

@@ -12,11 +12,13 @@ export interface PermissionStatus {
     coarseLocation?: boolean;
 }
 /**
- * 检查位置权限状态
+ * 检查当前应用是否具有位置权限
+ * @returns {Promise<PermissionStatus>} 返回一个Promise，解析为位置权限状态
  */
 export declare function checkLocationPermission(): Promise<PermissionStatus>;
 /**
  * 请求位置权限
+ * @returns {Promise<PermissionStatus>} 返回一个Promise，解析为位置权限状态
  */
 export declare function requestLocationPermission(): Promise<PermissionStatus>;
 declare const _default: {

package/build/modules/AMapPermissions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AMapPermissions.d.ts","sourceRoot":"","sources":["../../src/modules/AMapPermissions.ts"],"names":[],"mappings":"AAgBA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB;IAClB,MAAM,CAAC,EAAE,eAAe,GAAG,YAAY,GAAG,QAAQ,GAAG,kBAAkB,GAAG,qBAAqB,GAAG,SAAS,CAAC;IAC5G,qBAAqB;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qBAAqB;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAEzE;AAED;;GAEG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAE3E;;;;;AAED,wBAGE"}
+{"version":3,"file":"AMapPermissions.d.ts","sourceRoot":"","sources":["../../src/modules/AMapPermissions.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB;IAClB,MAAM,CAAC,EAAE,eAAe,GAAG,YAAY,GAAG,QAAQ,GAAG,kBAAkB,GAAG,qBAAqB,GAAG,SAAS,CAAC;IAC5G,qBAAqB;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qBAAqB;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAEzE;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAE3E;;;;;AAED,wBAGE"}

package/build/modules/AMapPermissions.js

@@ -1,25 +1,17 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-15 02:20:56
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-15 02:20:58
- * @FilePath     : /expo-gaode-map/src/modules/AMapPermissions.ts
- * @Description  :
- *
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved.
- */
 /*
  * 高德地图权限管理模块
  */
 import ExpoGaodeMapModule from '../ExpoGaodeMapModule';
 /**
- * 检查位置权限状态
+ * 检查当前应用是否具有位置权限
+ * @returns {Promise<PermissionStatus>} 返回一个Promise，解析为位置权限状态
  */
 export async function checkLocationPermission() {
     return await ExpoGaodeMapModule.checkLocationPermission();
 }
 /**
  * 请求位置权限
+ * @returns {Promise<PermissionStatus>} 返回一个Promise，解析为位置权限状态
  */
 export async function requestLocationPermission() {
     return await ExpoGaodeMapModule.requestLocationPermission();

package/build/modules/AMapPermissions.js.map

@@ -1 +1 @@
-{"version":3,"file":"AMapPermissions.js","sourceRoot":"","sources":["../../src/modules/AMapPermissions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH;;GAEG;AAEH,OAAO,kBAAkB,MAAM,uBAAuB,CAAC;AAgBvD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAC3C,OAAO,MAAM,kBAAkB,CAAC,uBAAuB,EAAE,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB;IAC7C,OAAO,MAAM,kBAAkB,CAAC,yBAAyB,EAAE,CAAC;AAC9D,CAAC;AAED,eAAe;IACb,uBAAuB;IACvB,yBAAyB;CAC1B,CAAC","sourcesContent":["/*\n * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @Date         : 2025-11-15 02:20:56\n * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @LastEditTime : 2025-11-15 02:20:58\n * @FilePath     : /expo-gaode-map/src/modules/AMapPermissions.ts\n * @Description  : \n * \n * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. \n */\n/*\n * 高德地图权限管理模块\n */\n\nimport ExpoGaodeMapModule from '../ExpoGaodeMapModule';\n\n/**\n * 权限状态\n */\nexport interface PermissionStatus {\n  /** 是否已授权 */\n  granted: boolean;\n  /** iOS 权限状态字符串 */\n  status?: 'notDetermined' | 'restricted' | 'denied' | 'authorizedAlways' | 'authorizedWhenInUse' | 'unknown';\n  /** Android 精确位置权限 */\n  fineLocation?: boolean;\n  /** Android 粗略位置权限 */\n  coarseLocation?: boolean;\n}\n\n/**\n * 检查位置权限状态\n */\nexport async function checkLocationPermission(): Promise<PermissionStatus> {\n  return await ExpoGaodeMapModule.checkLocationPermission();\n}\n\n/**\n * 请求位置权限\n */\nexport async function requestLocationPermission(): Promise<PermissionStatus> {\n  return await ExpoGaodeMapModule.requestLocationPermission();\n}\n\nexport default {\n  checkLocationPermission,\n  requestLocationPermission,\n};"]}
+{"version":3,"file":"AMapPermissions.js","sourceRoot":"","sources":["../../src/modules/AMapPermissions.ts"],"names":[],"mappings":"AACA;;GAEG;AAEH,OAAO,kBAAkB,MAAM,uBAAuB,CAAC;AAgBvD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAC3C,OAAO,MAAM,kBAAkB,CAAC,uBAAuB,EAAE,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB;IAC7C,OAAO,MAAM,kBAAkB,CAAC,yBAAyB,EAAE,CAAC;AAC9D,CAAC;AAED,eAAe;IACb,uBAAuB;IACvB,yBAAyB;CAC1B,CAAC","sourcesContent":["\n/*\n * 高德地图权限管理模块\n */\n\nimport ExpoGaodeMapModule from '../ExpoGaodeMapModule';\n\n/**\n * 权限状态\n */\nexport interface PermissionStatus {\n  /** 是否已授权 */\n  granted: boolean;\n  /** iOS 权限状态字符串 */\n  status?: 'notDetermined' | 'restricted' | 'denied' | 'authorizedAlways' | 'authorizedWhenInUse' | 'unknown';\n  /** Android 精确位置权限 */\n  fineLocation?: boolean;\n  /** Android 粗略位置权限 */\n  coarseLocation?: boolean;\n}\n\n/**\n * 检查当前应用是否具有位置权限\n * @returns {Promise<PermissionStatus>} 返回一个Promise，解析为位置权限状态\n */\nexport async function checkLocationPermission(): Promise<PermissionStatus> {\n  return await ExpoGaodeMapModule.checkLocationPermission();\n}\n\n/**\n * 请求位置权限\n * @returns {Promise<PermissionStatus>} 返回一个Promise，解析为位置权限状态\n */\nexport async function requestLocationPermission(): Promise<PermissionStatus> {\n  return await ExpoGaodeMapModule.requestLocationPermission();\n}\n\nexport default {\n  checkLocationPermission,\n  requestLocationPermission,\n};"]}

package/build/modules/AMapSDK.d.ts

@@ -4,13 +4,14 @@
  */
 import type { SDKConfig } from '../types';
 /**
- * 初始化高德地图 SDK
- * @param config SDK 配置
+ * 初始化高德地图SDK
+ * @param {SDKConfig} config - SDK配置参数
+ * @throws 如果初始化失败会抛出异常
  */
 export declare function initSDK(config: SDKConfig): void;
 /**
- * 获取 SDK 版本号
- * @returns SDK 版本
+ * 获取高德地图SDK的版本号
+ * @returns {Promise<string>} 返回一个Promise，解析为高德地图SDK的版本字符串，如果获取失败则返回'unknown'
  */
 export declare function getVersion(): Promise<string>;
 declare const _default: {

package/build/modules/AMapSDK.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AMapSDK.d.ts","sourceRoot":"","sources":["../../src/modules/AMapSDK.ts"],"names":[],"mappings":"AAUA;;;GAGG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAE/C;AAED;;;GAGG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAElD;;;;;AAED,wBAGE"}
+{"version":3,"file":"AMapSDK.d.ts","sourceRoot":"","sources":["../../src/modules/AMapSDK.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG1C;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAE/C;AAGD;;;GAGG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAElD;;;;;AAED,wBAGE"}

package/build/modules/AMapSDK.js

@@ -1,28 +1,19 @@
-/*
- * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @Date         : 2025-11-13 14:41:55
- * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-14 16:15:20
- * @FilePath     : /expo-gaode-map/src/modules/AMapSDK.ts
- * @Description  :
- *
- * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved.
- */
 /**
  * 高德地图 SDK 模块
  * 基于 Expo Modules 实现
  */
 import ExpoGaodeMapModule from '../ExpoGaodeMapModule';
 /**
- * 初始化高德地图 SDK
- * @param config SDK 配置
+ * 初始化高德地图SDK
+ * @param {SDKConfig} config - SDK配置参数
+ * @throws 如果初始化失败会抛出异常
  */
 export function initSDK(config) {
     ExpoGaodeMapModule.initSDK?.(config);
 }
 /**
- * 获取 SDK 版本号
- * @returns SDK 版本
+ * 获取高德地图SDK的版本号
+ * @returns {Promise<string>} 返回一个Promise，解析为高德地图SDK的版本字符串，如果获取失败则返回'unknown'
  */
 export async function getVersion() {
     return ExpoGaodeMapModule.getVersion?.() || Promise.resolve('unknown');

package/build/modules/AMapSDK.js.map

@@ -1 +1 @@
-{"version":3,"file":"AMapSDK.js","sourceRoot":"","sources":["../../src/modules/AMapSDK.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH;;;GAGG;AAEH,OAAO,kBAAkB,MAAM,uBAAuB,CAAC;AAGvD;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,MAAiB;IACvC,kBAAkB,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,OAAO,kBAAkB,CAAC,UAAU,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AACzE,CAAC;AAED,eAAe;IACb,OAAO;IACP,UAAU;CACX,CAAC","sourcesContent":["/*\n * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @Date         : 2025-11-13 14:41:55\n * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @LastEditTime : 2025-11-14 16:15:20\n * @FilePath     : /expo-gaode-map/src/modules/AMapSDK.ts\n * @Description  : \n * \n * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. \n */\n/**\n * 高德地图 SDK 模块\n * 基于 Expo Modules 实现\n */\n\nimport ExpoGaodeMapModule from '../ExpoGaodeMapModule';\nimport type { SDKConfig } from '../types';\n\n/**\n * 初始化高德地图 SDK\n * @param config SDK 配置\n */\nexport function initSDK(config: SDKConfig): void {\n  ExpoGaodeMapModule.initSDK?.(config);\n}\n\n/**\n * 获取 SDK 版本号\n * @returns SDK 版本\n */\nexport async function getVersion(): Promise<string> {\n  return ExpoGaodeMapModule.getVersion?.() || Promise.resolve('unknown');\n}\n\nexport default {\n  initSDK,\n  getVersion,\n};\n"]}
+{"version":3,"file":"AMapSDK.js","sourceRoot":"","sources":["../../src/modules/AMapSDK.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,kBAAkB,MAAM,uBAAuB,CAAC;AAIvD;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,MAAiB;IACvC,kBAAkB,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC;AAGD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,OAAO,kBAAkB,CAAC,UAAU,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AACzE,CAAC;AAED,eAAe;IACb,OAAO;IACP,UAAU;CACX,CAAC","sourcesContent":["/**\n * 高德地图 SDK 模块\n * 基于 Expo Modules 实现\n */\n\nimport ExpoGaodeMapModule from '../ExpoGaodeMapModule';\nimport type { SDKConfig } from '../types';\n\n\n/**\n * 初始化高德地图SDK\n * @param {SDKConfig} config - SDK配置参数\n * @throws 如果初始化失败会抛出异常\n */\nexport function initSDK(config: SDKConfig): void {\n  ExpoGaodeMapModule.initSDK?.(config);\n}\n\n\n/**\n * 获取高德地图SDK的版本号\n * @returns {Promise<string>} 返回一个Promise，解析为高德地图SDK的版本字符串，如果获取失败则返回'unknown'\n */\nexport async function getVersion(): Promise<string> {\n  return ExpoGaodeMapModule.getVersion?.() || Promise.resolve('unknown');\n}\n\nexport default {\n  initSDK,\n  getVersion,\n};\n"]}

package/build/modules/AMapView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AMapView.d.ts","sourceRoot":"","sources":["../../src/modules/AMapView.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAE9D;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,cAAc,EAAE,cAAc,EAAE,QAAQ,SAAI,GAAG,IAAI,CAE7E;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,UAAO,GAAG,IAAI,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,UAAO,GAAG,IAAI,CAE3D;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC,CAKjE;;;;;;;;AAED,wBAME"}
+{"version":3,"file":"AMapView.d.ts","sourceRoot":"","sources":["../../src/modules/AMapView.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAE9D;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,cAAc,EAAE,cAAc,EAAE,QAAQ,SAAI,GAAG,IAAI,CAE7E;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,UAAO,GAAG,IAAI,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,UAAO,GAAG,IAAI,CAE3D;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC,CAKjE;;;;;;;;AAED,wBAME"}