expo-gaode-map 0.1.5 → 1.0.0

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,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-14 16:15:52\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// 地图视图控制已移至 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;;;;;;;;;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"]}

package/build/modules/AMapPermissions.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 权限状态
+ */
+export interface PermissionStatus {
+    /** 是否已授权 */
+    granted: boolean;
+    /** iOS 权限状态字符串 */
+    status?: 'notDetermined' | 'restricted' | 'denied' | 'authorizedAlways' | 'authorizedWhenInUse' | 'unknown';
+    /** Android 精确位置权限 */
+    fineLocation?: boolean;
+    /** Android 粗略位置权限 */
+    coarseLocation?: boolean;
+}
+/**
+ * 检查位置权限状态
+ */
+export declare function checkLocationPermission(): Promise<PermissionStatus>;
+/**
+ * 请求位置权限
+ */
+export declare function requestLocationPermission(): Promise<PermissionStatus>;
+declare const _default: {
+    checkLocationPermission: typeof checkLocationPermission;
+    requestLocationPermission: typeof requestLocationPermission;
+};
+export default _default;
+//# sourceMappingURL=AMapPermissions.d.ts.map

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

@@ -0,0 +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"}

package/build/modules/AMapPermissions.js

@@ -0,0 +1,31 @@
+/*
+ * @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';
+/**
+ * 检查位置权限状态
+ */
+export async function checkLocationPermission() {
+    return await ExpoGaodeMapModule.checkLocationPermission();
+}
+/**
+ * 请求位置权限
+ */
+export async function requestLocationPermission() {
+    return await ExpoGaodeMapModule.requestLocationPermission();
+}
+export default {
+    checkLocationPermission,
+    requestLocationPermission,
+};
+//# sourceMappingURL=AMapPermissions.js.map

package/build/modules/AMapPermissions.js.map

@@ -0,0 +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};"]}

package/build/modules/AMapView.d.ts

@@ -1,30 +1,35 @@
 import type { CameraPosition, Point, LatLng } from '../types';
 /**
  * 移动地图相机到指定位置
+ * @deprecated 不推荐使用,请使用 MapView ref 的 moveCamera 方法
  * @param cameraPosition 相机位置参数
- * @param duration 动画时长（毫秒），默认为0（无动画）
+ * @param duration 动画时长(毫秒),默认为0(无动画)
  */
 export declare function moveCamera(cameraPosition: CameraPosition, duration?: number): void;
 /**
  * 将屏幕坐标转换为地理坐标
+ * @deprecated 不推荐使用,请使用 MapView ref 的 getLatLng 方法
  * @param point 屏幕坐标点
  * @returns 地理坐标
  */
 export declare function getLatLng(point: Point): Promise<LatLng>;
 /**
  * 设置地图中心点
+ * @deprecated 不推荐使用,请使用 MapView ref 的 setCenter 方法
  * @param center 中心点坐标
  * @param animated 是否使用动画
  */
 export declare function setCenter(center: LatLng, animated?: boolean): void;
 /**
  * 设置地图缩放级别
- * @param zoom 缩放级别（3-20）
+ * @deprecated 不推荐使用,请使用 MapView ref 的 setZoom 方法
+ * @param zoom 缩放级别(3-20)
  * @param animated 是否使用动画
  */
 export declare function setZoom(zoom: number, animated?: boolean): void;
 /**
  * 获取当前地图状态
+ * @deprecated 不推荐使用,请使用 MapView ref 的 getCameraPosition 方法
  * @returns 当前相机位置
  */
 export declare function getCameraPosition(): Promise<CameraPosition>;

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

