expo-gaode-map-navigation 2.0.3 → 2.0.4-next.0

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

@@ -1 +1 @@
-{"version":3,"file":"Polygon.js","sourceRoot":"","sources":["../../../../src/map/components/overlays/Polygon.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,MAAM,iBAAiB,GAAG,wBAAwB,CAAe,aAAa,CAAC,CAAC;AAEhF;;;;;GAKG;AACH,SAAS,OAAO,CAAC,KAAmB;IAClC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,GAAG,KAAK,CAAC;IACvC,UAAU;IACV,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAErD,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,gBAAgB,CAAC,CAAC,IAAI,SAAS,CAAC,EAAG,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,SAAuB,EAAE,SAAuB;IACrE,uBAAuB;IACvB,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,SAAS;IACT,IAAI,SAAS,CAAC,WAAW,KAAK,SAAS,CAAC,WAAW;QAC/C,SAAS,CAAC,WAAW,KAAK,SAAS,CAAC,WAAW;QAC/C,SAAS,CAAC,SAAS,KAAK,SAAS,CAAC,SAAS;QAC3C,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM;QACrC,SAAS,CAAC,uBAAuB,KAAK,SAAS,CAAC,uBAAuB,EAAE,CAAC;QAC5E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO;IACP,IAAI,SAAS,CAAC,cAAc,KAAK,SAAS,CAAC,cAAc;QACrD,SAAS,CAAC,mBAAmB,KAAK,SAAS,CAAC,mBAAmB,EAAE,CAAC;QACpE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,WAAW;AACX,eAAe,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC","sourcesContent":["import * as React from 'react';\nimport type { PolygonProps } from '../../types';\nimport { normalizeLatLngList } from '../../utils/GeoUtils';\n\nimport { requireNativeViewManager } from 'expo-modules-core';\nconst NativePolygonView = requireNativeViewManager<PolygonProps>('PolygonView');\n\n/**\n * 渲染一个高德地图多边形覆盖物组件\n *\n * @param props - 多边形属性配置，继承自PolygonProps类型\n * @returns 高德地图原生多边形视图组件\n */\nfunction Polygon(props: PolygonProps) {\n  const { points, ...restProps } = props;\n  // 归一化坐标数组\n  const normalizedPoints = normalizeLatLngList(points);\n\n  return <NativePolygonView points={normalizedPoints} {...restProps} />;\n}\n\n/**\n * 🔑 性能优化：浅比较关键属性\n */\nfunction arePropsEqual(prevProps: PolygonProps, nextProps: PolygonProps): boolean {\n  // 比较 points 数组引用（最常变化）\n  if (prevProps.points !== nextProps.points) {\n    return false;\n  }\n  \n  // 比较样式属性\n  if (prevProps.strokeWidth !== nextProps.strokeWidth ||\n      prevProps.strokeColor !== nextProps.strokeColor ||\n      prevProps.fillColor !== nextProps.fillColor ||\n      prevProps.zIndex !== nextProps.zIndex ||\n      prevProps.simplificationTolerance !== nextProps.simplificationTolerance) {\n    return false;\n  }\n  \n  // 比较回调\n  if (prevProps.onPolygonPress !== nextProps.onPolygonPress ||\n      prevProps.onPolygonSimplified !== nextProps.onPolygonSimplified) {\n    return false;\n  }\n  \n  return true;\n}\n\n// 导出优化后的组件\nexport default React.memo(Polygon, arePropsEqual);\n"]}
+{"version":3,"file":"Polygon.js","sourceRoot":"","sources":["../../../../src/map/components/overlays/Polygon.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAChF,MAAM,oBAAoB,GAAG,2BAA2B,CAAe,aAAa,CAAC,CAAC;AAEtF;;;;;GAKG;AACH,SAAS,OAAO,CAAC,KAAmB;IAClC,MAAM,iBAAiB,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,oBAAoB,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1E,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,GAAG,KAAK,CAAC;IACvC,UAAU;IACV,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAErD,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,gBAAgB,CAAC,CAAC,IAAI,SAAS,CAAC,EAAG,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,SAAuB,EAAE,SAAuB;IACrE,uBAAuB;IACvB,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,SAAS;IACT,IAAI,SAAS,CAAC,WAAW,KAAK,SAAS,CAAC,WAAW;QAC/C,SAAS,CAAC,WAAW,KAAK,SAAS,CAAC,WAAW;QAC/C,SAAS,CAAC,SAAS,KAAK,SAAS,CAAC,SAAS;QAC3C,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM;QACrC,SAAS,CAAC,uBAAuB,KAAK,SAAS,CAAC,uBAAuB,EAAE,CAAC;QAC5E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO;IACP,IAAI,SAAS,CAAC,cAAc,KAAK,SAAS,CAAC,cAAc;QACrD,SAAS,CAAC,mBAAmB,KAAK,SAAS,CAAC,mBAAmB,EAAE,CAAC;QACpE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,WAAW;AACX,eAAe,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC","sourcesContent":["import * as React from 'react';\nimport type { PolygonProps } from '../../types';\nimport { normalizeLatLngList } from '../../utils/GeoUtils';\nimport { createLazyNativeViewManager } from '../../utils/lazyNativeViewManager';\nconst getNativePolygonView = createLazyNativeViewManager<PolygonProps>('PolygonView');\n\n/**\n * 渲染一个高德地图多边形覆盖物组件\n *\n * @param props - 多边形属性配置，继承自PolygonProps类型\n * @returns 高德地图原生多边形视图组件\n */\nfunction Polygon(props: PolygonProps) {\n  const NativePolygonView = React.useMemo(() => getNativePolygonView(), []);\n  const { points, ...restProps } = props;\n  // 归一化坐标数组\n  const normalizedPoints = normalizeLatLngList(points);\n\n  return <NativePolygonView points={normalizedPoints} {...restProps} />;\n}\n\n/**\n * 🔑 性能优化：浅比较关键属性\n */\nfunction arePropsEqual(prevProps: PolygonProps, nextProps: PolygonProps): boolean {\n  // 比较 points 数组引用（最常变化）\n  if (prevProps.points !== nextProps.points) {\n    return false;\n  }\n  \n  // 比较样式属性\n  if (prevProps.strokeWidth !== nextProps.strokeWidth ||\n      prevProps.strokeColor !== nextProps.strokeColor ||\n      prevProps.fillColor !== nextProps.fillColor ||\n      prevProps.zIndex !== nextProps.zIndex ||\n      prevProps.simplificationTolerance !== nextProps.simplificationTolerance) {\n    return false;\n  }\n  \n  // 比较回调\n  if (prevProps.onPolygonPress !== nextProps.onPolygonPress ||\n      prevProps.onPolygonSimplified !== nextProps.onPolygonSimplified) {\n    return false;\n  }\n  \n  return true;\n}\n\n// 导出优化后的组件\nexport default React.memo(Polygon, arePropsEqual);\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"Polyline.d.ts","sourceRoot":"","sources":["../../../../src/map/components/overlays/Polyline.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD;;;;;GAKG;AACH,iBAAS,QAAQ,CAAC,KAAK,EAAE,aAAa,qBAMrC;;AAqCD,wBAAmD"}
+{"version":3,"file":"Polyline.d.ts","sourceRoot":"","sources":["../../../../src/map/components/overlays/Polyline.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD;;;;;GAKG;AACH,iBAAS,QAAQ,CAAC,KAAK,EAAE,aAAa,qBAOrC;;AAqCD,wBAAmD"}

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

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { normalizeLatLngList } from '../../utils/GeoUtils';
-import { requireNativeViewManager } from 'expo-modules-core';
-const NativePolylineView = requireNativeViewManager('PolylineView');
+import { createLazyNativeViewManager } from '../../utils/lazyNativeViewManager';
+const getNativePolylineView = createLazyNativeViewManager('PolylineView');
 /**
  * 渲染高德地图上的折线覆盖物组件
  *
@@ -9,6 +9,7 @@ const NativePolylineView = requireNativeViewManager('PolylineView');
  * @returns 高德地图原生折线视图组件
  */
 function Polyline(props) {
+    const NativePolylineView = React.useMemo(() => getNativePolylineView(), []);
     const { points, ...restProps } = props;
     // 归一化坐标数组
     const normalizedPoints = normalizeLatLngList(points);

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

@@ -1 +1 @@
-{"version":3,"file":"Polyline.js","sourceRoot":"","sources":["../../../../src/map/components/overlays/Polyline.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,MAAM,kBAAkB,GAAG,wBAAwB,CAAgB,cAAc,CAAC,CAAC;AAEnF;;;;;GAKG;AACH,SAAS,QAAQ,CAAC,KAAoB;IACpC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,GAAG,KAAK,CAAC;IACvC,UAAU;IACV,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAErD,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,gBAAgB,CAAC,CAAC,IAAI,SAAS,CAAC,EAAG,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,SAAwB,EAAE,SAAwB;IACvE,uBAAuB;IACvB,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,SAAS;IACT,IAAI,SAAS,CAAC,WAAW,KAAK,SAAS,CAAC,WAAW;QAC/C,SAAS,CAAC,WAAW,KAAK,SAAS,CAAC,WAAW;QAC/C,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM;QACrC,SAAS,CAAC,QAAQ,KAAK,SAAS,CAAC,QAAQ;QACzC,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM;QACrC,SAAS,CAAC,QAAQ,KAAK,SAAS,CAAC,QAAQ;QACzC,SAAS,CAAC,uBAAuB,KAAK,SAAS,CAAC,uBAAuB;QACvE,SAAS,CAAC,OAAO,KAAK,SAAS,CAAC,OAAO,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,eAAe;IACf,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO;IACP,IAAI,SAAS,CAAC,eAAe,KAAK,SAAS,CAAC,eAAe,EAAE,CAAC;QAC5D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,WAAW;AACX,eAAe,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC","sourcesContent":["import * as React from 'react';\nimport type { PolylineProps } from '../../types';\nimport { normalizeLatLngList } from '../../utils/GeoUtils';\n\nimport { requireNativeViewManager } from 'expo-modules-core';\nconst NativePolylineView = requireNativeViewManager<PolylineProps>('PolylineView');\n\n/**\n * 渲染高德地图上的折线覆盖物组件\n *\n * @param props - 折线属性配置，继承自PolylineProps类型\n * @returns 高德地图原生折线视图组件\n */\nfunction Polyline(props: PolylineProps) {\n  const { points, ...restProps } = props;\n  // 归一化坐标数组\n  const normalizedPoints = normalizeLatLngList(points);\n  \n  return <NativePolylineView points={normalizedPoints} {...restProps} />;\n}\n\n/**\n * 🔑 性能优化：浅比较关键属性\n */\nfunction arePropsEqual(prevProps: PolylineProps, nextProps: PolylineProps): boolean {\n  // 比较 points 数组引用（最常变化）\n  if (prevProps.points !== nextProps.points) {\n    return false;\n  }\n  \n  // 比较样式属性\n  if (prevProps.strokeWidth !== nextProps.strokeWidth ||\n      prevProps.strokeColor !== nextProps.strokeColor ||\n      prevProps.zIndex !== nextProps.zIndex ||\n      prevProps.geodesic !== nextProps.geodesic ||\n      prevProps.dotted !== nextProps.dotted ||\n      prevProps.gradient !== nextProps.gradient ||\n      prevProps.simplificationTolerance !== nextProps.simplificationTolerance ||\n      prevProps.texture !== nextProps.texture) {\n    return false;\n  }\n\n  // 比较 colors 数组\n  if (prevProps.colors !== nextProps.colors) {\n    return false;\n  }\n  \n  // 比较回调\n  if (prevProps.onPolylinePress !== nextProps.onPolylinePress) {\n    return false;\n  }\n  \n  return true;\n}\n\n// 导出优化后的组件\nexport default React.memo(Polyline, arePropsEqual);\n"]}
+{"version":3,"file":"Polyline.js","sourceRoot":"","sources":["../../../../src/map/components/overlays/Polyline.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAChF,MAAM,qBAAqB,GAAG,2BAA2B,CAAgB,cAAc,CAAC,CAAC;AAEzF;;;;;GAKG;AACH,SAAS,QAAQ,CAAC,KAAoB;IACpC,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,qBAAqB,EAAE,EAAE,EAAE,CAAC,CAAC;IAC5E,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,GAAG,KAAK,CAAC;IACvC,UAAU;IACV,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAErD,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,gBAAgB,CAAC,CAAC,IAAI,SAAS,CAAC,EAAG,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,SAAwB,EAAE,SAAwB;IACvE,uBAAuB;IACvB,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,SAAS;IACT,IAAI,SAAS,CAAC,WAAW,KAAK,SAAS,CAAC,WAAW;QAC/C,SAAS,CAAC,WAAW,KAAK,SAAS,CAAC,WAAW;QAC/C,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM;QACrC,SAAS,CAAC,QAAQ,KAAK,SAAS,CAAC,QAAQ;QACzC,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM;QACrC,SAAS,CAAC,QAAQ,KAAK,SAAS,CAAC,QAAQ;QACzC,SAAS,CAAC,uBAAuB,KAAK,SAAS,CAAC,uBAAuB;QACvE,SAAS,CAAC,OAAO,KAAK,SAAS,CAAC,OAAO,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,eAAe;IACf,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO;IACP,IAAI,SAAS,CAAC,eAAe,KAAK,SAAS,CAAC,eAAe,EAAE,CAAC;QAC5D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,WAAW;AACX,eAAe,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC","sourcesContent":["import * as React from 'react';\nimport type { PolylineProps } from '../../types';\nimport { normalizeLatLngList } from '../../utils/GeoUtils';\nimport { createLazyNativeViewManager } from '../../utils/lazyNativeViewManager';\nconst getNativePolylineView = createLazyNativeViewManager<PolylineProps>('PolylineView');\n\n/**\n * 渲染高德地图上的折线覆盖物组件\n *\n * @param props - 折线属性配置，继承自PolylineProps类型\n * @returns 高德地图原生折线视图组件\n */\nfunction Polyline(props: PolylineProps) {\n  const NativePolylineView = React.useMemo(() => getNativePolylineView(), []);\n  const { points, ...restProps } = props;\n  // 归一化坐标数组\n  const normalizedPoints = normalizeLatLngList(points);\n  \n  return <NativePolylineView points={normalizedPoints} {...restProps} />;\n}\n\n/**\n * 🔑 性能优化：浅比较关键属性\n */\nfunction arePropsEqual(prevProps: PolylineProps, nextProps: PolylineProps): boolean {\n  // 比较 points 数组引用（最常变化）\n  if (prevProps.points !== nextProps.points) {\n    return false;\n  }\n  \n  // 比较样式属性\n  if (prevProps.strokeWidth !== nextProps.strokeWidth ||\n      prevProps.strokeColor !== nextProps.strokeColor ||\n      prevProps.zIndex !== nextProps.zIndex ||\n      prevProps.geodesic !== nextProps.geodesic ||\n      prevProps.dotted !== nextProps.dotted ||\n      prevProps.gradient !== nextProps.gradient ||\n      prevProps.simplificationTolerance !== nextProps.simplificationTolerance ||\n      prevProps.texture !== nextProps.texture) {\n    return false;\n  }\n\n  // 比较 colors 数组\n  if (prevProps.colors !== nextProps.colors) {\n    return false;\n  }\n  \n  // 比较回调\n  if (prevProps.onPolylinePress !== nextProps.onPolylinePress) {\n    return false;\n  }\n  \n  return true;\n}\n\n// 导出优化后的组件\nexport default React.memo(Polyline, arePropsEqual);\n"]}

package/build/map/types/common.types.d.ts

@@ -14,6 +14,12 @@ export interface SDKConfig {
     /** web api key 如果要使用expo-gaode-map-web-api相关的功能，需要配置web api key*/
     webKey?: string;
 }
+export interface PrivacyStatus {
+    hasShow: boolean;
+    hasContainsPrivacy: boolean;
+    hasAgree: boolean;
+    isReady: boolean;
+}
 /**
  * 权限状态（增强版，支持 Android 14+ 和 iOS 17+）
  */

package/build/map/types/common.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.types.d.ts","sourceRoot":"","sources":["../../../src/map/types/common.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,oBAAoB;IACpB,OAAO,EAAE,OAAO,CAAC;IAGjB,qBAAqB;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qBAAqB;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kCAAkC;IAClC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,yBAAyB;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,yBAAyB;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,+BAA+B;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAC;IAG1B,cAAc;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,oBAAY,OAAO;IACjB;;OAEG;IACH,QAAQ,IAAI;IAEZ;;OAEG;IACH,SAAS,IAAI;IAEb;;OAEG;IACH,KAAK,IAAI;IAET;;OAEG;IACH,IAAI,IAAI;IAER;;;OAGG;IACH,GAAG,IAAI;CACR;AAED;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC"}
+{"version":3,"file":"common.types.d.ts","sourceRoot":"","sources":["../../../src/map/types/common.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,oBAAoB;IACpB,OAAO,EAAE,OAAO,CAAC;IAGjB,qBAAqB;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qBAAqB;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kCAAkC;IAClC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,yBAAyB;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,yBAAyB;IACzB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,+BAA+B;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAC;IAG1B,cAAc;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,oBAAY,OAAO;IACjB;;OAEG;IACH,QAAQ,IAAI;IAEZ;;OAEG;IACH,SAAS,IAAI;IAEb;;OAEG;IACH,KAAK,IAAI;IAET;;OAEG;IACH,IAAI,IAAI;IAER;;;OAGG;IACH,GAAG,IAAI;CACR;AAED;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC"}

package/build/map/types/common.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"common.types.js","sourceRoot":"","sources":["../../../src/map/types/common.types.ts"],"names":[],"mappings":"AAuIA;;GAEG;AACH,MAAM,CAAN,IAAY,OA0BX;AA1BD,WAAY,OAAO;IACjB;;OAEG;IACH,6CAAY,CAAA;IAEZ;;OAEG;IACH,+CAAa,CAAA;IAEb;;OAEG;IACH,uCAAS,CAAA;IAET;;OAEG;IACH,qCAAQ,CAAA;IAER;;;OAGG;IACH,mCAAO,CAAA;AACT,CAAC,EA1BW,OAAO,KAAP,OAAO,QA0BlB","sourcesContent":["/**\n * 高德地图通用类型定义\n * 基于 Expo Modules API\n */\nimport { PermissionResponse } from 'expo-modules-core';\n\n/**\n * SDK 配置参数\n */\nexport interface SDKConfig {\n  /** Android 平台的高德地图 API Key */\n  androidKey?: string;\n  /** iOS 平台的高德地图 API Key */\n  iosKey?: string;\n  /** web api key 如果要使用expo-gaode-map-web-api相关的功能，需要配置web api key*/\n  webKey?: string;\n}\n\n/**\n * 权限状态（增强版，支持 Android 14+ 和 iOS 17+）\n */\nexport interface PermissionStatus extends PermissionResponse{\n  /** 是否已授权（前台位置权限） */\n  granted: boolean;\n  \n  // Android 专用字段\n  /** Android 精确位置权限 */\n  fineLocation?: boolean;\n  /** Android 粗略位置权限 */\n  coarseLocation?: boolean;\n  /** Android 后台位置权限（Android 10+） */\n  backgroundLocation?: boolean;\n  /** 是否应显示权限说明（Android） */\n  shouldShowRationale?: boolean;\n  /** 权限是否被永久拒绝（Android） */\n  isPermanentlyDenied?: boolean;\n  /** 是否为 Android 14+（Android） */\n  isAndroid14Plus?: boolean;\n  \n  // 其他字段\n  /** 额外的消息说明 */\n  message?: string;\n}\n\n/**\n * 点坐标（屏幕坐标）\n */\nexport interface Point {\n  x: number;\n  y: number;\n}\n\n/**\n * 地理坐标\n */\nexport interface LatLng {\n  /**\n   * 纬度\n   */\n  latitude: number;\n\n  /**\n   * 经度\n   */\n  longitude: number;\n}\n\n/**\n * 坐标点类型\n * 支持对象格式 { latitude, longitude }\n * 或数组格式 [longitude, latitude] (GeoJSON 标准)\n * 注意：GeoJSON 标准允许数组包含更多元素（如海拔），但本组件只使用前两个\n */\nexport type LatLngPoint = LatLng | [number, number] | number[];\n\n/**\n * 地图标注点（POI）\n */\nexport interface MapPoi {\n  /**\n   * 标注点 ID\n   */\n  id: string;\n\n  /**\n   * 标注点名称\n   */\n  name: string;\n\n  /**\n   * 标注点坐标\n   */\n  position: LatLng;\n}\n\n/**\n * 矩形坐标边界\n */\nexport interface LatLngBounds {\n  /**\n   * 西南坐标\n   */\n  southwest: LatLng;\n\n  /**\n   * 东北坐标\n   */\n  northeast: LatLng;\n}\n\n/**\n * 地图相机位置\n */\nexport interface CameraPosition {\n  /**\n   * 中心坐标\n   */\n  target?: LatLng;\n\n  /**\n   * 缩放级别（3-20）\n   */\n  zoom?: number;\n\n  /**\n   * 朝向、旋转角度（0-360度）\n   */\n  bearing?: number;\n\n  /**\n   * 倾斜角度（0-60度）\n   */\n  tilt?: number;\n}\n\n/**\n * 地图类型\n */\nexport enum MapType {\n  /**\n   * 标准地图\n   */\n  Standard = 0,\n\n  /**\n   * 卫星地图\n   */\n  Satellite = 1,\n\n  /**\n   * 夜间地图\n   */\n  Night = 2,\n\n  /**\n   * 导航地图\n   */\n  Navi = 3,\n\n  /**\n   * 公交地图\n   * @platform android\n   */\n  Bus = 4,\n}\n\n/**\n * 颜色值类型\n * 支持：\n * - 十六进制字符串: '#AARRGGBB' 或 '#RRGGBB'\n * - 数字格式: 0xAARRGGBB (用于 Android)\n */\nexport type ColorValue = string | number;\n"]}
+{"version":3,"file":"common.types.js","sourceRoot":"","sources":["../../../src/map/types/common.types.ts"],"names":[],"mappings":"AA8IA;;GAEG;AACH,MAAM,CAAN,IAAY,OA0BX;AA1BD,WAAY,OAAO;IACjB;;OAEG;IACH,6CAAY,CAAA;IAEZ;;OAEG;IACH,+CAAa,CAAA;IAEb;;OAEG;IACH,uCAAS,CAAA;IAET;;OAEG;IACH,qCAAQ,CAAA;IAER;;;OAGG;IACH,mCAAO,CAAA;AACT,CAAC,EA1BW,OAAO,KAAP,OAAO,QA0BlB","sourcesContent":["/**\n * 高德地图通用类型定义\n * 基于 Expo Modules API\n */\nimport { PermissionResponse } from 'expo-modules-core';\n\n/**\n * SDK 配置参数\n */\nexport interface SDKConfig {\n  /** Android 平台的高德地图 API Key */\n  androidKey?: string;\n  /** iOS 平台的高德地图 API Key */\n  iosKey?: string;\n  /** web api key 如果要使用expo-gaode-map-web-api相关的功能，需要配置web api key*/\n  webKey?: string;\n}\n\nexport interface PrivacyStatus {\n  hasShow: boolean;\n  hasContainsPrivacy: boolean;\n  hasAgree: boolean;\n  isReady: boolean;\n}\n\n/**\n * 权限状态（增强版，支持 Android 14+ 和 iOS 17+）\n */\nexport interface PermissionStatus extends PermissionResponse{\n  /** 是否已授权（前台位置权限） */\n  granted: boolean;\n  \n  // Android 专用字段\n  /** Android 精确位置权限 */\n  fineLocation?: boolean;\n  /** Android 粗略位置权限 */\n  coarseLocation?: boolean;\n  /** Android 后台位置权限（Android 10+） */\n  backgroundLocation?: boolean;\n  /** 是否应显示权限说明（Android） */\n  shouldShowRationale?: boolean;\n  /** 权限是否被永久拒绝（Android） */\n  isPermanentlyDenied?: boolean;\n  /** 是否为 Android 14+（Android） */\n  isAndroid14Plus?: boolean;\n  \n  // 其他字段\n  /** 额外的消息说明 */\n  message?: string;\n}\n\n/**\n * 点坐标（屏幕坐标）\n */\nexport interface Point {\n  x: number;\n  y: number;\n}\n\n/**\n * 地理坐标\n */\nexport interface LatLng {\n  /**\n   * 纬度\n   */\n  latitude: number;\n\n  /**\n   * 经度\n   */\n  longitude: number;\n}\n\n/**\n * 坐标点类型\n * 支持对象格式 { latitude, longitude }\n * 或数组格式 [longitude, latitude] (GeoJSON 标准)\n * 注意：GeoJSON 标准允许数组包含更多元素（如海拔），但本组件只使用前两个\n */\nexport type LatLngPoint = LatLng | [number, number] | number[];\n\n/**\n * 地图标注点（POI）\n */\nexport interface MapPoi {\n  /**\n   * 标注点 ID\n   */\n  id: string;\n\n  /**\n   * 标注点名称\n   */\n  name: string;\n\n  /**\n   * 标注点坐标\n   */\n  position: LatLng;\n}\n\n/**\n * 矩形坐标边界\n */\nexport interface LatLngBounds {\n  /**\n   * 西南坐标\n   */\n  southwest: LatLng;\n\n  /**\n   * 东北坐标\n   */\n  northeast: LatLng;\n}\n\n/**\n * 地图相机位置\n */\nexport interface CameraPosition {\n  /**\n   * 中心坐标\n   */\n  target?: LatLng;\n\n  /**\n   * 缩放级别（3-20）\n   */\n  zoom?: number;\n\n  /**\n   * 朝向、旋转角度（0-360度）\n   */\n  bearing?: number;\n\n  /**\n   * 倾斜角度（0-60度）\n   */\n  tilt?: number;\n}\n\n/**\n * 地图类型\n */\nexport enum MapType {\n  /**\n   * 标准地图\n   */\n  Standard = 0,\n\n  /**\n   * 卫星地图\n   */\n  Satellite = 1,\n\n  /**\n   * 夜间地图\n   */\n  Night = 2,\n\n  /**\n   * 导航地图\n   */\n  Navi = 3,\n\n  /**\n   * 公交地图\n   * @platform android\n   */\n  Bus = 4,\n}\n\n/**\n * 颜色值类型\n * 支持：\n * - 十六进制字符串: '#AARRGGBB' 或 '#RRGGBB'\n * - 数字格式: 0xAARRGGBB (用于 Android)\n */\nexport type ColorValue = string | number;\n"]}

package/build/map/types/native-module.types.d.ts

@@ -2,7 +2,7 @@
  * 高德地图原生模块类型定义
  */
 import type { NativeModule } from 'expo';
-import type { LatLng, SDKConfig, PermissionStatus, LatLngPoint } from './common.types';
+import type { LatLng, PrivacyStatus, SDKConfig, PermissionStatus, LatLngPoint } from './common.types';
 import type { CoordinateType, Coordinates, ReGeocode, LocationMode, LocationAccuracy, LocationListener } from './location.types';
 import type { ExpoGaodeMapModuleEvents } from './map-view.types';
 export interface ExpoGaodeMapModule extends NativeModule<ExpoGaodeMapModuleEvents> {
@@ -20,6 +20,9 @@ export interface ExpoGaodeMapModule extends NativeModule<ExpoGaodeMapModuleEvent
      * @param config SDK 配置参数，包含 Android 和 iOS 的 API Key
      */
     initSDK(config: SDKConfig): void;
+    setPrivacyShow(hasShow: boolean, hasContainsPrivacy: boolean): void;
+    setPrivacyAgree(hasAgree: boolean): void;
+    getPrivacyStatus(): PrivacyStatus;
     /**
      * 设置是否加载世界向量地图（海外地图）
      * 必须在地图初始化之前调用

package/build/map/types/native-module.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native-module.types.d.ts","sourceRoot":"","sources":["../../../src/map/types/native-module.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"native-module.types.d.ts","sourceRoot":"","sources":["../../../src/map/types/native-module.types.ts"],"names":[],"mappings":"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"}

package/build/map/types/native-module.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"native-module.types.js","sourceRoot":"","sources":["../../../src/map/types/native-module.types.ts"],"names":[],"mappings":"AAAA;;GAEG","sourcesContent":["/**\n * 高德地图原生模块类型定义\n */\n\nimport type { NativeModule } from 'expo';\n\nimport type {\n  LatLng,\n  SDKConfig,\n  PermissionStatus,\n  LatLngPoint,\n} from './common.types';\nimport type {\n  CoordinateType,\n  Coordinates,\n  ReGeocode,\n  LocationMode,\n  LocationAccuracy,\n  LocationListener,\n} from './location.types';\nimport type { ExpoGaodeMapModuleEvents } from './map-view.types';\n\nexport interface ExpoGaodeMapModule extends NativeModule<ExpoGaodeMapModuleEvents> {\n  /**\n   * 原生事件订阅方法\n   */\n  addListener<K extends keyof ExpoGaodeMapModuleEvents>(\n    eventName: K,\n    listener: ExpoGaodeMapModuleEvents[K],\n  ): { remove: () => void };\n  addListener(\n    eventName: string,\n    listener: (...args: unknown[]) => void,\n  ): { remove: () => void };\n\n\n  /**\n   * 初始化高德地图 SDK\n   * @param config SDK 配置参数，包含 Android 和 iOS 的 API Key\n   */\n  initSDK(config: SDKConfig): void;\n\n  /**\n   * 设置是否加载世界向量地图（海外地图）\n   * 必须在地图初始化之前调用\n   * 世界地图为高级服务，需要开通相关权限\n   */\n  setLoadWorldVectorMap(enabled: boolean): void;\n\n  /**\n   * 获取高德地图 SDK 版本号\n   * @returns SDK 版本字符串\n   */\n  getVersion(): string;\n\n  /**\n   * 开始连续定位\n   * 启动后会持续接收位置更新，通过 onLocationUpdate 事件回调\n   */\n  start(): void;\n\n  /**\n   * 停止定位\n   * 停止接收位置更新\n   */\n  stop(): void;\n\n  /**\n   * 检查是否正在定位\n   * @returns 是否正在定位\n   */\n  isStarted(): Promise<boolean>;\n\n  /**\n   * 获取当前位置（单次定位）\n   * @returns 位置信息，包含坐标和可选的逆地理编码信息\n   */\n  getCurrentLocation(): Promise<Coordinates | ReGeocode>;\n\n  /**\n   * 坐标转换\n   * 将其他坐标系的坐标转换为高德地图使用的 GCJ-02 坐标系\n   * @param coordinate 需要转换的坐标\n   * @param type 原坐标系类型\n   */\n  coordinateConvert(coordinate: LatLngPoint, type: CoordinateType): Promise<LatLng>;\n\n\n  /**\n   * 设置是否返回逆地理编码信息\n   * @param isReGeocode true: 返回地址信息; false: 只返回坐标\n   */\n  setLocatingWithReGeocode(isReGeocode: boolean): void;\n\n  /**\n   * 设置定位模式（Android）\n   * @param mode 定位模式：高精度/低功耗/仅设备\n   */\n  setLocationMode(mode: LocationMode): void;\n\n  /**\n   * 设置定位间隔（毫秒）\n   * @param interval 定位间隔时间，单位毫秒，默认 2000ms\n   */\n  setInterval(interval: number): void;\n\n  /**\n   * 设置是否单次定位（Android）\n   * @param isOnceLocation true: 单次定位; false: 连续定位\n   */\n  setOnceLocation(isOnceLocation: boolean): void;\n\n  /**\n   * 设置是否使用设备传感器（Android）\n   * @param sensorEnable true: 使用传感器; false: 不使用\n   */\n  setSensorEnable(sensorEnable: boolean): void;\n\n  /**\n   * 设置是否允许 WiFi 扫描（Android）\n   * @param wifiScan true: 允许; false: 不允许\n   */\n  setWifiScan(wifiScan: boolean): void;\n\n  /**\n   * 设置是否 GPS 优先（Android）\n   * @param gpsFirst true: GPS 优先; false: 网络优先\n   */\n  setGpsFirst(gpsFirst: boolean): void;\n\n  /**\n   * 设置是否等待 WiFi 列表刷新（Android）\n   * @param onceLocationLatest true: 等待; false: 不等待\n   */\n  setOnceLocationLatest(onceLocationLatest: boolean): void;\n\n  /**\n   * 设置逆地理编码语言\n   * @param language 语言代码，如 \"zh-CN\", \"en\"\n   */\n  setGeoLanguage(language: string): void;\n\n  /**\n   * 设置是否使用缓存策略（Android）\n   * @param locationCacheEnable true: 使用缓存; false: 不使用\n   */\n  setLocationCacheEnable(locationCacheEnable: boolean): void;\n\n  /**\n   * 设置网络请求超时时间（Android）\n   * @param httpTimeOut 超时时间，单位毫秒\n   */\n  setHttpTimeOut(httpTimeOut: number): void;\n\n  /**\n   * 设置期望的定位精度（iOS）\n   * @param accuracy 精度级别：最佳/10米/100米/1公里/3公里\n   */\n  setDesiredAccuracy(accuracy: LocationAccuracy): void;\n\n  /**\n   * 设置定位超时时间（秒）\n   * @param timeout 超时时间，单位秒，默认 10 秒\n   */\n  setLocationTimeout(timeout: number): void;\n\n  /**\n   * 设置逆地理编码超时时间（秒）\n   * @param timeout 超时时间，单位秒，默认 5 秒\n   */\n  setReGeocodeTimeout(timeout: number): void;\n\n  /**\n   * 设置距离过滤器（米）（iOS）\n   * 只有移动超过指定距离才会更新位置\n   * @param distance 距离阈值，单位米\n   */\n  setDistanceFilter(distance: number): void;\n\n  /**\n   * 设置是否自动暂停位置更新（iOS）\n   * @param pauses true: 自动暂停; false: 不暂停\n   */\n  setPausesLocationUpdatesAutomatically(pauses: boolean): void;\n\n  /**\n   * 设置是否允许后台定位（iOS）\n   * @param allows true: 允许; false: 不允许\n   */\n  setAllowsBackgroundLocationUpdates(allows: boolean): void;\n\n  /**\n   * iOS 是否已启用后台定位配置\n   */\n  readonly isBackgroundLocationEnabled: boolean;\n\n  /**\n   * 设置定位协议\n   * @param protocol 协议类型\n   */\n  setLocationProtocol(protocol: string): void;\n\n  /**\n   * 开始更新设备方向（罗盘朝向）（iOS）\n   */\n  startUpdatingHeading(): void;\n\n  /**\n   * 停止更新设备方向（iOS）\n   */\n  stopUpdatingHeading(): void;\n\n  /**\n   * 检查前台位置权限状态（增强版）\n   * @returns 详细的权限状态信息\n   */\n  checkLocationPermission(): Promise<PermissionStatus>;\n\n  /**\n   * 请求前台位置权限（增强版）\n   * @returns 请求后的权限状态\n   */\n  requestLocationPermission(): Promise<PermissionStatus>;\n\n  /**\n   * 请求后台位置权限（Android 10+、iOS）\n   * 注意：必须在前台权限已授予后才能请求\n   * @returns 请求后的权限状态\n   */\n  requestBackgroundLocationPermission(): Promise<PermissionStatus>;\n\n  /**\n   * 打开应用设置页面\n   * 引导用户手动授予权限（当权限被永久拒绝时使用）\n   */\n  openAppSettings(): void;\n\n  /**\n   * 检查原生 SDK 是否已配置 API Key\n   * @returns 是否已配置\n   */\n  isNativeSDKConfigured(): boolean;\n\n  /**\n   * 添加定位监听器（便捷方法）\n   * 封装原生事件订阅，返回带 remove 的订阅对象\n   */\n  addLocationListener(listener: LocationListener): { remove: () => void };\n\n  /**\n   * 计算两个坐标点之间的距离\n   * @param coordinate1 第一个坐标点\n   * @param coordinate2 第二个坐标点\n   * @returns 两点之间的距离（单位：米）\n   */\n  distanceBetweenCoordinates(coordinate1: LatLngPoint, coordinate2: LatLngPoint): number;\n\n   // ==================== 几何计算 ====================\n\n  /**\n   * 判断点是否在圆内\n   * @param point 要判断的点\n   * @param center 圆心坐标\n   * @param radius 圆半径（单位：米）\n   * @returns 是否在圆内\n   */\n  isPointInCircle(point: LatLngPoint, center: LatLngPoint, radius: number): boolean;\n\n  /**\n   * 判断点是否在多边形内\n   * @param point 要判断的点\n   * @param polygon 多边形的顶点坐标数组，支持嵌套数组（多边形空洞）\n   * @returns 是否在多边形内\n   */\n  isPointInPolygon(point: LatLngPoint, polygon: LatLngPoint[] | LatLngPoint[][]): boolean;\n\n  /**\n   * 计算多边形面积\n   * @param polygon 多边形的顶点坐标数组，支持嵌套数组（多边形空洞，会自动展平计算）\n   * @returns 面积（单位：平方米）\n   */\n  calculatePolygonArea(polygon: LatLngPoint[] | LatLngPoint[][]): number;\n\n  /**\n   * 计算矩形面积\n   * @param southWest 西南角坐标\n   * @param northEast 东北角坐标\n   * @returns 面积（单位：平方米）\n   */\n  calculateRectangleArea(southWest: LatLngPoint, northEast: LatLngPoint): number;\n\n  /**\n   * 获取路径上距离目标点最近的点\n   * @param path 路径点集合\n   * @param target 目标点\n   * @returns 最近点信息，包含坐标、索引和距离\n   */\n  getNearestPointOnPath(path: LatLngPoint[], target: LatLngPoint): {\n    latitude: number;\n    longitude: number;\n    index: number;\n    distanceMeters: number;\n  } | null;\n\n  /**\n   * 计算多边形质心\n   * @param polygon 多边形顶点坐标数组，支持嵌套数组\n   * @returns 质心坐标\n   */\n  calculateCentroid(polygon: LatLngPoint[] | LatLngPoint[][]): LatLng | null;\n\n  /**\n   * 计算路径边界和中心点\n   * @param points 路径点\n   * @returns 边界和中心点\n   */\n  calculatePathBounds(points: LatLngPoint[]): {\n    north: number;\n    south: number;\n    east: number;\n    west: number;\n    center: LatLngPoint;\n  } | null;\n\n  /**\n   * GeoHash 编码\n   * @param coordinate 坐标点\n   * @param precision 精度 (1-12)\n   * @returns GeoHash 字符串\n   */\n  encodeGeoHash(coordinate: LatLngPoint, precision: number): string;\n\n  /**\n   * 轨迹抽稀 (RDP 算法)\n   * @param points 原始轨迹点\n   * @param tolerance 允许误差(米)\n   * @returns 简化后的轨迹点\n   */\n  simplifyPolyline(points: LatLngPoint[], tolerance: number): LatLng[];\n\n  /**\n   * 计算路径总长度\n   * @param points 路径点\n   * @returns 长度(米)\n   */\n  calculatePathLength(points: LatLngPoint[]): number;\n\n  /**\n   * 解析高德地图 API 返回的 Polyline 字符串\n   * 格式: \"lng,lat;lng,lat;...\"\n   * @param polylineStr 高德原始 polyline 字符串，或包含 polyline 属性的对象\n   * @returns 解析后的点集\n   */\n  parsePolyline(polylineStr: string | { polyline: string }): LatLng[];\n\n  /**\n   * 获取路径上指定距离的点\n   * @param points 路径点\n   * @param distance 距离起点的米数\n   * @returns 点信息(坐标+角度)\n   */\n  getPointAtDistance(points: LatLngPoint[], distance: number): {\n    latitude: number;\n    longitude: number;\n    angle: number;\n  } | null;\n\n  /**\n   * 瓦片坐标转换：经纬度 -> 瓦片坐标\n   * @param coordinate 坐标点\n   * @param zoom 缩放级别\n   * @returns 瓦片坐标 (x, y, z)\n   */\n  latLngToTile(coordinate: LatLngPoint, zoom: number): { x: number; y: number; z: number } | null;\n\n  /**\n   * 瓦片坐标转换：瓦片坐标 -> 经纬度\n   * @param tile 瓦片坐标 (x, y, z)\n   * @returns 经纬度\n   */\n  tileToLatLng(tile: { x: number; y: number; z: number }): LatLng | null;\n\n  /**\n   * 像素坐标转换：经纬度 -> 像素坐标\n   * @param coordinate 坐标点\n   * @param zoom 缩放级别\n   * @returns 像素坐标 (x, y)\n   */\n  latLngToPixel(coordinate: LatLngPoint, zoom: number): { x: number; y: number } | null;\n\n  /**\n   * 像素坐标转换：像素坐标 -> 经纬度\n   * @param pixel 像素坐标 (x, y)\n   * @param zoom 缩放级别\n   * @returns 经纬度\n   */\n  pixelToLatLng(pixel: { x: number; y: number }, zoom: number): LatLng | null;\n\n  /**\n   * 批量地理围栏检测\n   * @param point 待检测点\n   * @param polygons 多边形集合 (支持嵌套)\n   * @returns 包含该点的多边形索引，若不在任何多边形内返回 -1\n   */\n  findPointInPolygons(point: LatLngPoint, polygons: LatLngPoint[][] | LatLngPoint[][][]): number;\n\n  /**\n   * 生成热力图网格数据 (C++ 加速)\n   * @param points 点集，包含权重\n   * @param gridSizeMeters 网格大小(米)\n   * @returns 聚合后的网格点\n   */\n  generateHeatmapGrid(\n    points: Array<LatLngPoint & { weight?: number }>,\n    gridSizeMeters: number\n  ): Array<{ latitude: number; longitude: number; intensity: number }>;\n}\n"]}
+{"version":3,"file":"native-module.types.js","sourceRoot":"","sources":["../../../src/map/types/native-module.types.ts"],"names":[],"mappings":"AAAA;;GAEG","sourcesContent":["/**\n * 高德地图原生模块类型定义\n */\n\nimport type { NativeModule } from 'expo';\n\nimport type {\n  LatLng,\n  PrivacyStatus,\n  SDKConfig,\n  PermissionStatus,\n  LatLngPoint,\n} from './common.types';\nimport type {\n  CoordinateType,\n  Coordinates,\n  ReGeocode,\n  LocationMode,\n  LocationAccuracy,\n  LocationListener,\n} from './location.types';\nimport type { ExpoGaodeMapModuleEvents } from './map-view.types';\n\nexport interface ExpoGaodeMapModule extends NativeModule<ExpoGaodeMapModuleEvents> {\n  /**\n   * 原生事件订阅方法\n   */\n  addListener<K extends keyof ExpoGaodeMapModuleEvents>(\n    eventName: K,\n    listener: ExpoGaodeMapModuleEvents[K],\n  ): { remove: () => void };\n  addListener(\n    eventName: string,\n    listener: (...args: unknown[]) => void,\n  ): { remove: () => void };\n\n\n  /**\n   * 初始化高德地图 SDK\n   * @param config SDK 配置参数，包含 Android 和 iOS 的 API Key\n   */\n  initSDK(config: SDKConfig): void;\n\n  setPrivacyShow(hasShow: boolean, hasContainsPrivacy: boolean): void;\n\n  setPrivacyAgree(hasAgree: boolean): void;\n\n  getPrivacyStatus(): PrivacyStatus;\n\n  /**\n   * 设置是否加载世界向量地图（海外地图）\n   * 必须在地图初始化之前调用\n   * 世界地图为高级服务，需要开通相关权限\n   */\n  setLoadWorldVectorMap(enabled: boolean): void;\n\n  /**\n   * 获取高德地图 SDK 版本号\n   * @returns SDK 版本字符串\n   */\n  getVersion(): string;\n\n  /**\n   * 开始连续定位\n   * 启动后会持续接收位置更新，通过 onLocationUpdate 事件回调\n   */\n  start(): void;\n\n  /**\n   * 停止定位\n   * 停止接收位置更新\n   */\n  stop(): void;\n\n  /**\n   * 检查是否正在定位\n   * @returns 是否正在定位\n   */\n  isStarted(): Promise<boolean>;\n\n  /**\n   * 获取当前位置（单次定位）\n   * @returns 位置信息，包含坐标和可选的逆地理编码信息\n   */\n  getCurrentLocation(): Promise<Coordinates | ReGeocode>;\n\n  /**\n   * 坐标转换\n   * 将其他坐标系的坐标转换为高德地图使用的 GCJ-02 坐标系\n   * @param coordinate 需要转换的坐标\n   * @param type 原坐标系类型\n   */\n  coordinateConvert(coordinate: LatLngPoint, type: CoordinateType): Promise<LatLng>;\n\n\n  /**\n   * 设置是否返回逆地理编码信息\n   * @param isReGeocode true: 返回地址信息; false: 只返回坐标\n   */\n  setLocatingWithReGeocode(isReGeocode: boolean): void;\n\n  /**\n   * 设置定位模式（Android）\n   * @param mode 定位模式：高精度/低功耗/仅设备\n   */\n  setLocationMode(mode: LocationMode): void;\n\n  /**\n   * 设置定位间隔（毫秒）\n   * @param interval 定位间隔时间，单位毫秒，默认 2000ms\n   */\n  setInterval(interval: number): void;\n\n  /**\n   * 设置是否单次定位（Android）\n   * @param isOnceLocation true: 单次定位; false: 连续定位\n   */\n  setOnceLocation(isOnceLocation: boolean): void;\n\n  /**\n   * 设置是否使用设备传感器（Android）\n   * @param sensorEnable true: 使用传感器; false: 不使用\n   */\n  setSensorEnable(sensorEnable: boolean): void;\n\n  /**\n   * 设置是否允许 WiFi 扫描（Android）\n   * @param wifiScan true: 允许; false: 不允许\n   */\n  setWifiScan(wifiScan: boolean): void;\n\n  /**\n   * 设置是否 GPS 优先（Android）\n   * @param gpsFirst true: GPS 优先; false: 网络优先\n   */\n  setGpsFirst(gpsFirst: boolean): void;\n\n  /**\n   * 设置是否等待 WiFi 列表刷新（Android）\n   * @param onceLocationLatest true: 等待; false: 不等待\n   */\n  setOnceLocationLatest(onceLocationLatest: boolean): void;\n\n  /**\n   * 设置逆地理编码语言\n   * @param language 语言代码，如 \"zh-CN\", \"en\"\n   */\n  setGeoLanguage(language: string): void;\n\n  /**\n   * 设置是否使用缓存策略（Android）\n   * @param locationCacheEnable true: 使用缓存; false: 不使用\n   */\n  setLocationCacheEnable(locationCacheEnable: boolean): void;\n\n  /**\n   * 设置网络请求超时时间（Android）\n   * @param httpTimeOut 超时时间，单位毫秒\n   */\n  setHttpTimeOut(httpTimeOut: number): void;\n\n  /**\n   * 设置期望的定位精度（iOS）\n   * @param accuracy 精度级别：最佳/10米/100米/1公里/3公里\n   */\n  setDesiredAccuracy(accuracy: LocationAccuracy): void;\n\n  /**\n   * 设置定位超时时间（秒）\n   * @param timeout 超时时间，单位秒，默认 10 秒\n   */\n  setLocationTimeout(timeout: number): void;\n\n  /**\n   * 设置逆地理编码超时时间（秒）\n   * @param timeout 超时时间，单位秒，默认 5 秒\n   */\n  setReGeocodeTimeout(timeout: number): void;\n\n  /**\n   * 设置距离过滤器（米）（iOS）\n   * 只有移动超过指定距离才会更新位置\n   * @param distance 距离阈值，单位米\n   */\n  setDistanceFilter(distance: number): void;\n\n  /**\n   * 设置是否自动暂停位置更新（iOS）\n   * @param pauses true: 自动暂停; false: 不暂停\n   */\n  setPausesLocationUpdatesAutomatically(pauses: boolean): void;\n\n  /**\n   * 设置是否允许后台定位（iOS）\n   * @param allows true: 允许; false: 不允许\n   */\n  setAllowsBackgroundLocationUpdates(allows: boolean): void;\n\n  /**\n   * iOS 是否已启用后台定位配置\n   */\n  readonly isBackgroundLocationEnabled: boolean;\n\n  /**\n   * 设置定位协议\n   * @param protocol 协议类型\n   */\n  setLocationProtocol(protocol: string): void;\n\n  /**\n   * 开始更新设备方向（罗盘朝向）（iOS）\n   */\n  startUpdatingHeading(): void;\n\n  /**\n   * 停止更新设备方向（iOS）\n   */\n  stopUpdatingHeading(): void;\n\n  /**\n   * 检查前台位置权限状态（增强版）\n   * @returns 详细的权限状态信息\n   */\n  checkLocationPermission(): Promise<PermissionStatus>;\n\n  /**\n   * 请求前台位置权限（增强版）\n   * @returns 请求后的权限状态\n   */\n  requestLocationPermission(): Promise<PermissionStatus>;\n\n  /**\n   * 请求后台位置权限（Android 10+、iOS）\n   * 注意：必须在前台权限已授予后才能请求\n   * @returns 请求后的权限状态\n   */\n  requestBackgroundLocationPermission(): Promise<PermissionStatus>;\n\n  /**\n   * 打开应用设置页面\n   * 引导用户手动授予权限（当权限被永久拒绝时使用）\n   */\n  openAppSettings(): void;\n\n  /**\n   * 检查原生 SDK 是否已配置 API Key\n   * @returns 是否已配置\n   */\n  isNativeSDKConfigured(): boolean;\n\n  /**\n   * 添加定位监听器（便捷方法）\n   * 封装原生事件订阅，返回带 remove 的订阅对象\n   */\n  addLocationListener(listener: LocationListener): { remove: () => void };\n\n  /**\n   * 计算两个坐标点之间的距离\n   * @param coordinate1 第一个坐标点\n   * @param coordinate2 第二个坐标点\n   * @returns 两点之间的距离（单位：米）\n   */\n  distanceBetweenCoordinates(coordinate1: LatLngPoint, coordinate2: LatLngPoint): number;\n\n   // ==================== 几何计算 ====================\n\n  /**\n   * 判断点是否在圆内\n   * @param point 要判断的点\n   * @param center 圆心坐标\n   * @param radius 圆半径（单位：米）\n   * @returns 是否在圆内\n   */\n  isPointInCircle(point: LatLngPoint, center: LatLngPoint, radius: number): boolean;\n\n  /**\n   * 判断点是否在多边形内\n   * @param point 要判断的点\n   * @param polygon 多边形的顶点坐标数组，支持嵌套数组（多边形空洞）\n   * @returns 是否在多边形内\n   */\n  isPointInPolygon(point: LatLngPoint, polygon: LatLngPoint[] | LatLngPoint[][]): boolean;\n\n  /**\n   * 计算多边形面积\n   * @param polygon 多边形的顶点坐标数组，支持嵌套数组（多边形空洞，会自动展平计算）\n   * @returns 面积（单位：平方米）\n   */\n  calculatePolygonArea(polygon: LatLngPoint[] | LatLngPoint[][]): number;\n\n  /**\n   * 计算矩形面积\n   * @param southWest 西南角坐标\n   * @param northEast 东北角坐标\n   * @returns 面积（单位：平方米）\n   */\n  calculateRectangleArea(southWest: LatLngPoint, northEast: LatLngPoint): number;\n\n  /**\n   * 获取路径上距离目标点最近的点\n   * @param path 路径点集合\n   * @param target 目标点\n   * @returns 最近点信息，包含坐标、索引和距离\n   */\n  getNearestPointOnPath(path: LatLngPoint[], target: LatLngPoint): {\n    latitude: number;\n    longitude: number;\n    index: number;\n    distanceMeters: number;\n  } | null;\n\n  /**\n   * 计算多边形质心\n   * @param polygon 多边形顶点坐标数组，支持嵌套数组\n   * @returns 质心坐标\n   */\n  calculateCentroid(polygon: LatLngPoint[] | LatLngPoint[][]): LatLng | null;\n\n  /**\n   * 计算路径边界和中心点\n   * @param points 路径点\n   * @returns 边界和中心点\n   */\n  calculatePathBounds(points: LatLngPoint[]): {\n    north: number;\n    south: number;\n    east: number;\n    west: number;\n    center: LatLngPoint;\n  } | null;\n\n  /**\n   * GeoHash 编码\n   * @param coordinate 坐标点\n   * @param precision 精度 (1-12)\n   * @returns GeoHash 字符串\n   */\n  encodeGeoHash(coordinate: LatLngPoint, precision: number): string;\n\n  /**\n   * 轨迹抽稀 (RDP 算法)\n   * @param points 原始轨迹点\n   * @param tolerance 允许误差(米)\n   * @returns 简化后的轨迹点\n   */\n  simplifyPolyline(points: LatLngPoint[], tolerance: number): LatLng[];\n\n  /**\n   * 计算路径总长度\n   * @param points 路径点\n   * @returns 长度(米)\n   */\n  calculatePathLength(points: LatLngPoint[]): number;\n\n  /**\n   * 解析高德地图 API 返回的 Polyline 字符串\n   * 格式: \"lng,lat;lng,lat;...\"\n   * @param polylineStr 高德原始 polyline 字符串，或包含 polyline 属性的对象\n   * @returns 解析后的点集\n   */\n  parsePolyline(polylineStr: string | { polyline: string }): LatLng[];\n\n  /**\n   * 获取路径上指定距离的点\n   * @param points 路径点\n   * @param distance 距离起点的米数\n   * @returns 点信息(坐标+角度)\n   */\n  getPointAtDistance(points: LatLngPoint[], distance: number): {\n    latitude: number;\n    longitude: number;\n    angle: number;\n  } | null;\n\n  /**\n   * 瓦片坐标转换：经纬度 -> 瓦片坐标\n   * @param coordinate 坐标点\n   * @param zoom 缩放级别\n   * @returns 瓦片坐标 (x, y, z)\n   */\n  latLngToTile(coordinate: LatLngPoint, zoom: number): { x: number; y: number; z: number } | null;\n\n  /**\n   * 瓦片坐标转换：瓦片坐标 -> 经纬度\n   * @param tile 瓦片坐标 (x, y, z)\n   * @returns 经纬度\n   */\n  tileToLatLng(tile: { x: number; y: number; z: number }): LatLng | null;\n\n  /**\n   * 像素坐标转换：经纬度 -> 像素坐标\n   * @param coordinate 坐标点\n   * @param zoom 缩放级别\n   * @returns 像素坐标 (x, y)\n   */\n  latLngToPixel(coordinate: LatLngPoint, zoom: number): { x: number; y: number } | null;\n\n  /**\n   * 像素坐标转换：像素坐标 -> 经纬度\n   * @param pixel 像素坐标 (x, y)\n   * @param zoom 缩放级别\n   * @returns 经纬度\n   */\n  pixelToLatLng(pixel: { x: number; y: number }, zoom: number): LatLng | null;\n\n  /**\n   * 批量地理围栏检测\n   * @param point 待检测点\n   * @param polygons 多边形集合 (支持嵌套)\n   * @returns 包含该点的多边形索引，若不在任何多边形内返回 -1\n   */\n  findPointInPolygons(point: LatLngPoint, polygons: LatLngPoint[][] | LatLngPoint[][][]): number;\n\n  /**\n   * 生成热力图网格数据 (C++ 加速)\n   * @param points 点集，包含权重\n   * @param gridSizeMeters 网格大小(米)\n   * @returns 聚合后的网格点\n   */\n  generateHeatmapGrid(\n    points: Array<LatLngPoint & { weight?: number }>,\n    gridSizeMeters: number\n  ): Array<{ latitude: number; longitude: number; intensity: number }>;\n}\n"]}

package/build/map/utils/ErrorHandler.d.ts

@@ -8,6 +8,8 @@
 export declare enum ErrorType {
     /** SDK 未初始化 */
     SDK_NOT_INITIALIZED = "SDK_NOT_INITIALIZED",
+    /** 隐私协议未确认 */
+    PRIVACY_NOT_AGREED = "PRIVACY_NOT_AGREED",
     /** API Key 配置错误 */
     INVALID_API_KEY = "INVALID_API_KEY",
     /** 权限未授予 */
@@ -57,6 +59,10 @@ export declare class ErrorHandler {
      * SDK 未初始化错误
      */
     static sdkNotInitialized(): GaodeMapError;
+    /**
+     * 隐私协议未确认错误
+     */
+    static privacyNotAgreed(scene: 'map' | 'sdk'): GaodeMapError;
     /**
      * API Key 配置错误
      */

package/build/map/utils/ErrorHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorHandler.d.ts","sourceRoot":"","sources":["../../../src/map/utils/ErrorHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,oBAAY,SAAS;IACnB,eAAe;IACf,mBAAmB,wBAAwB;IAC3C,mBAAmB;IACnB,eAAe,oBAAoB;IACnC,YAAY;IACZ,iBAAiB,sBAAsB;IACvC,WAAW;IACX,eAAe,oBAAoB;IACnC,cAAc;IACd,yBAAyB,8BAA8B;IACvD,eAAe;IACf,wBAAwB,6BAA6B;IACrD,WAAW;IACX,iBAAiB,sBAAsB;IACvC,WAAW;IACX,aAAa,kBAAkB;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,aAAa,CAAC,EAAE,KAAK,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,KAAK,CAAC;gBAEV,OAAO,EAAE,YAAY;CAqBlC;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,UAAU,CAA4C;IAErE;;OAEG;IACH,MAAM,CAAC,iBAAiB,IAAI,aAAa;IAwBzC;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,aAAa;IAuDzE;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,cAAc,EAAE,UAAU,GAAG,aAAa;IAiDlE;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa;IAuCrD;;OAEG;IACH,MAAM,CAAC,uBAAuB,IAAI,aAAa;IA+B/C;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa;IAqC/D;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,aAAa;IAgB9F;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,KAAK,GAAG,aAAa;IAmBzD;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa;CAkDvE;AAED;;GAEG;AACH,qBAAa,WAAW;IAEtB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAmD;IAE3E;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO;IAIlC;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,aAAa;IAU/B;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAK/C"}
+{"version":3,"file":"ErrorHandler.d.ts","sourceRoot":"","sources":["../../../src/map/utils/ErrorHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,oBAAY,SAAS;IACnB,eAAe;IACf,mBAAmB,wBAAwB;IAC3C,cAAc;IACd,kBAAkB,uBAAuB;IACzC,mBAAmB;IACnB,eAAe,oBAAoB;IACnC,YAAY;IACZ,iBAAiB,sBAAsB;IACvC,WAAW;IACX,eAAe,oBAAoB;IACnC,cAAc;IACd,yBAAyB,8BAA8B;IACvD,eAAe;IACf,wBAAwB,6BAA6B;IACrD,WAAW;IACX,iBAAiB,sBAAsB;IACvC,WAAW;IACX,aAAa,kBAAkB;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,aAAa,CAAC,EAAE,KAAK,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,KAAK,CAAC;gBAEV,OAAO,EAAE,YAAY;CAqBlC;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,UAAU,CAA4C;IAErE;;OAEG;IACH,MAAM,CAAC,iBAAiB,IAAI,aAAa;IAwBzC;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,GAAG,aAAa;IA2B5D;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,aAAa;IAuDzE;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,cAAc,EAAE,UAAU,GAAG,aAAa;IAiDlE;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa;IAuCrD;;OAEG;IACH,MAAM,CAAC,uBAAuB,IAAI,aAAa;IA+B/C;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa;IAqC/D;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,aAAa;IAgB9F;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,KAAK,GAAG,aAAa;IAmBzD;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa;CAkDvE;AAED;;GAEG;AACH,qBAAa,WAAW;IAEtB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAmD;IAE3E;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO;IAIlC;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,aAAa;IAU/B;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAK/C"}

package/build/map/utils/ErrorHandler.js

@@ -9,6 +9,8 @@ export var ErrorType;
 (function (ErrorType) {
     /** SDK 未初始化 */
     ErrorType["SDK_NOT_INITIALIZED"] = "SDK_NOT_INITIALIZED";
+    /** 隐私协议未确认 */
+    ErrorType["PRIVACY_NOT_AGREED"] = "PRIVACY_NOT_AGREED";
     /** API Key 配置错误 */
     ErrorType["INVALID_API_KEY"] = "INVALID_API_KEY";
     /** 权限未授予 */
@@ -85,6 +87,35 @@ useEffect(() => {
             docUrl: `${this.docBaseUrl}/guide/initialization.html`,
         });
     }
+    /**
+     * 隐私协议未确认错误
+     */
+    static privacyNotAgreed(scene) {
+        const sceneText = scene === 'map' ? '渲染 MapView' : '初始化 SDK';
+        return new GaodeMapError({
+            type: ErrorType.PRIVACY_NOT_AGREED,
+            message: `调用高德地图前未完成隐私合规确认：${sceneText}`,
+            solution: `请在调用任何高德地图 SDK 接口前，先明确完成隐私告知与同意：
+
+import ExpoGaodeMapModule from 'expo-gaode-map';
+
+// 应用启动后，先展示你自己的隐私弹窗
+ExpoGaodeMapModule.setPrivacyShow(true, true);
+ExpoGaodeMapModule.setPrivacyAgree(true);
+
+// 然后再初始化 SDK / 渲染地图
+ExpoGaodeMapModule.initSDK({
+  androidKey: 'your-android-key',
+  iosKey: 'your-ios-key',
+});
+
+⚠️  升级注意：
+1. 不能只 import 包后直接渲染 MapView
+2. Android 若未先设置隐私，原生 SDK 可能直接报 555570
+3. 推荐在应用首次启动时先弹出隐私协议，同意后再进入地图页面`,
+            docUrl: `${this.docBaseUrl}/guide/initialization.html`,
+        });
+    }
     /**
      * API Key 配置错误
      */

package/build/map/utils/ErrorHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"ErrorHandler.js","sourceRoot":"","sources":["../../../src/map/utils/ErrorHandler.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 高德地图错误处理工具\n * 提供友好的错误提示和解决方案指引\n */\n\n/**\n * 错误类型枚举\n */\nexport enum ErrorType {\n  /** SDK 未初始化 */\n  SDK_NOT_INITIALIZED = 'SDK_NOT_INITIALIZED',\n  /** API Key 配置错误 */\n  INVALID_API_KEY = 'INVALID_API_KEY',\n  /** 权限未授予 */\n  PERMISSION_DENIED = 'PERMISSION_DENIED',\n  /** 定位失败 */\n  LOCATION_FAILED = 'LOCATION_FAILED',\n  /** 原生模块不可用 */\n  NATIVE_MODULE_UNAVAILABLE = 'NATIVE_MODULE_UNAVAILABLE',\n  /** 地图视图未初始化 */\n  MAP_VIEW_NOT_INITIALIZED = 'MAP_VIEW_NOT_INITIALIZED',\n  /** 参数错误 */\n  INVALID_PARAMETER = 'INVALID_PARAMETER',\n  /** 网络错误 */\n  NETWORK_ERROR = 'NETWORK_ERROR',\n}\n\n/**\n * 错误详情接口\n */\nexport interface ErrorDetails {\n  /** 错误类型 */\n  type: ErrorType;\n  /** 错误消息 */\n  message: string;\n  /** 解决方案 */\n  solution: string;\n  /** 文档链接 */\n  docUrl?: string;\n  /** 原始错误 */\n  originalError?: Error;\n}\n\n/**\n * 自定义错误类\n */\nexport class GaodeMapError extends Error {\n  type: ErrorType;\n  solution: string;\n  docUrl?: string;\n  originalError?: Error;\n\n  constructor(details: ErrorDetails) {\n    const fullMessage = `\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n🗺️  高德地图错误 [${details.type}]\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n❌ 错误信息：\n   ${details.message}\n\n💡 解决方案：\n   ${details.solution}\n\n${details.docUrl ? `📖 详细文档：\\n   ${details.docUrl}\\n` : ''}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;\n    super(fullMessage);\n    this.name = 'GaodeMapError';\n    this.type = details.type;\n    this.solution = details.solution;\n    this.docUrl = details.docUrl;\n    this.originalError = details.originalError;\n  }\n}\n\n/**\n * 错误处理器类\n */\nexport class ErrorHandler {\n  private static docBaseUrl = 'https://TomWq.github.io/expo-gaode-map';\n\n  /**\n   * SDK 未初始化错误\n   */\n  static sdkNotInitialized(): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.SDK_NOT_INITIALIZED,\n      message: '高德地图 SDK 尚未初始化',\n      solution: `请在使用地图功能前先调用 initSDK()：\n\nimport ExpoGaodeMapModule from 'expo-gaode-map';\n\nuseEffect(() => {\n  // 在组件挂载时初始化\n  ExpoGaodeMapModule.initSDK({\n    androidKey: 'your-android-key',\n    iosKey: 'your-ios-key',\n  });\n}, []);\n\n⚠️  常见原因：\n1. 忘记调用 initSDK() 就使用了定位或地图功能\n2. initSDK() 调用时机过晚（应在 useEffect 中尽早调用）\n3. 使用 Config Plugin 但未重新构建原生代码`,\n      docUrl: `${this.docBaseUrl}/guide/initialization.html`,\n    });\n  }\n\n  /**\n   * API Key 配置错误\n   */\n  static invalidApiKey(platform: 'android' | 'ios' | 'both'): GaodeMapError {\n    const platformText = {\n      android: 'Android',\n      ios: 'iOS',\n      both: 'Android 和 iOS',\n    }[platform];\n\n    return new GaodeMapError({\n      type: ErrorType.INVALID_API_KEY,\n      message: `${platformText} API Key 配置错误或未配置`,\n      solution: `⚠️  API Key 与 Bundle ID 不匹配是最常见的原因！\n\n请检查以下步骤：\n\n1️⃣  确认 API Key 的配置：\n   • 访问高德开放平台：https://lbs.amap.com/\n   • 检查您的应用配置中的 Bundle ID 是否与当前项目一致\n   • iOS Bundle ID：在 Xcode → Target → General → Bundle Identifier 查看\n   • Android 包名：在 android/app/build.gradle → applicationId 查看\n\n2️⃣  重新创建正确的 API Key（如果 Bundle ID 不同）：\n   • 在高德开放平台创建新应用\n   • 填写正确的 Bundle ID（iOS）或包名（Android）\n   • 获取新的 API Key\n\n3️⃣  配置 API Key（推荐使用 Config Plugin）：\n\n在 app.json 中配置：\n{\n  \"expo\": {\n    \"plugins\": [\n      [\n        \"expo-gaode-map\",\n        {\n          \"androidKey\": \"your-android-key\",\n          \"iosKey\": \"your-ios-key\"\n        }\n      ]\n    ]\n  }\n}\n\n然后重新构建：\nnpx expo prebuild --clean\nnpx expo run:${platform === 'ios' ? 'ios' : 'android'}\n\n4️⃣  或在代码中配置：\nExpoGaodeMapModule.initSDK({\n  androidKey: 'your-android-key',\n  iosKey: 'your-ios-key',\n});`,\n      docUrl: `${this.docBaseUrl}/guide/initialization.html`,\n    });\n  }\n\n  /**\n   * 权限未授予错误\n   */\n  static permissionDenied(permissionType: 'location'): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.PERMISSION_DENIED,\n      message: '定位权限未授予，无法使用定位功能',\n      solution: `请按以下步骤授予权限：\n\n1️⃣  请求权限：\nimport ExpoGaodeMapModule from 'expo-gaode-map';\n\nconst checkPermission = async () => {\n  // 检查权限状态\n  const status = await ExpoGaodeMapModule.checkLocationPermission();\n  \n  if (!status.granted) {\n    // 请求权限\n    const result = await ExpoGaodeMapModule.requestLocationPermission();\n    \n    if (!result.granted) {\n      // 用户拒绝授权，引导用户去设置\n      Alert.alert(\n        '需要定位权限',\n        '请在设置中开启定位权限以使用地图功能',\n        [\n          { text: '取消', style: 'cancel' },\n          { text: '去设置', onPress: () => Linking.openSettings() }\n        ]\n      );\n    }\n  }\n};\n\n2️⃣  iOS 配置（在 app.json 中）：\n{\n  \"expo\": {\n    \"ios\": {\n      \"infoPlist\": {\n        \"NSLocationWhenInUseUsageDescription\": \"需要获取您的位置信息以显示地图\",\n        \"NSLocationAlwaysAndWhenInUseUsageDescription\": \"需要获取您的位置信息\"\n      }\n    }\n  }\n}\n\n3️⃣  Android 配置（Config Plugin 会自动添加）：\n使用 expo-gaode-map 的 Config Plugin 会自动添加必要的权限声明`,\n      docUrl: `${this.docBaseUrl}/guide/getting-started.html#权限配置`,\n    });\n  }\n\n  /**\n   * 定位失败错误\n   */\n  static locationFailed(reason?: string): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.LOCATION_FAILED,\n      message: `定位失败${reason ? `：${reason}` : ''}`,\n      solution: `⚠️  最常见原因：API Key 与 Bundle ID 不匹配！\n\n请按以下顺序排查：\n\n1️⃣  检查 API Key 配置（最常见问题）：\n   • 访问高德开放平台：https://lbs.amap.com/\n   • 确认您的应用的 Bundle ID 与当前项目一致\n   • iOS Bundle ID：在 Xcode → Target → General → Bundle Identifier\n   • Android 包名：在 android/app/build.gradle → applicationId\n   \n   如果 Bundle ID 不同，必须在高德平台重新创建应用并获取新 Key\n\n2️⃣  检查设备 GPS 和网络：\n   • 确认设备 GPS 已开启\n   • 检查网络连接是否正常\n   • 尝试在室外空旷处测试\n\n3️⃣  检查定位权限：\n   • iOS：设置 → 隐私 → 定位服务 → 允许应用访问\n   • Android：设置 → 应用 → 权限管理 → 位置信息\n\n4️⃣  配置定位参数（如果 API Key 正确但定位仍失败）：\nExpoGaodeMapModule.setLocationTimeout(30); // 增加超时时间\nExpoGaodeMapModule.setInterval(2000); // 设置定位间隔\n\n// Android 特有配置\nExpoGaodeMapModule.setLocationMode(2); // 高精度模式\nExpoGaodeMapModule.setGpsFirst(true);  // GPS 优先\n\n// iOS 特有配置\nExpoGaodeMapModule.setDesiredAccuracy(0); // 最佳精度`,\n      docUrl: `${this.docBaseUrl}/api/location.html`,\n    });\n  }\n\n  /**\n   * 原生模块不可用错误\n   */\n  static nativeModuleUnavailable(): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.NATIVE_MODULE_UNAVAILABLE,\n      message: 'expo-gaode-map 原生模块不可用',\n      solution: `请检查以下步骤：\n\n1️⃣  确认已正确安装：\nnpm install expo-gaode-map\n# 或\nbun install expo-gaode-map\n\n2️⃣  重新构建原生代码：\nnpx expo prebuild --clean\nnpx expo run:android\nnpx expo run:ios\n\n3️⃣  检查 Expo 版本兼容性：\n• expo-gaode-map 需要 Expo SDK 49+\n• 不支持 Expo Go，必须使用 Development Build\n\n4️⃣  检查是否与其他包冲突：\n• 不能同时安装 expo-gaode-map 和 expo-gaode-map-navigation\n• 两个包选择其一使用\n\n5️⃣  清理缓存后重试：\ncd android && ./gradlew clean && cd ..\ncd ios && pod deintegrate && pod install && cd ..`,\n      docUrl: `${this.docBaseUrl}/guide/getting-started.html`,\n    });\n  }\n\n  /**\n   * 地图视图未初始化错误\n   */\n  static mapViewNotInitialized(methodName: string): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.MAP_VIEW_NOT_INITIALIZED,\n      message: `无法调用 ${methodName}：地图视图尚未初始化`,\n      solution: `请确保：\n\n1️⃣  MapView 已经渲染完成\n2️⃣  使用 ref 获取地图实例后再调用方法\n\n正确用法：\nimport { MapView, MapViewRef } from 'expo-gaode-map';\n\nconst App = () => {\n  const mapRef = useRef<MapViewRef>(null);\n  \n  // ❌ 错误：在渲染前调用\n  // mapRef.current?.moveCamera(...);\n  \n  // ✅ 正确：等待地图加载完成\n  const handleMapReady = () => {\n    mapRef.current?.moveCamera({\n      target: { latitude: 39.9, longitude: 116.4 },\n      zoom: 15,\n    });\n  };\n  \n  return (\n    <MapView\n      ref={mapRef}\n      onMapReady={handleMapReady}\n    />\n  );\n};`,\n      docUrl: `${this.docBaseUrl}/api/mapview.html`,\n    });\n  }\n\n  /**\n   * 参数错误\n   */\n  static invalidParameter(paramName: string, expected: string, received: unknown): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.INVALID_PARAMETER,\n      message: `参数 \"${paramName}\" 类型错误`,\n      solution: `期望类型：${expected}\n实际接收：${typeof received} (${JSON.stringify(received)})\n\n请检查传入的参数是否符合要求。\n\n💡 提示：\n• 使用 TypeScript 可以在编译时发现类型错误\n• 参考 API 文档了解正确的参数类型`,\n      docUrl: `${this.docBaseUrl}/api/`,\n    });\n  }\n\n  /**\n   * 网络错误\n   */\n  static networkError(originalError?: Error): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.NETWORK_ERROR,\n      message: '网络请求失败',\n      solution: `请检查：\n\n1️⃣  网络连接是否正常\n2️⃣  API Key 是否有效\n3️⃣  是否超出配额限制\n\n💡 如果问题持续，请：\n• 检查高德开放平台控制台\n• 查看 API 调用量和配额\n• 确认 Key 的服务是否已开通`,\n      docUrl: `${this.docBaseUrl}/guide/troubleshooting.html`,\n      originalError,\n    });\n  }\n\n  /**\n   * 包装原生错误，提供更友好的提示\n   */\n  static wrapNativeError(error: unknown, context: string): GaodeMapError {\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    \n    // SDK 未初始化相关错误\n    if (\n      errorMessage.includes('not initialized') ||\n      errorMessage.includes('未初始化') ||\n      errorMessage.includes('SDK未设置')\n    ) {\n      return this.sdkNotInitialized();\n    }\n    \n    // API Key 相关错误\n    if (\n      errorMessage.includes('key') ||\n      errorMessage.includes('invalid') ||\n      errorMessage.includes('鉴权失败')\n    ) {\n      return this.invalidApiKey('both');\n    }\n    \n    // 权限相关错误\n    if (\n      errorMessage.includes('permission') ||\n      errorMessage.includes('权限')\n    ) {\n      return this.permissionDenied('location');\n    }\n    \n    // 定位相关错误\n    if (\n      errorMessage.includes('location') ||\n      errorMessage.includes('定位')\n    ) {\n      return this.locationFailed(errorMessage);\n    }\n    \n    // 通用错误\n    return new GaodeMapError({\n      type: ErrorType.INVALID_PARAMETER,\n      message: `${context} 失败`,\n      solution: `原始错误信息：${errorMessage}\n\n如果问题持续，请：\n1. 查看完整的错误堆栈\n2. 检查 API 调用参数\n3. 提交 Issue：https://github.com/TomWq/expo-gaode-map/issues`,\n      originalError: error instanceof Error ? error : undefined,\n    });\n  }\n}\n\n/**\n * 错误日志工具\n */\nexport class ErrorLogger {\n  // 兼容不同环境：Bun/Jest/Node\n  private static isEnabled = typeof __DEV__ !== 'undefined' ? __DEV__ : true;\n\n  /**\n   * 启用/禁用错误日志\n   */\n  static setEnabled(enabled: boolean) {\n    this.isEnabled = enabled;\n  }\n\n  /**\n   * 记录错误\n   */\n  static log(error: GaodeMapError) {\n    if (!this.isEnabled) return;\n\n    console.error(error.message);\n    \n    if (error.originalError) {\n      console.error('原始错误：', error.originalError);\n    }\n  }\n\n  /**\n   * 记录警告\n   */\n  static warn(message: string, details?: unknown) {\n    if (!this.isEnabled) return;\n    \n    console.warn(`⚠️  expo-gaode-map: ${message}`, details || '');\n  }\n}\n"]}
+{"version":3,"file":"ErrorHandler.js","sourceRoot":"","sources":["../../../src/map/utils/ErrorHandler.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 高德地图错误处理工具\n * 提供友好的错误提示和解决方案指引\n */\n\n/**\n * 错误类型枚举\n */\nexport enum ErrorType {\n  /** SDK 未初始化 */\n  SDK_NOT_INITIALIZED = 'SDK_NOT_INITIALIZED',\n  /** 隐私协议未确认 */\n  PRIVACY_NOT_AGREED = 'PRIVACY_NOT_AGREED',\n  /** API Key 配置错误 */\n  INVALID_API_KEY = 'INVALID_API_KEY',\n  /** 权限未授予 */\n  PERMISSION_DENIED = 'PERMISSION_DENIED',\n  /** 定位失败 */\n  LOCATION_FAILED = 'LOCATION_FAILED',\n  /** 原生模块不可用 */\n  NATIVE_MODULE_UNAVAILABLE = 'NATIVE_MODULE_UNAVAILABLE',\n  /** 地图视图未初始化 */\n  MAP_VIEW_NOT_INITIALIZED = 'MAP_VIEW_NOT_INITIALIZED',\n  /** 参数错误 */\n  INVALID_PARAMETER = 'INVALID_PARAMETER',\n  /** 网络错误 */\n  NETWORK_ERROR = 'NETWORK_ERROR',\n}\n\n/**\n * 错误详情接口\n */\nexport interface ErrorDetails {\n  /** 错误类型 */\n  type: ErrorType;\n  /** 错误消息 */\n  message: string;\n  /** 解决方案 */\n  solution: string;\n  /** 文档链接 */\n  docUrl?: string;\n  /** 原始错误 */\n  originalError?: Error;\n}\n\n/**\n * 自定义错误类\n */\nexport class GaodeMapError extends Error {\n  type: ErrorType;\n  solution: string;\n  docUrl?: string;\n  originalError?: Error;\n\n  constructor(details: ErrorDetails) {\n    const fullMessage = `\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n🗺️  高德地图错误 [${details.type}]\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n❌ 错误信息：\n   ${details.message}\n\n💡 解决方案：\n   ${details.solution}\n\n${details.docUrl ? `📖 详细文档：\\n   ${details.docUrl}\\n` : ''}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`;\n    super(fullMessage);\n    this.name = 'GaodeMapError';\n    this.type = details.type;\n    this.solution = details.solution;\n    this.docUrl = details.docUrl;\n    this.originalError = details.originalError;\n  }\n}\n\n/**\n * 错误处理器类\n */\nexport class ErrorHandler {\n  private static docBaseUrl = 'https://TomWq.github.io/expo-gaode-map';\n\n  /**\n   * SDK 未初始化错误\n   */\n  static sdkNotInitialized(): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.SDK_NOT_INITIALIZED,\n      message: '高德地图 SDK 尚未初始化',\n      solution: `请在使用地图功能前先调用 initSDK()：\n\nimport ExpoGaodeMapModule from 'expo-gaode-map';\n\nuseEffect(() => {\n  // 在组件挂载时初始化\n  ExpoGaodeMapModule.initSDK({\n    androidKey: 'your-android-key',\n    iosKey: 'your-ios-key',\n  });\n}, []);\n\n⚠️  常见原因：\n1. 忘记调用 initSDK() 就使用了定位或地图功能\n2. initSDK() 调用时机过晚（应在 useEffect 中尽早调用）\n3. 使用 Config Plugin 但未重新构建原生代码`,\n      docUrl: `${this.docBaseUrl}/guide/initialization.html`,\n    });\n  }\n\n  /**\n   * 隐私协议未确认错误\n   */\n  static privacyNotAgreed(scene: 'map' | 'sdk'): GaodeMapError {\n    const sceneText = scene === 'map' ? '渲染 MapView' : '初始化 SDK';\n    return new GaodeMapError({\n      type: ErrorType.PRIVACY_NOT_AGREED,\n      message: `调用高德地图前未完成隐私合规确认：${sceneText}`,\n      solution: `请在调用任何高德地图 SDK 接口前，先明确完成隐私告知与同意：\n\nimport ExpoGaodeMapModule from 'expo-gaode-map';\n\n// 应用启动后，先展示你自己的隐私弹窗\nExpoGaodeMapModule.setPrivacyShow(true, true);\nExpoGaodeMapModule.setPrivacyAgree(true);\n\n// 然后再初始化 SDK / 渲染地图\nExpoGaodeMapModule.initSDK({\n  androidKey: 'your-android-key',\n  iosKey: 'your-ios-key',\n});\n\n⚠️  升级注意：\n1. 不能只 import 包后直接渲染 MapView\n2. Android 若未先设置隐私，原生 SDK 可能直接报 555570\n3. 推荐在应用首次启动时先弹出隐私协议，同意后再进入地图页面`,\n      docUrl: `${this.docBaseUrl}/guide/initialization.html`,\n    });\n  }\n\n  /**\n   * API Key 配置错误\n   */\n  static invalidApiKey(platform: 'android' | 'ios' | 'both'): GaodeMapError {\n    const platformText = {\n      android: 'Android',\n      ios: 'iOS',\n      both: 'Android 和 iOS',\n    }[platform];\n\n    return new GaodeMapError({\n      type: ErrorType.INVALID_API_KEY,\n      message: `${platformText} API Key 配置错误或未配置`,\n      solution: `⚠️  API Key 与 Bundle ID 不匹配是最常见的原因！\n\n请检查以下步骤：\n\n1️⃣  确认 API Key 的配置：\n   • 访问高德开放平台：https://lbs.amap.com/\n   • 检查您的应用配置中的 Bundle ID 是否与当前项目一致\n   • iOS Bundle ID：在 Xcode → Target → General → Bundle Identifier 查看\n   • Android 包名：在 android/app/build.gradle → applicationId 查看\n\n2️⃣  重新创建正确的 API Key（如果 Bundle ID 不同）：\n   • 在高德开放平台创建新应用\n   • 填写正确的 Bundle ID（iOS）或包名（Android）\n   • 获取新的 API Key\n\n3️⃣  配置 API Key（推荐使用 Config Plugin）：\n\n在 app.json 中配置：\n{\n  \"expo\": {\n    \"plugins\": [\n      [\n        \"expo-gaode-map\",\n        {\n          \"androidKey\": \"your-android-key\",\n          \"iosKey\": \"your-ios-key\"\n        }\n      ]\n    ]\n  }\n}\n\n然后重新构建：\nnpx expo prebuild --clean\nnpx expo run:${platform === 'ios' ? 'ios' : 'android'}\n\n4️⃣  或在代码中配置：\nExpoGaodeMapModule.initSDK({\n  androidKey: 'your-android-key',\n  iosKey: 'your-ios-key',\n});`,\n      docUrl: `${this.docBaseUrl}/guide/initialization.html`,\n    });\n  }\n\n  /**\n   * 权限未授予错误\n   */\n  static permissionDenied(permissionType: 'location'): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.PERMISSION_DENIED,\n      message: '定位权限未授予，无法使用定位功能',\n      solution: `请按以下步骤授予权限：\n\n1️⃣  请求权限：\nimport ExpoGaodeMapModule from 'expo-gaode-map';\n\nconst checkPermission = async () => {\n  // 检查权限状态\n  const status = await ExpoGaodeMapModule.checkLocationPermission();\n  \n  if (!status.granted) {\n    // 请求权限\n    const result = await ExpoGaodeMapModule.requestLocationPermission();\n    \n    if (!result.granted) {\n      // 用户拒绝授权，引导用户去设置\n      Alert.alert(\n        '需要定位权限',\n        '请在设置中开启定位权限以使用地图功能',\n        [\n          { text: '取消', style: 'cancel' },\n          { text: '去设置', onPress: () => Linking.openSettings() }\n        ]\n      );\n    }\n  }\n};\n\n2️⃣  iOS 配置（在 app.json 中）：\n{\n  \"expo\": {\n    \"ios\": {\n      \"infoPlist\": {\n        \"NSLocationWhenInUseUsageDescription\": \"需要获取您的位置信息以显示地图\",\n        \"NSLocationAlwaysAndWhenInUseUsageDescription\": \"需要获取您的位置信息\"\n      }\n    }\n  }\n}\n\n3️⃣  Android 配置（Config Plugin 会自动添加）：\n使用 expo-gaode-map 的 Config Plugin 会自动添加必要的权限声明`,\n      docUrl: `${this.docBaseUrl}/guide/getting-started.html#权限配置`,\n    });\n  }\n\n  /**\n   * 定位失败错误\n   */\n  static locationFailed(reason?: string): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.LOCATION_FAILED,\n      message: `定位失败${reason ? `：${reason}` : ''}`,\n      solution: `⚠️  最常见原因：API Key 与 Bundle ID 不匹配！\n\n请按以下顺序排查：\n\n1️⃣  检查 API Key 配置（最常见问题）：\n   • 访问高德开放平台：https://lbs.amap.com/\n   • 确认您的应用的 Bundle ID 与当前项目一致\n   • iOS Bundle ID：在 Xcode → Target → General → Bundle Identifier\n   • Android 包名：在 android/app/build.gradle → applicationId\n   \n   如果 Bundle ID 不同，必须在高德平台重新创建应用并获取新 Key\n\n2️⃣  检查设备 GPS 和网络：\n   • 确认设备 GPS 已开启\n   • 检查网络连接是否正常\n   • 尝试在室外空旷处测试\n\n3️⃣  检查定位权限：\n   • iOS：设置 → 隐私 → 定位服务 → 允许应用访问\n   • Android：设置 → 应用 → 权限管理 → 位置信息\n\n4️⃣  配置定位参数（如果 API Key 正确但定位仍失败）：\nExpoGaodeMapModule.setLocationTimeout(30); // 增加超时时间\nExpoGaodeMapModule.setInterval(2000); // 设置定位间隔\n\n// Android 特有配置\nExpoGaodeMapModule.setLocationMode(2); // 高精度模式\nExpoGaodeMapModule.setGpsFirst(true);  // GPS 优先\n\n// iOS 特有配置\nExpoGaodeMapModule.setDesiredAccuracy(0); // 最佳精度`,\n      docUrl: `${this.docBaseUrl}/api/location.html`,\n    });\n  }\n\n  /**\n   * 原生模块不可用错误\n   */\n  static nativeModuleUnavailable(): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.NATIVE_MODULE_UNAVAILABLE,\n      message: 'expo-gaode-map 原生模块不可用',\n      solution: `请检查以下步骤：\n\n1️⃣  确认已正确安装：\nnpm install expo-gaode-map\n# 或\nbun install expo-gaode-map\n\n2️⃣  重新构建原生代码：\nnpx expo prebuild --clean\nnpx expo run:android\nnpx expo run:ios\n\n3️⃣  检查 Expo 版本兼容性：\n• expo-gaode-map 需要 Expo SDK 49+\n• 不支持 Expo Go，必须使用 Development Build\n\n4️⃣  检查是否与其他包冲突：\n• 不能同时安装 expo-gaode-map 和 expo-gaode-map-navigation\n• 两个包选择其一使用\n\n5️⃣  清理缓存后重试：\ncd android && ./gradlew clean && cd ..\ncd ios && pod deintegrate && pod install && cd ..`,\n      docUrl: `${this.docBaseUrl}/guide/getting-started.html`,\n    });\n  }\n\n  /**\n   * 地图视图未初始化错误\n   */\n  static mapViewNotInitialized(methodName: string): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.MAP_VIEW_NOT_INITIALIZED,\n      message: `无法调用 ${methodName}：地图视图尚未初始化`,\n      solution: `请确保：\n\n1️⃣  MapView 已经渲染完成\n2️⃣  使用 ref 获取地图实例后再调用方法\n\n正确用法：\nimport { MapView, MapViewRef } from 'expo-gaode-map';\n\nconst App = () => {\n  const mapRef = useRef<MapViewRef>(null);\n  \n  // ❌ 错误：在渲染前调用\n  // mapRef.current?.moveCamera(...);\n  \n  // ✅ 正确：等待地图加载完成\n  const handleMapReady = () => {\n    mapRef.current?.moveCamera({\n      target: { latitude: 39.9, longitude: 116.4 },\n      zoom: 15,\n    });\n  };\n  \n  return (\n    <MapView\n      ref={mapRef}\n      onMapReady={handleMapReady}\n    />\n  );\n};`,\n      docUrl: `${this.docBaseUrl}/api/mapview.html`,\n    });\n  }\n\n  /**\n   * 参数错误\n   */\n  static invalidParameter(paramName: string, expected: string, received: unknown): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.INVALID_PARAMETER,\n      message: `参数 \"${paramName}\" 类型错误`,\n      solution: `期望类型：${expected}\n实际接收：${typeof received} (${JSON.stringify(received)})\n\n请检查传入的参数是否符合要求。\n\n💡 提示：\n• 使用 TypeScript 可以在编译时发现类型错误\n• 参考 API 文档了解正确的参数类型`,\n      docUrl: `${this.docBaseUrl}/api/`,\n    });\n  }\n\n  /**\n   * 网络错误\n   */\n  static networkError(originalError?: Error): GaodeMapError {\n    return new GaodeMapError({\n      type: ErrorType.NETWORK_ERROR,\n      message: '网络请求失败',\n      solution: `请检查：\n\n1️⃣  网络连接是否正常\n2️⃣  API Key 是否有效\n3️⃣  是否超出配额限制\n\n💡 如果问题持续，请：\n• 检查高德开放平台控制台\n• 查看 API 调用量和配额\n• 确认 Key 的服务是否已开通`,\n      docUrl: `${this.docBaseUrl}/guide/troubleshooting.html`,\n      originalError,\n    });\n  }\n\n  /**\n   * 包装原生错误，提供更友好的提示\n   */\n  static wrapNativeError(error: unknown, context: string): GaodeMapError {\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    \n    // SDK 未初始化相关错误\n    if (\n      errorMessage.includes('not initialized') ||\n      errorMessage.includes('未初始化') ||\n      errorMessage.includes('SDK未设置')\n    ) {\n      return this.sdkNotInitialized();\n    }\n    \n    // API Key 相关错误\n    if (\n      errorMessage.includes('key') ||\n      errorMessage.includes('invalid') ||\n      errorMessage.includes('鉴权失败')\n    ) {\n      return this.invalidApiKey('both');\n    }\n    \n    // 权限相关错误\n    if (\n      errorMessage.includes('permission') ||\n      errorMessage.includes('权限')\n    ) {\n      return this.permissionDenied('location');\n    }\n    \n    // 定位相关错误\n    if (\n      errorMessage.includes('location') ||\n      errorMessage.includes('定位')\n    ) {\n      return this.locationFailed(errorMessage);\n    }\n    \n    // 通用错误\n    return new GaodeMapError({\n      type: ErrorType.INVALID_PARAMETER,\n      message: `${context} 失败`,\n      solution: `原始错误信息：${errorMessage}\n\n如果问题持续，请：\n1. 查看完整的错误堆栈\n2. 检查 API 调用参数\n3. 提交 Issue：https://github.com/TomWq/expo-gaode-map/issues`,\n      originalError: error instanceof Error ? error : undefined,\n    });\n  }\n}\n\n/**\n * 错误日志工具\n */\nexport class ErrorLogger {\n  // 兼容不同环境：Bun/Jest/Node\n  private static isEnabled = typeof __DEV__ !== 'undefined' ? __DEV__ : true;\n\n  /**\n   * 启用/禁用错误日志\n   */\n  static setEnabled(enabled: boolean) {\n    this.isEnabled = enabled;\n  }\n\n  /**\n   * 记录错误\n   */\n  static log(error: GaodeMapError) {\n    if (!this.isEnabled) return;\n\n    console.error(error.message);\n    \n    if (error.originalError) {\n      console.error('原始错误：', error.originalError);\n    }\n  }\n\n  /**\n   * 记录警告\n   */\n  static warn(message: string, details?: unknown) {\n    if (!this.isEnabled) return;\n    \n    console.warn(`⚠️  expo-gaode-map: ${message}`, details || '');\n  }\n}\n"]}

package/build/map/utils/lazyNativeViewManager.d.ts

@@ -0,0 +1,3 @@
+import type { ComponentType } from 'react';
+export declare function createLazyNativeViewManager<Props extends object = any>(name: string): () => ComponentType<Props>;
+//# sourceMappingURL=lazyNativeViewManager.d.ts.map

package/build/map/utils/lazyNativeViewManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazyNativeViewManager.d.ts","sourceRoot":"","sources":["../../../src/map/utils/lazyNativeViewManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAG3C,wBAAgB,2BAA2B,CAAC,KAAK,SAAS,MAAM,GAAG,GAAG,EACpE,IAAI,EAAE,MAAM,GACX,MAAM,aAAa,CAAC,KAAK,CAAC,CAS5B"}

package/build/map/utils/lazyNativeViewManager.js

@@ -0,0 +1,11 @@
+import { requireNativeViewManager } from 'expo-modules-core';
+export function createLazyNativeViewManager(name) {
+    let cached = null;
+    return () => {
+        if (!cached) {
+            cached = requireNativeViewManager(name);
+        }
+        return cached;
+    };
+}
+//# sourceMappingURL=lazyNativeViewManager.js.map

package/build/map/utils/lazyNativeViewManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazyNativeViewManager.js","sourceRoot":"","sources":["../../../src/map/utils/lazyNativeViewManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,MAAM,UAAU,2BAA2B,CACzC,IAAY;IAEZ,IAAI,MAAM,GAAgC,IAAI,CAAC;IAE/C,OAAO,GAAG,EAAE;QACV,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,wBAAwB,CAAQ,IAAI,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,MAAO,CAAC;IACjB,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import type { ComponentType } from 'react';\nimport { requireNativeViewManager } from 'expo-modules-core';\n\nexport function createLazyNativeViewManager<Props extends object = any>(\n  name: string\n): () => ComponentType<Props> {\n  let cached: ComponentType<Props> | null = null;\n\n  return () => {\n    if (!cached) {\n      cached = requireNativeViewManager<Props>(name);\n    }\n    return cached!;\n  };\n}\n"]}

package/ios/ExpoGaodeMapNavigation.podspec

@@ -2,6 +2,11 @@ require 'json'
 
 package = JSON.parse(File.read(File.join(__dir__, '..', 'package.json')))
 
+Pod::UI.puts "[expo-gaode-map-navigation] Thank you for using expo-gaode-map-navigation ❤️"
+Pod::UI.puts "[expo-gaode-map-navigation] If you enjoy using expo-gaode-map-navigation, please consider sponsoring this project: https://github.com/TomWq"
+
+
+
 Pod::Spec.new do |s|
   s.name           = 'ExpoGaodeMapNavigation'
   s.version        = package['version']

package/ios/map/ExpoGaodeMapModule.swift

@@ -40,49 +40,23 @@ public class ExpoGaodeMapModule: Module {
         return true // 已经设置过了
     }
     
-    /**
-     * 尝试启动预加载（检查 API Key 后）
-     * @param delay 延迟时间（秒）
-     * @param poolSize 预加载池大小
-     */
-    private func tryStartPreload(delay: Double = 1.0, poolSize: Int = 1) {
-        if let apiKey = AMapServices.shared().apiKey, !apiKey.isEmpty {
-            DispatchQueue.main.asyncAfter(deadline: .now() + delay) {
-                let status = MapPreloadManager.shared.getStatus()
-                let isPreloading = (status["isPreloading"] as? Bool) ?? false
-                
-                if !MapPreloadManager.shared.hasPreloadedMapView() && !isPreloading {
-                   
-                    MapPreloadManager.shared.startPreload(poolSize: poolSize)
-                }
-            }
-        } else {
-            print("⚠️ ExpoGaodeMap: API Key 未设置，跳过自动预加载")
-        }
-    }
-    
     public func definition() -> ModuleDefinition {
         Name("ExpoGaodeMap")
-        
-        // 模块初始化：尝试从本地缓存恢复隐私同意状态
-        OnCreate {
-
-             // 1. 告知 SDK：隐私协议已展示且包含隐私内容
-            MAMapView.updatePrivacyShow(
-                AMapPrivacyShowStatus.didShow,
-                privacyInfo: AMapPrivacyInfoStatus.didContain
-            )
 
-            // 2. 告知 SDK：用户已同意隐私协议（关键）
-            MAMapView.updatePrivacyAgree(AMapPrivacyAgreeStatus.didAgree)
-
-            print("✅ ExpoGaodeMap: 原生侧已默认同意隐私协议")
+        OnCreate {
+            _ = self.trySetupApiKeyFromPlist()
+        }
+        
+        Function("setPrivacyShow") { (hasShow: Bool, hasContainsPrivacy: Bool) in
+            GaodeMapPrivacyManager.setPrivacyShow(hasShow, hasContainsPrivacy: hasContainsPrivacy)
+        }
 
-             // 3. 自动设置 API Key（Info.plist）
-            self.trySetupApiKeyFromPlist()
+        Function("setPrivacyAgree") { (hasAgree: Bool) in
+            GaodeMapPrivacyManager.setPrivacyAgree(hasAgree)
+        }
 
-            // 4. 自动启动预加载（可选）
-            self.tryStartPreload(delay: 2.0, poolSize: 1)
+        Function("getPrivacyStatus") { () -> [String: Bool] in
+            GaodeMapPrivacyManager.status()
         }
         
         // ==================== SDK 初始化 ====================
@@ -92,6 +66,11 @@ public class ExpoGaodeMapModule: Module {
          * @param config 配置字典,包含 iosKey
          */
         Function("initSDK") { (config: [String: String]) in
+            guard GaodeMapPrivacyManager.isReady else {
+                throw Exception(name: "PRIVACY_NOT_AGREED", description: "隐私协议未完成确认，请先调用 setPrivacyShow/setPrivacyAgree")
+            }
+            GaodeMapPrivacyManager.applyPrivacyState()
+
             // 1) 优先使用传入的 iosKey；2) 否则回退读取 Info.plist 的 AMapApiKey
             let providedKey = config["iosKey"]?.trimmingCharacters(in: .whitespacesAndNewlines)
             var finalKey: String? = (providedKey?.isEmpty == false) ? providedKey : nil
@@ -113,10 +92,7 @@ public class ExpoGaodeMapModule: Module {
             }
             AMapServices.shared().enableHTTPS = true
             
-            // 初始化定位管理器（触发原生侧懒加载）
             self.getLocationManager()
-            
-            print("✅ ExpoGaodeMap: 已设置 API Key 并完成初始化（来源：\(providedKey != nil ? "入参 iosKey" : "Info.plist" )）")
         }
         
         /**
@@ -141,6 +117,9 @@ public class ExpoGaodeMapModule: Module {
             if let apiKey = AMapServices.shared().apiKey, !apiKey.isEmpty {
                 return true
             }
+            if let plistKey = Bundle.main.infoDictionary?["AMapApiKey"] as? String, !plistKey.isEmpty {
+                return true
+            }
             return false
         }
         
@@ -774,7 +753,6 @@ public class ExpoGaodeMapModule: Module {
         OnDestroy {
             self.locationManager?.destroy()
             self.locationManager = nil
-            MapPreloadManager.shared.cleanup()
         }
     }