@@ -1 +1 @@
-{"version":3,"file":"AMapView.d.ts","sourceRoot":"","sources":["../../src/modules/AMapView.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAE9D;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,cAAc,EAAE,cAAc,EAAE,QAAQ,SAAI,GAAG,IAAI,CAE7E;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,UAAO,GAAG,IAAI,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,UAAO,GAAG,IAAI,CAE3D;AAED;;;GAGG;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":"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"}

package/build/modules/AMapView.js

@@ -2,23 +2,32 @@
  * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com
  * @Date         : 2025-11-13 14:57:30
  * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com
- * @LastEditTime : 2025-11-13 14:57:35
+ * @LastEditTime : 2025-11-14 19:38:00
  * @FilePath     : /expo-gaode-map/src/modules/AMapView.ts
  * @Description  : 高德地图视图控制模块
  *
+ * ⚠️ 警告: 此模块中的方法已不推荐使用
+ * 请使用 MapView 的 ref 方式调用这些方法
+ *
+ * 示例:
+ * const mapRef = useRef<MapViewRef>(null);
+ * mapRef.current?.moveCamera({ target: { latitude: 39.9, longitude: 116.4 }, zoom: 10 });
+ *
  * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved.
  */
 import ExpoGaodeMapModule from '../ExpoGaodeMapModule';
 /**
  * 移动地图相机到指定位置
+ * @deprecated 不推荐使用,请使用 MapView ref 的 moveCamera 方法
  * @param cameraPosition 相机位置参数
- * @param duration 动画时长（毫秒），默认为0（无动画）
+ * @param duration 动画时长(毫秒),默认为0(无动画)
  */
 export function moveCamera(cameraPosition, duration = 0) {
     ExpoGaodeMapModule.moveCamera?.(cameraPosition, duration);
 }
 /**
  * 将屏幕坐标转换为地理坐标
+ * @deprecated 不推荐使用,请使用 MapView ref 的 getLatLng 方法
  * @param point 屏幕坐标点
  * @returns 地理坐标
  */
@@ -27,6 +36,7 @@ export async function getLatLng(point) {
 }
 /**
  * 设置地图中心点
+ * @deprecated 不推荐使用,请使用 MapView ref 的 setCenter 方法
  * @param center 中心点坐标
  * @param animated 是否使用动画
  */
@@ -35,7 +45,8 @@ export function setCenter(center, animated = true) {
 }
 /**
  * 设置地图缩放级别
- * @param zoom 缩放级别（3-20）
+ * @deprecated 不推荐使用,请使用 MapView ref 的 setZoom 方法
+ * @param zoom 缩放级别(3-20)
  * @param animated 是否使用动画
  */
 export function setZoom(zoom, animated = true) {
@@ -43,6 +54,7 @@ export function setZoom(zoom, animated = true) {
 }
 /**
  * 获取当前地图状态
+ * @deprecated 不推荐使用,请使用 MapView ref 的 getCameraPosition 方法
  * @returns 当前相机位置
  */
 export async function getCameraPosition() {

package/build/modules/AMapView.js.map

@@ -1 +1 @@
-{"version":3,"file":"AMapView.js","sourceRoot":"","sources":["../../src/modules/AMapView.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,kBAAkB,MAAM,uBAAuB,CAAC;AAGvD;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,cAA8B,EAAE,QAAQ,GAAG,CAAC;IACrE,kBAAkB,CAAC,UAAU,EAAE,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AAC5D,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAY;IAC1C,OAAO,kBAAkB,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;AACjG,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,QAAQ,GAAG,IAAI;IACvD,kBAAkB,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,QAAQ,GAAG,IAAI;IACnD,kBAAkB,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,OAAO,kBAAkB,CAAC,iBAAiB,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC;QACjE,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;QACrC,IAAI,EAAE,EAAE;KACT,CAAC,CAAC;AACL,CAAC;AAED,eAAe;IACb,UAAU;IACV,SAAS;IACT,SAAS;IACT,OAAO;IACP,iBAAiB;CAClB,CAAC","sourcesContent":["/*\n * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @Date         : 2025-11-13 14:57:30\n * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @LastEditTime : 2025-11-13 14:57:35\n * @FilePath     : /expo-gaode-map/src/modules/AMapView.ts\n * @Description  : 高德地图视图控制模块\n * \n * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. \n */\n\nimport ExpoGaodeMapModule from '../ExpoGaodeMapModule';\nimport type { CameraPosition, Point, LatLng } from '../types';\n\n/**\n * 移动地图相机到指定位置\n * @param cameraPosition 相机位置参数\n * @param duration 动画时长（毫秒），默认为0（无动画）\n */\nexport function moveCamera(cameraPosition: CameraPosition, duration = 0): void {\n  ExpoGaodeMapModule.moveCamera?.(cameraPosition, duration);\n}\n\n/**\n * 将屏幕坐标转换为地理坐标\n * @param point 屏幕坐标点\n * @returns 地理坐标\n */\nexport async function getLatLng(point: Point): Promise<LatLng> {\n  return ExpoGaodeMapModule.getLatLng?.(point) || Promise.resolve({ latitude: 0, longitude: 0 });\n}\n\n/**\n * 设置地图中心点\n * @param center 中心点坐标\n * @param animated 是否使用动画\n */\nexport function setCenter(center: LatLng, animated = true): void {\n  ExpoGaodeMapModule.setCenter?.(center, animated);\n}\n\n/**\n * 设置地图缩放级别\n * @param zoom 缩放级别（3-20）\n * @param animated 是否使用动画\n */\nexport function setZoom(zoom: number, animated = true): void {\n  ExpoGaodeMapModule.setZoom?.(zoom, animated);\n}\n\n/**\n * 获取当前地图状态\n * @returns 当前相机位置\n */\nexport async function getCameraPosition(): Promise<CameraPosition> {\n  return ExpoGaodeMapModule.getCameraPosition?.() || Promise.resolve({\n    target: { latitude: 0, longitude: 0 },\n    zoom: 10,\n  });\n}\n\nexport default {\n  moveCamera,\n  getLatLng,\n  setCenter,\n  setZoom,\n  getCameraPosition,\n};\n"]}
+{"version":3,"file":"AMapView.js","sourceRoot":"","sources":["../../src/modules/AMapView.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,kBAAkB,MAAM,uBAAuB,CAAC;AAGvD;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,cAA8B,EAAE,QAAQ,GAAG,CAAC;IACrE,kBAAkB,CAAC,UAAU,EAAE,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAY;IAC1C,OAAO,kBAAkB,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;AACjG,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,QAAQ,GAAG,IAAI;IACvD,kBAAkB,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AACnD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,QAAQ,GAAG,IAAI;IACnD,kBAAkB,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC/C,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,OAAO,kBAAkB,CAAC,iBAAiB,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC;QACjE,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;QACrC,IAAI,EAAE,EAAE;KACT,CAAC,CAAC;AACL,CAAC;AAED,eAAe;IACb,UAAU;IACV,SAAS;IACT,SAAS;IACT,OAAO;IACP,iBAAiB;CAClB,CAAC","sourcesContent":["/*\n * @Author       : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @Date         : 2025-11-13 14:57:30\n * @LastEditors  : 尚博信_王强 wangqiang03@sunboxsoft.com\n * @LastEditTime : 2025-11-14 19:38:00\n * @FilePath     : /expo-gaode-map/src/modules/AMapView.ts\n * @Description  : 高德地图视图控制模块\n * \n * ⚠️ 警告: 此模块中的方法已不推荐使用\n * 请使用 MapView 的 ref 方式调用这些方法\n * \n * 示例:\n * const mapRef = useRef<MapViewRef>(null);\n * mapRef.current?.moveCamera({ target: { latitude: 39.9, longitude: 116.4 }, zoom: 10 });\n * \n * Copyright (c) 2025 by 尚博信_王强, All Rights Reserved. \n */\n\nimport ExpoGaodeMapModule from '../ExpoGaodeMapModule';\nimport type { CameraPosition, Point, LatLng } from '../types';\n\n/**\n * 移动地图相机到指定位置\n * @deprecated 不推荐使用,请使用 MapView ref 的 moveCamera 方法\n * @param cameraPosition 相机位置参数\n * @param duration 动画时长(毫秒),默认为0(无动画)\n */\nexport function moveCamera(cameraPosition: CameraPosition, duration = 0): void {\n  ExpoGaodeMapModule.moveCamera?.(cameraPosition, duration);\n}\n\n/**\n * 将屏幕坐标转换为地理坐标\n * @deprecated 不推荐使用,请使用 MapView ref 的 getLatLng 方法\n * @param point 屏幕坐标点\n * @returns 地理坐标\n */\nexport async function getLatLng(point: Point): Promise<LatLng> {\n  return ExpoGaodeMapModule.getLatLng?.(point) || Promise.resolve({ latitude: 0, longitude: 0 });\n}\n\n/**\n * 设置地图中心点\n * @deprecated 不推荐使用,请使用 MapView ref 的 setCenter 方法\n * @param center 中心点坐标\n * @param animated 是否使用动画\n */\nexport function setCenter(center: LatLng, animated = true): void {\n  ExpoGaodeMapModule.setCenter?.(center, animated);\n}\n\n/**\n * 设置地图缩放级别\n * @deprecated 不推荐使用,请使用 MapView ref 的 setZoom 方法\n * @param zoom 缩放级别(3-20)\n * @param animated 是否使用动画\n */\nexport function setZoom(zoom: number, animated = true): void {\n  ExpoGaodeMapModule.setZoom?.(zoom, animated);\n}\n\n/**\n * 获取当前地图状态\n * @deprecated 不推荐使用,请使用 MapView ref 的 getCameraPosition 方法\n * @returns 当前相机位置\n */\nexport async function getCameraPosition(): Promise<CameraPosition> {\n  return ExpoGaodeMapModule.getCameraPosition?.() || Promise.resolve({\n    target: { latitude: 0, longitude: 0 },\n    zoom: 10,\n  });\n}\n\nexport default {\n  moveCamera,\n  getLatLng,\n  setCenter,\n  setZoom,\n  getCameraPosition,\n};\n"]}

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

@@ -95,6 +95,7 @@ export declare enum MapType {
     Navi = 3,
     /**
      * 公交地图
+     * @platform android
      */
     Bus = 4
 }

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

@@ -1 +1 @@
-{"version":3,"file":"common.types.d.ts","sourceRoot":"","sources":["../../src/types/common.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;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;;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;;OAEG;IACH,GAAG,IAAI;CACR;AAED;;GAEG;AACH,MAAM,WAAW,QAAS,SAAQ,MAAM;IACtC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC"}
+{"version":3,"file":"common.types.d.ts","sourceRoot":"","sources":["../../src/types/common.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;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;;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;;GAEG;AACH,MAAM,WAAW,QAAS,SAAQ,MAAM;IACtC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC"}

package/build/types/common.types.js

@@ -25,6 +25,7 @@ export var MapType;
     MapType[MapType["Navi"] = 3] = "Navi";
     /**
      * 公交地图
+     * @platform android
      */
     MapType[MapType["Bus"] = 4] = "Bus";
 })(MapType || (MapType = {}));

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

@@ -1 +1 @@
-{"version":3,"file":"common.types.js","sourceRoot":"","sources":["../../src/types/common.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqFH;;GAEG;AACH,MAAM,CAAN,IAAY,OAyBX;AAzBD,WAAY,OAAO;IACjB;;OAEG;IACH,6CAAY,CAAA;IAEZ;;OAEG;IACH,+CAAa,CAAA;IAEb;;OAEG;IACH,uCAAS,CAAA;IAET;;OAEG;IACH,qCAAQ,CAAA;IAER;;OAEG;IACH,mCAAO,CAAA;AACT,CAAC,EAzBW,OAAO,KAAP,OAAO,QAyBlB","sourcesContent":["/**\n * 高德地图通用类型定义\n * 基于 Expo Modules API\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 * 地图标注点（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   */\n  Bus = 4,\n}\n\n/**\n * 定位信息（基础）\n */\nexport interface Location extends LatLng {\n  /**\n   * 精度（米）\n   */\n  accuracy: number;\n\n  /**\n   * 朝向（度）\n   */\n  heading: number;\n\n  /**\n   * 海拔（米）\n   */\n  altitude: number;\n\n  /**\n   * 运动速度（米/秒）\n   */\n  speed: number;\n\n  /**\n   * 时间戳\n   */\n  timestamp: number;\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/types/common.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqFH;;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 */\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 * 地图标注点（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 */\nexport interface Location extends LatLng {\n  /**\n   * 精度（米）\n   */\n  accuracy: number;\n\n  /**\n   * 朝向（度）\n   */\n  heading: number;\n\n  /**\n   * 海拔（米）\n   */\n  altitude: number;\n\n  /**\n   * 运动速度（米/秒）\n   */\n  speed: number;\n\n  /**\n   * 时间戳\n   */\n  timestamp: number;\n}\n\n/**\n * 颜色值类型\n * 支持：\n * - 十六进制字符串: '#AARRGGBB' 或 '#RRGGBB'\n * - 数字格式: 0xAARRGGBB (用于 Android)\n */\nexport type ColorValue = string | number;\n"]}

package/build/types/overlays.types.d.ts

@@ -111,6 +111,11 @@ export interface PolylineProps {
      * 是否绘制虚线
      */
     dotted?: boolean;
+    /**
+     * 纹理图片
+     * 支持网络图片(http/https)、本地文件(file://)或资源名称
+     */
+    texture?: string;
     /**
      * 点击事件
      */

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

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

package/build/types/overlays.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"overlays.types.js","sourceRoot":"","sources":["../../src/types/overlays.types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * 高德地图覆盖物相关类型定义\n * 基于 Expo Modules API\n */\n\nimport type { ImageSourcePropType, ViewStyle } from 'react-native';\nimport type { ColorValue, LatLng, Point } from './common.types';\n\n/**\n * 标记点属性\n */\nexport interface MarkerProps {\n  /**\n   * 坐标\n   */\n  position: LatLng;\n\n  /**\n   * 图标\n   */\n  icon?: ImageSourcePropType;\n\n  /**\n   * 标题\n   */\n  title?: string;\n\n  /**\n   * 描述\n   */\n  snippet?: string;\n\n  /**\n   * 透明度 [0, 1]\n   * @platform android\n   */\n  opacity?: number;\n\n  /**\n   * 是否可拖拽\n   */\n  draggable?: boolean;\n\n  /**\n   * 是否平贴地图\n   * @platform android\n   */\n  flat?: boolean;\n\n  /**\n   * 层级\n   */\n  zIndex?: number;\n\n  /**\n   * 覆盖物锚点比例\n   * @platform android\n   */\n  anchor?: Point;\n\n  /**\n   * 覆盖物偏移位置\n   * @platform ios\n   */\n  centerOffset?: Point;\n\n  /**\n   * 自定义视图\n   */\n  children?: React.ReactNode;\n\n  /**\n   * 点击事件\n   */\n  onPress?: () => void;\n\n  /**\n   * 拖拽开始事件\n   */\n  onDragStart?: () => void;\n\n  /**\n   * 拖拽中事件\n   */\n  onDrag?: () => void;\n\n  /**\n   * 拖拽结束事件\n   */\n  onDragEnd?: (event: { nativeEvent: LatLng }) => void;\n}\n\n/**\n * 折线属性\n */\nexport interface PolylineProps {\n  /**\n   * 节点坐标数组\n   */\n  points: LatLng[];\n\n  /**\n   * 线宽\n   */\n  width?: number;\n\n  /**\n   * 线条颜色\n   */\n  color?: ColorValue;\n\n  /**\n   * 层级\n   */\n  zIndex?: number;\n\n  /**\n   * 分段颜色\n   */\n  colors?: ColorValue[];\n\n  /**\n   * 是否使用渐变色\n   */\n  gradient?: boolean;\n\n  /**\n   * 是否绘制大地线\n   */\n  geodesic?: boolean;\n\n  /**\n   * 是否绘制虚线\n   */\n  dotted?: boolean;\n\n  /**\n   * 点击事件\n   */\n  onPress?: () => void;\n}\n\n/**\n * 多边形属性\n */\nexport interface PolygonProps {\n  /**\n   * 节点坐标数组\n   */\n  points: LatLng[];\n\n  /**\n   * 边线宽度\n   */\n  strokeWidth?: number;\n\n  /**\n   * 边线颜色\n   */\n  strokeColor?: ColorValue;\n\n  /**\n   * 填充颜色\n   */\n  fillColor?: ColorValue;\n\n  /**\n   * 层级\n   */\n  zIndex?: number;\n\n  /**\n   * 点击事件\n   */\n  onPress?: () => void;\n}\n\n/**\n * 圆形属性\n */\nexport interface CircleProps {\n  /**\n   * 圆心坐标\n   */\n  center: LatLng;\n\n  /**\n   * 半径（米）\n   */\n  radius: number;\n\n  /**\n   * 边线宽度\n   */\n  strokeWidth?: number;\n\n  /**\n   * 边线颜色\n   */\n  strokeColor?: ColorValue;\n\n  /**\n   * 填充颜色\n   */\n  fillColor?: ColorValue;\n\n  /**\n   * 层级\n   */\n  zIndex?: number;\n\n  /**\n   * 点击事件\n   */\n  onPress?: () => void;\n}\n\n/**\n * 热力图属性\n */\nexport interface HeatMapProps {\n  /**\n   * 热力点数据\n   */\n  data: LatLng[];\n\n  /**\n   * 热力半径（米）\n   */\n  radius?: number;\n\n  /**\n   * 透明度 [0, 1]\n   */\n  opacity?: number;\n}\n\n/**\n * 海量点标记项\n */\nexport interface MultiPointItem extends LatLng {\n  /**\n   * 唯一标识\n   */\n  id?: string | number;\n\n  /**\n   * 自定义数据\n   */\n  data?: any;\n}\n\n/**\n * 海量点属性\n */\nexport interface MultiPointProps {\n  /**\n   * 点集合\n   */\n  items: MultiPointItem[];\n\n  /**\n   * 图标\n   */\n  icon?: ImageSourcePropType;\n\n  /**\n   * 点击事件\n   */\n  onPress?: (event: { nativeEvent: { index: number; item: MultiPointItem } }) => void;\n}\n\n/**\n * 聚合点参数\n */\nexport interface ClusterParams {\n  /**\n   * 唯一标识\n   */\n  id: number;\n\n  /**\n   * 包含的标记点数量\n   */\n  count: number;\n\n  /**\n   * 聚合点坐标\n   */\n  position: LatLng;\n}\n\n/**\n * 聚合点项\n */\nexport interface ClusterPoint {\n  /**\n   * 坐标\n   */\n  position: LatLng;\n\n  /**\n   * 自定义数据\n   */\n  properties?: any;\n}\n\n/**\n * 聚合图层属性\n */\nexport interface ClusterProps {\n  /**\n   * 聚合半径\n   */\n  radius?: number;\n\n  /**\n   * 聚合点样式\n   */\n  clusterStyle?: ViewStyle;\n\n  /**\n   * 聚合点文本样式\n   */\n  clusterTextStyle?: ViewStyle;\n\n  /**\n   * 坐标点列表\n   */\n  points: ClusterPoint[];\n\n  /**\n   * 渲染标记点\n   */\n  renderMarker: (item: ClusterPoint) => React.ReactNode;\n\n  /**\n   * 渲染聚合点\n   */\n  renderCluster?: (params: ClusterParams) => React.ReactNode;\n\n  /**\n   * 聚合点点击事件\n   */\n  onPress?: (params: ClusterParams) => void;\n}\n"]}
+{"version":3,"file":"overlays.types.js","sourceRoot":"","sources":["../../src/types/overlays.types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * 高德地图覆盖物相关类型定义\n * 基于 Expo Modules API\n */\n\nimport type { ImageSourcePropType, ViewStyle } from 'react-native';\nimport type { ColorValue, LatLng, Point } from './common.types';\n\n/**\n * 标记点属性\n */\nexport interface MarkerProps {\n  /**\n   * 坐标\n   */\n  position: LatLng;\n\n  /**\n   * 图标\n   */\n  icon?: ImageSourcePropType;\n\n  /**\n   * 标题\n   */\n  title?: string;\n\n  /**\n   * 描述\n   */\n  snippet?: string;\n\n  /**\n   * 透明度 [0, 1]\n   * @platform android\n   */\n  opacity?: number;\n\n  /**\n   * 是否可拖拽\n   */\n  draggable?: boolean;\n\n  /**\n   * 是否平贴地图\n   * @platform android\n   */\n  flat?: boolean;\n\n  /**\n   * 层级\n   */\n  zIndex?: number;\n\n  /**\n   * 覆盖物锚点比例\n   * @platform android\n   */\n  anchor?: Point;\n\n  /**\n   * 覆盖物偏移位置\n   * @platform ios\n   */\n  centerOffset?: Point;\n\n  /**\n   * 自定义视图\n   */\n  children?: React.ReactNode;\n\n  /**\n   * 点击事件\n   */\n  onPress?: () => void;\n\n  /**\n   * 拖拽开始事件\n   */\n  onDragStart?: () => void;\n\n  /**\n   * 拖拽中事件\n   */\n  onDrag?: () => void;\n\n  /**\n   * 拖拽结束事件\n   */\n  onDragEnd?: (event: { nativeEvent: LatLng }) => void;\n}\n\n/**\n * 折线属性\n */\nexport interface PolylineProps {\n  /**\n   * 节点坐标数组\n   */\n  points: LatLng[];\n\n  /**\n   * 线宽\n   */\n  width?: number;\n\n  /**\n   * 线条颜色\n   */\n  color?: ColorValue;\n\n  /**\n   * 层级\n   */\n  zIndex?: number;\n\n  /**\n   * 分段颜色\n   */\n  colors?: ColorValue[];\n\n  /**\n   * 是否使用渐变色\n   */\n  gradient?: boolean;\n\n  /**\n   * 是否绘制大地线\n   */\n  geodesic?: boolean;\n\n  /**\n   * 是否绘制虚线\n   */\n  dotted?: boolean;\n\n  /**\n   * 纹理图片\n   * 支持网络图片(http/https)、本地文件(file://)或资源名称\n   */\n  texture?: string;\n\n  /**\n   * 点击事件\n   */\n  onPress?: () => void;\n}\n\n/**\n * 多边形属性\n */\nexport interface PolygonProps {\n  /**\n   * 节点坐标数组\n   */\n  points: LatLng[];\n\n  /**\n   * 边线宽度\n   */\n  strokeWidth?: number;\n\n  /**\n   * 边线颜色\n   */\n  strokeColor?: ColorValue;\n\n  /**\n   * 填充颜色\n   */\n  fillColor?: ColorValue;\n\n  /**\n   * 层级\n   */\n  zIndex?: number;\n\n  /**\n   * 点击事件\n   */\n  onPress?: () => void;\n}\n\n/**\n * 圆形属性\n */\nexport interface CircleProps {\n  /**\n   * 圆心坐标\n   */\n  center: LatLng;\n\n  /**\n   * 半径（米）\n   */\n  radius: number;\n\n  /**\n   * 边线宽度\n   */\n  strokeWidth?: number;\n\n  /**\n   * 边线颜色\n   */\n  strokeColor?: ColorValue;\n\n  /**\n   * 填充颜色\n   */\n  fillColor?: ColorValue;\n\n  /**\n   * 层级\n   */\n  zIndex?: number;\n\n  /**\n   * 点击事件\n   */\n  onPress?: () => void;\n}\n\n/**\n * 热力图属性\n */\nexport interface HeatMapProps {\n  /**\n   * 热力点数据\n   */\n  data: LatLng[];\n\n  /**\n   * 热力半径（米）\n   */\n  radius?: number;\n\n  /**\n   * 透明度 [0, 1]\n   */\n  opacity?: number;\n}\n\n/**\n * 海量点标记项\n */\nexport interface MultiPointItem extends LatLng {\n  /**\n   * 唯一标识\n   */\n  id?: string | number;\n\n  /**\n   * 自定义数据\n   */\n  data?: any;\n}\n\n/**\n * 海量点属性\n */\nexport interface MultiPointProps {\n  /**\n   * 点集合\n   */\n  items: MultiPointItem[];\n\n  /**\n   * 图标\n   */\n  icon?: ImageSourcePropType;\n\n  /**\n   * 点击事件\n   */\n  onPress?: (event: { nativeEvent: { index: number; item: MultiPointItem } }) => void;\n}\n\n/**\n * 聚合点参数\n */\nexport interface ClusterParams {\n  /**\n   * 唯一标识\n   */\n  id: number;\n\n  /**\n   * 包含的标记点数量\n   */\n  count: number;\n\n  /**\n   * 聚合点坐标\n   */\n  position: LatLng;\n}\n\n/**\n * 聚合点项\n */\nexport interface ClusterPoint {\n  /**\n   * 坐标\n   */\n  position: LatLng;\n\n  /**\n   * 自定义数据\n   */\n  properties?: any;\n}\n\n/**\n * 聚合图层属性\n */\nexport interface ClusterProps {\n  /**\n   * 聚合半径\n   */\n  radius?: number;\n\n  /**\n   * 聚合点样式\n   */\n  clusterStyle?: ViewStyle;\n\n  /**\n   * 聚合点文本样式\n   */\n  clusterTextStyle?: ViewStyle;\n\n  /**\n   * 坐标点列表\n   */\n  points: ClusterPoint[];\n\n  /**\n   * 渲染标记点\n   */\n  renderMarker: (item: ClusterPoint) => React.ReactNode;\n\n  /**\n   * 渲染聚合点\n   */\n  renderCluster?: (params: ClusterParams) => React.ReactNode;\n\n  /**\n   * 聚合点点击事件\n   */\n  onPress?: (params: ClusterParams) => void;\n}\n"]}

package/docs/API.md

@@ -134,7 +134,11 @@ interface MapViewRef {
 
 ## 定位 API
 
-> ⚠️ **权限要求**：所有定位 API 都需要定位权限，请确保已配置并获得用户授权
+> ⚠️ **权限要求**：所有定位 API 都需要定位权限
+>
+> 使用前请先调用 `checkLocationPermission()` 和 `requestLocationPermission()`
+>
+> 详细说明: [INITIALIZATION.md](./INITIALIZATION.md)
 
 ### 定位控制