expo-gaode-map 1.0.2 → 1.0.4

package/build/components/overlays/Polyline.js

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { MapContext } from '../../ExpoGaodeMapView';
+import { MapContext, PolylineEventContext } from '../../ExpoGaodeMapView';
 /**
  * Polyline 组件用于在高德地图上绘制折线
  *
@@ -7,6 +7,7 @@ import { MapContext } from '../../ExpoGaodeMapView';
  * @param props.points - 折线的坐标点数组
  * @param props.width - 折线的宽度（像素）
  * @param props.color - 折线的颜色（十六进制或RGBA）
+ * @param props.onPress - 折线点击事件回调函数
  * @param [props.texture] - 可选，折线的纹理样式
  *
  * @remarks
@@ -17,21 +18,46 @@ import { MapContext } from '../../ExpoGaodeMapView';
  */
 export default function Polyline(props) {
     const mapRef = React.useContext(MapContext);
+    const eventManager = React.useContext(PolylineEventContext);
     const polylineIdRef = React.useRef(null);
-    // 添加折线
+    const propsRef = React.useRef(props);
     React.useEffect(() => {
-        const polylineId = `polyline_${Date.now()}_${Math.random()}`;
-        polylineIdRef.current = polylineId;
-        // 只传递必要的属性
-        const polylineProps = {
-            points: props.points,
-            width: props.width,
-            color: props.color,
-            ...(props.texture && { texture: props.texture }),
+        propsRef.current = props;
+    }, [props]);
+    React.useEffect(() => {
+        const checkAndAdd = () => {
+            if (!mapRef?.current) {
+                setTimeout(checkAndAdd, 50);
+                return;
+            }
+            const polylineId = `polyline_${Date.now()}_${Math.random()}`;
+            polylineIdRef.current = polylineId;
+            if (eventManager && props.onPress) {
+                eventManager.register(polylineId, {
+                    onPress: props.onPress,
+                });
+            }
+            const polylineProps = {
+                points: propsRef.current.points,
+                width: propsRef.current.width,
+                color: propsRef.current.color,
+                ...(propsRef.current.texture && { texture: propsRef.current.texture }),
+                ...(propsRef.current.dotted !== undefined && { dotted: propsRef.current.dotted }),
+                ...(propsRef.current.geodesic !== undefined && { geodesic: propsRef.current.geodesic }),
+                ...(propsRef.current.zIndex !== undefined && { zIndex: propsRef.current.zIndex }),
+            };
+            mapRef.current.addPolyline(polylineId, polylineProps);
         };
-        mapRef?.current?.addPolyline?.(polylineId, polylineProps);
+        checkAndAdd();
         return () => {
-            mapRef?.current?.removePolyline?.(polylineId);
+            if (polylineIdRef.current) {
+                if (eventManager) {
+                    eventManager.unregister(polylineIdRef.current);
+                }
+                if (mapRef?.current) {
+                    mapRef.current.removePolyline(polylineIdRef.current);
+                }
+            }
         };
     }, []);
     return null;

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

@@ -1 +1 @@
-{"version":3,"file":"Polyline.js","sourceRoot":"","sources":["../../../src/components/overlays/Polyline.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAIpD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,KAAoB;IACnD,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAgB,IAAI,CAAC,CAAC;IAExD,OAAO;IACP,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,MAAM,UAAU,GAAG,YAAY,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QAC7D,aAAa,CAAC,OAAO,GAAG,UAAU,CAAC;QAEnC,WAAW;QACX,MAAM,aAAa,GAAG;YACpB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;SACjD,CAAC;QAEF,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QAE1D,OAAO,GAAG,EAAE;YACV,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,UAAU,CAAC,CAAC;QAChD,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["import * as React from 'react';\nimport { MapContext } from '../../ExpoGaodeMapView';\nimport type { PolylineProps } from '../../types';\n\n\n/**\n * Polyline 组件用于在高德地图上绘制折线\n * \n * @param props - 折线的配置属性\n * @param props.points - 折线的坐标点数组\n * @param props.width - 折线的宽度（像素）\n * @param props.color - 折线的颜色（十六进制或RGBA）\n * @param [props.texture] - 可选，折线的纹理样式\n * \n * @remarks\n * 组件内部使用 React 的 useEffect 钩子来管理折线的生命周期：\n * 1. 组件挂载时创建折线并添加到地图\n * 2. 组件卸载时自动从地图移除折线\n * 3. 使用 ref 保存折线ID以便清理\n */\nexport default function Polyline(props: PolylineProps) {\n  const mapRef = React.useContext(MapContext);\n  const polylineIdRef = React.useRef<string | null>(null);\n\n  // 添加折线\n  React.useEffect(() => {\n    const polylineId = `polyline_${Date.now()}_${Math.random()}`;\n    polylineIdRef.current = polylineId;\n    \n    // 只传递必要的属性\n    const polylineProps = {\n      points: props.points,\n      width: props.width,\n      color: props.color,\n      ...(props.texture && { texture: props.texture }),\n    };\n    \n    mapRef?.current?.addPolyline?.(polylineId, polylineProps);\n\n    return () => {\n      mapRef?.current?.removePolyline?.(polylineId);\n    };\n  }, []);\n\n  return null;\n}\n"]}
+{"version":3,"file":"Polyline.js","sourceRoot":"","sources":["../../../src/components/overlays/Polyline.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAI1E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,KAAoB;IACnD,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,KAAK,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAC5D,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAgB,IAAI,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAErC,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,QAAQ,CAAC,OAAO,GAAG,KAAK,CAAC;IAC3B,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,MAAM,WAAW,GAAG,GAAG,EAAE;YACvB,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBACrB,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;gBAC5B,OAAO;YACT,CAAC;YAED,MAAM,UAAU,GAAG,YAAY,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7D,aAAa,CAAC,OAAO,GAAG,UAAU,CAAC;YAEnC,IAAI,YAAY,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClC,YAAY,CAAC,QAAQ,CAAC,UAAU,EAAE;oBAChC,OAAO,EAAE,KAAK,CAAC,OAAO;iBACvB,CAAC,CAAC;YACL,CAAC;YAED,MAAM,aAAa,GAAG;gBACpB,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM;gBAC/B,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK;gBAC7B,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK;gBAC7B,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;gBACtE,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBACjF,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACvF,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;aAClF,CAAC;YAEF,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QACxD,CAAC,CAAC;QAEF,WAAW,EAAE,CAAC;QAEd,OAAO,GAAG,EAAE;YACV,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;gBAC1B,IAAI,YAAY,EAAE,CAAC;oBACjB,YAAY,CAAC,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;gBACjD,CAAC;gBACD,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;oBACpB,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["\nimport * as React from 'react';\nimport { MapContext, PolylineEventContext } from '../../ExpoGaodeMapView';\nimport type { PolylineProps } from '../../types';\n\n\n/**\n * Polyline 组件用于在高德地图上绘制折线\n * \n * @param props - 折线的配置属性\n * @param props.points - 折线的坐标点数组\n * @param props.width - 折线的宽度（像素）\n * @param props.color - 折线的颜色（十六进制或RGBA）\n * @param props.onPress - 折线点击事件回调函数\n * @param [props.texture] - 可选，折线的纹理样式\n * \n * @remarks\n * 组件内部使用 React 的 useEffect 钩子来管理折线的生命周期：\n * 1. 组件挂载时创建折线并添加到地图\n * 2. 组件卸载时自动从地图移除折线\n * 3. 使用 ref 保存折线ID以便清理\n */\nexport default function Polyline(props: PolylineProps) {\n  const mapRef = React.useContext(MapContext);\n  const eventManager = React.useContext(PolylineEventContext);\n  const polylineIdRef = React.useRef<string | null>(null);\n  const propsRef = React.useRef(props);\n  \n  React.useEffect(() => {\n    propsRef.current = props;\n  }, [props]);\n  \n  React.useEffect(() => {\n    const checkAndAdd = () => {\n      if (!mapRef?.current) {\n        setTimeout(checkAndAdd, 50);\n        return;\n      }\n      \n      const polylineId = `polyline_${Date.now()}_${Math.random()}`;\n      polylineIdRef.current = polylineId;\n      \n      if (eventManager && props.onPress) {\n        eventManager.register(polylineId, {\n          onPress: props.onPress,\n        });\n      }\n      \n      const polylineProps = {\n        points: propsRef.current.points,\n        width: propsRef.current.width,\n        color: propsRef.current.color,\n        ...(propsRef.current.texture && { texture: propsRef.current.texture }),\n        ...(propsRef.current.dotted !== undefined && { dotted: propsRef.current.dotted }),\n        ...(propsRef.current.geodesic !== undefined && { geodesic: propsRef.current.geodesic }),\n        ...(propsRef.current.zIndex !== undefined && { zIndex: propsRef.current.zIndex }),\n      };\n      \n      mapRef.current.addPolyline(polylineId, polylineProps);\n    };\n    \n    checkAndAdd();\n    \n    return () => {\n      if (polylineIdRef.current) {\n        if (eventManager) {\n          eventManager.unregister(polylineIdRef.current);\n        }\n        if (mapRef?.current) {\n          mapRef.current.removePolyline(polylineIdRef.current);\n        }\n      }\n    };\n  }, []);\n\n  return null;\n}\n"]}

package/build/types/map-view.types.d.ts

@@ -166,6 +166,48 @@ export interface MapViewProps {
      * 地图定位更新事件
      */
     onLocation?: (event: Location) => void;
+    /**
+     * Marker 点击事件
+     */
+    onMarkerPress?: (event: {
+        markerId: string;
+    } & LatLng) => void;
+    /**
+     * Marker 拖拽开始事件
+     */
+    onMarkerDragStart?: (event: {
+        markerId: string;
+    } & LatLng) => void;
+    /**
+     * Marker 拖拽中事件
+     */
+    onMarkerDrag?: (event: {
+        markerId: string;
+    } & LatLng) => void;
+    /**
+     * Marker 拖拽结束事件
+     */
+    onMarkerDragEnd?: (event: {
+        markerId: string;
+    } & LatLng) => void;
+    /**
+     * Circle 点击事件
+     */
+    onCirclePress?: (event: {
+        circleId: string;
+    } & LatLng) => void;
+    /**
+     * Polygon 点击事件
+     */
+    onPolygonPress?: (event: {
+        polygonId: string;
+    } & LatLng) => void;
+    /**
+     * Polyline 点击事件
+     */
+    onPolylinePress?: (event: {
+        polylineId: string;
+    } & LatLng) => void;
     /**
      * 子组件
      */

package/build/types/map-view.types.d.ts.map

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

package/build/types/map-view.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"map-view.types.js","sourceRoot":"","sources":["../../src/types/map-view.types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * 高德地图视图相关类型定义\n * 基于 Expo Modules API\n */\n\nimport type { StyleProp, ViewStyle } from 'react-native';\nimport type { CameraPosition, LatLng, LatLngBounds, MapPoi, MapType, Point } from './common.types';\n\n/**\n * 地图相机事件\n */\nexport interface CameraEvent {\n  /**\n   * 相机位置\n   */\n  cameraPosition: CameraPosition;\n\n  /**\n   * 可见区域边界\n   */\n  latLngBounds: LatLngBounds;\n}\n\n/**\n * 地图视图属性\n */\nexport interface MapViewProps {\n  /**\n   * 地图类型\n   */\n  mapType?: MapType;\n\n  /**\n   * 初始相机位置\n   */\n  initialCameraPosition?: CameraPosition;\n\n  /**\n   * 是否显示当前定位\n   */\n  myLocationEnabled?: boolean;\n\n  /**\n   * 是否跟随用户位置\n   * @default false\n   */\n  followUserLocation?: boolean;\n\n  /**\n   * 定位蓝点配置\n   */\n  userLocationRepresentation?: {\n    /** 精度圈是否显示 @default true */\n    showsAccuracyRing?: boolean;\n    /** 是否显示方向指示 @default true @platform ios */\n    showsHeadingIndicator?: boolean;\n    /** 精度圈填充颜色 支持 '#RRGGBB'、'red' 或 ARGB 数字 */\n    fillColor?: string | number;\n    /** 精度圈边线颜色 */\n    strokeColor?: string | number;\n    /** 精度圈边线宽度 @default 0 */\n    lineWidth?: number;\n    /** 内部蓝色圆点是否使用律动效果 @default true @platform ios */\n    enablePulseAnimation?: boolean;\n    /** 定位点背景色 @default 'white' @platform ios */\n    locationDotBgColor?: string | number;\n    /** 定位点蓝色圆点颜色 @default 'blue' @platform ios */\n    locationDotFillColor?: string | number;\n    /** 定位图标 支持网络图片(http/https)、本地文件(file://)或资源名称 */\n    image?: string;\n    /** 定位图标宽度(像素) */\n    imageWidth?: number;\n    /** 定位图标高度(像素) */\n    imageHeight?: number;\n  };\n\n  /**\n   * 是否显示室内地图\n   * \n   */\n  indoorViewEnabled?: boolean;\n\n  /**\n   * 是否显示3D建筑\n   */\n  buildingsEnabled?: boolean;\n\n  /**\n   * 是否显示标注\n   */\n  labelsEnabled?: boolean;\n\n  /**\n   * 是否显示指南针\n   */\n  compassEnabled?: boolean;\n\n  /**\n   * 是否显示缩放按钮\n   * @platform android\n   */\n  zoomControlsEnabled?: boolean;\n\n  /**\n   * 是否显示比例尺\n   */\n  scaleControlsEnabled?: boolean;\n\n  /**\n   * 是否显示定位按钮\n   * @platform android\n   */\n  myLocationButtonEnabled?: boolean;\n\n  /**\n   * 是否显示路况\n   */\n  trafficEnabled?: boolean;\n\n  /**\n   * 最大缩放级别\n   */\n  maxZoom?: number;\n\n  /**\n   * 最小缩放级别\n   */\n  minZoom?: number;\n\n  /**\n   * 是否启用缩放手势\n   */\n  zoomGesturesEnabled?: boolean;\n\n  /**\n   * 是否启用滑动手势\n   */\n  scrollGesturesEnabled?: boolean;\n\n  /**\n   * 是否启用旋转手势\n   */\n  rotateGesturesEnabled?: boolean;\n\n  /**\n   * 是否启用倾斜手势\n   */\n  tiltGesturesEnabled?: boolean;\n\n  /**\n   * 定位的最小更新距离（米）\n   * @platform ios\n   */\n  distanceFilter?: number;\n\n  /**\n   * 最小更新角度（度）\n   * @platform ios\n   */\n  headingFilter?: number;\n\n  /**\n   * 样式\n   */\n  style?: StyleProp<ViewStyle>;\n\n  /**\n   * 点击地图事件\n   */\n  onMapPress?: (event: LatLng) => void;\n\n  /**\n   * 点击标注点事件\n   */\n  onPressPoi?: (event: MapPoi) => void;\n\n  /**\n   * 长按地图事件\n   */\n  onMapLongPress?: (event: LatLng) => void;\n\n  /**\n   * 地图状态改变事件（实时触发）\n   */\n  onCameraMove?: (event: CameraEvent) => void;\n\n  /**\n   * 地图状态改变完成事件\n   */\n  onCameraIdle?: (event: CameraEvent) => void;\n\n  /**\n   * 地图加载完成事件\n   */\n  onLoad?: (event: {}) => void;\n\n  /**\n   * 地图定位更新事件\n   */\n  onLocation?: (event: Location) => void;\n\n  /**\n   * 子组件\n   */\n  children?: React.ReactNode;\n}\n\n/**\n * 地图视图方法\n */\nexport interface MapViewMethods {\n  /**\n   * 移动相机\n   * @param cameraPosition 目标相机位置\n   * @param duration 动画时长（毫秒）\n   */\n  moveCamera(cameraPosition: CameraPosition, duration?: number): void;\n\n  /**\n   * 将屏幕坐标转换为地理坐标\n   * @param point 屏幕坐标\n   * @returns 地理坐标\n   */\n  getLatLng(point: Point): Promise<LatLng>;\n}\n\n/**\n * MapView Ref 公开接口（用户使用）\n */\nexport interface MapViewRef {\n  moveCamera(position: CameraPosition, duration?: number): Promise<void>;\n  getLatLng(point: Point): Promise<LatLng>;\n  setCenter(center: LatLng, animated?: boolean): Promise<void>;\n  setZoom(zoom: number, animated?: boolean): Promise<void>;\n  getCameraPosition(): Promise<CameraPosition>;\n  addCircle(id: string, props: import('./overlays.types').CircleProps): Promise<void>;\n  removeCircle(id: string): Promise<void>;\n  updateCircle(id: string, props: Partial<import('./overlays.types').CircleProps>): Promise<void>;\n  addMarker(id: string, props: import('./overlays.types').MarkerProps): Promise<void>;\n  removeMarker(id: string): Promise<void>;\n  updateMarker(id: string, props: Partial<import('./overlays.types').MarkerProps>): Promise<void>;\n  addPolyline(id: string, props: import('./overlays.types').PolylineProps): Promise<void>;\n  removePolyline(id: string): Promise<void>;\n  updatePolyline(id: string, props: Partial<import('./overlays.types').PolylineProps>): Promise<void>;\n  addPolygon(id: string, props: import('./overlays.types').PolygonProps): Promise<void>;\n  removePolygon(id: string): Promise<void>;\n  updatePolygon(id: string, props: Partial<import('./overlays.types').PolygonProps>): Promise<void>;\n}\n\n/**\n * 原生 MapView Ref 接口（所有参数必需）\n */\nexport interface NativeMapViewRef {\n  moveCamera(position: CameraPosition, duration: number): Promise<void>;\n  getLatLng(point: Point): Promise<LatLng>;\n  setCenter(center: LatLng, animated: boolean): Promise<void>;\n  setZoom(zoom: number, animated: boolean): Promise<void>;\n  getCameraPosition(): Promise<CameraPosition>;\n  addCircle(id: string, props: import('./overlays.types').CircleProps): Promise<void>;\n  removeCircle(id: string): Promise<void>;\n  updateCircle(id: string, props: Partial<import('./overlays.types').CircleProps>): Promise<void>;\n  addMarker(id: string, props: import('./overlays.types').MarkerProps): Promise<void>;\n  removeMarker(id: string): Promise<void>;\n  updateMarker(id: string, props: Partial<import('./overlays.types').MarkerProps>): Promise<void>;\n  addPolyline(id: string, props: import('./overlays.types').PolylineProps): Promise<void>;\n  removePolyline(id: string): Promise<void>;\n  updatePolyline(id: string, props: Partial<import('./overlays.types').PolylineProps>): Promise<void>;\n  addPolygon(id: string, props: import('./overlays.types').PolygonProps): Promise<void>;\n  removePolygon(id: string): Promise<void>;\n  updatePolygon(id: string, props: Partial<import('./overlays.types').PolygonProps>): Promise<void>;\n}\n"]}
+{"version":3,"file":"map-view.types.js","sourceRoot":"","sources":["../../src/types/map-view.types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * 高德地图视图相关类型定义\n * 基于 Expo Modules API\n */\n\nimport type { StyleProp, ViewStyle } from 'react-native';\nimport type { CameraPosition, LatLng, LatLngBounds, MapPoi, MapType, Point } from './common.types';\n\n/**\n * 地图相机事件\n */\nexport interface CameraEvent {\n  /**\n   * 相机位置\n   */\n  cameraPosition: CameraPosition;\n\n  /**\n   * 可见区域边界\n   */\n  latLngBounds: LatLngBounds;\n}\n\n/**\n * 地图视图属性\n */\nexport interface MapViewProps {\n  /**\n   * 地图类型\n   */\n  mapType?: MapType;\n\n  /**\n   * 初始相机位置\n   */\n  initialCameraPosition?: CameraPosition;\n\n  /**\n   * 是否显示当前定位\n   */\n  myLocationEnabled?: boolean;\n\n  /**\n   * 是否跟随用户位置\n   * @default false\n   */\n  followUserLocation?: boolean;\n\n  /**\n   * 定位蓝点配置\n   */\n  userLocationRepresentation?: {\n    /** 精度圈是否显示 @default true */\n    showsAccuracyRing?: boolean;\n    /** 是否显示方向指示 @default true @platform ios */\n    showsHeadingIndicator?: boolean;\n    /** 精度圈填充颜色 支持 '#RRGGBB'、'red' 或 ARGB 数字 */\n    fillColor?: string | number;\n    /** 精度圈边线颜色 */\n    strokeColor?: string | number;\n    /** 精度圈边线宽度 @default 0 */\n    lineWidth?: number;\n    /** 内部蓝色圆点是否使用律动效果 @default true @platform ios */\n    enablePulseAnimation?: boolean;\n    /** 定位点背景色 @default 'white' @platform ios */\n    locationDotBgColor?: string | number;\n    /** 定位点蓝色圆点颜色 @default 'blue' @platform ios */\n    locationDotFillColor?: string | number;\n    /** 定位图标 支持网络图片(http/https)、本地文件(file://)或资源名称 */\n    image?: string;\n    /** 定位图标宽度(像素) */\n    imageWidth?: number;\n    /** 定位图标高度(像素) */\n    imageHeight?: number;\n  };\n\n  /**\n   * 是否显示室内地图\n   * \n   */\n  indoorViewEnabled?: boolean;\n\n  /**\n   * 是否显示3D建筑\n   */\n  buildingsEnabled?: boolean;\n\n  /**\n   * 是否显示标注\n   */\n  labelsEnabled?: boolean;\n\n  /**\n   * 是否显示指南针\n   */\n  compassEnabled?: boolean;\n\n  /**\n   * 是否显示缩放按钮\n   * @platform android\n   */\n  zoomControlsEnabled?: boolean;\n\n  /**\n   * 是否显示比例尺\n   */\n  scaleControlsEnabled?: boolean;\n\n  /**\n   * 是否显示定位按钮\n   * @platform android\n   */\n  myLocationButtonEnabled?: boolean;\n\n  /**\n   * 是否显示路况\n   */\n  trafficEnabled?: boolean;\n\n  /**\n   * 最大缩放级别\n   */\n  maxZoom?: number;\n\n  /**\n   * 最小缩放级别\n   */\n  minZoom?: number;\n\n  /**\n   * 是否启用缩放手势\n   */\n  zoomGesturesEnabled?: boolean;\n\n  /**\n   * 是否启用滑动手势\n   */\n  scrollGesturesEnabled?: boolean;\n\n  /**\n   * 是否启用旋转手势\n   */\n  rotateGesturesEnabled?: boolean;\n\n  /**\n   * 是否启用倾斜手势\n   */\n  tiltGesturesEnabled?: boolean;\n\n  /**\n   * 定位的最小更新距离（米）\n   * @platform ios\n   */\n  distanceFilter?: number;\n\n  /**\n   * 最小更新角度（度）\n   * @platform ios\n   */\n  headingFilter?: number;\n\n  /**\n   * 样式\n   */\n  style?: StyleProp<ViewStyle>;\n\n  /**\n   * 点击地图事件\n   */\n  onMapPress?: (event: LatLng) => void;\n\n  /**\n   * 点击标注点事件\n   */\n  onPressPoi?: (event: MapPoi) => void;\n\n  /**\n   * 长按地图事件\n   */\n  onMapLongPress?: (event: LatLng) => void;\n\n  /**\n   * 地图状态改变事件（实时触发）\n   */\n  onCameraMove?: (event: CameraEvent) => void;\n\n  /**\n   * 地图状态改变完成事件\n   */\n  onCameraIdle?: (event: CameraEvent) => void;\n\n  /**\n   * 地图加载完成事件\n   */\n  onLoad?: (event: {}) => void;\n\n  /**\n   * 地图定位更新事件\n   */\n  onLocation?: (event: Location) => void;\n\n  /**\n   * Marker 点击事件\n   */\n  onMarkerPress?: (event: { markerId: string } & LatLng) => void;\n\n  /**\n   * Marker 拖拽开始事件\n   */\n  onMarkerDragStart?: (event: { markerId: string } & LatLng) => void;\n\n  /**\n   * Marker 拖拽中事件\n   */\n  onMarkerDrag?: (event: { markerId: string } & LatLng) => void;\n\n  /**\n   * Marker 拖拽结束事件\n   */\n  onMarkerDragEnd?: (event: { markerId: string } & LatLng) => void;\n\n  /**\n   * Circle 点击事件\n   */\n  onCirclePress?: (event: { circleId: string } & LatLng) => void;\n\n  /**\n   * Polygon 点击事件\n   */\n  onPolygonPress?: (event: { polygonId: string } & LatLng) => void;\n\n  /**\n   * Polyline 点击事件\n   */\n  onPolylinePress?: (event: { polylineId: string } & LatLng) => void;\n\n  /**\n   * 子组件\n   */\n  children?: React.ReactNode;\n}\n\n/**\n * 地图视图方法\n */\nexport interface MapViewMethods {\n  /**\n   * 移动相机\n   * @param cameraPosition 目标相机位置\n   * @param duration 动画时长（毫秒）\n   */\n  moveCamera(cameraPosition: CameraPosition, duration?: number): void;\n\n  /**\n   * 将屏幕坐标转换为地理坐标\n   * @param point 屏幕坐标\n   * @returns 地理坐标\n   */\n  getLatLng(point: Point): Promise<LatLng>;\n}\n\n/**\n * MapView Ref 公开接口（用户使用）\n */\nexport interface MapViewRef {\n  moveCamera(position: CameraPosition, duration?: number): Promise<void>;\n  getLatLng(point: Point): Promise<LatLng>;\n  setCenter(center: LatLng, animated?: boolean): Promise<void>;\n  setZoom(zoom: number, animated?: boolean): Promise<void>;\n  getCameraPosition(): Promise<CameraPosition>;\n  addCircle(id: string, props: import('./overlays.types').CircleProps): Promise<void>;\n  removeCircle(id: string): Promise<void>;\n  updateCircle(id: string, props: Partial<import('./overlays.types').CircleProps>): Promise<void>;\n  addMarker(id: string, props: import('./overlays.types').MarkerProps): Promise<void>;\n  removeMarker(id: string): Promise<void>;\n  updateMarker(id: string, props: Partial<import('./overlays.types').MarkerProps>): Promise<void>;\n  addPolyline(id: string, props: import('./overlays.types').PolylineProps): Promise<void>;\n  removePolyline(id: string): Promise<void>;\n  updatePolyline(id: string, props: Partial<import('./overlays.types').PolylineProps>): Promise<void>;\n  addPolygon(id: string, props: import('./overlays.types').PolygonProps): Promise<void>;\n  removePolygon(id: string): Promise<void>;\n  updatePolygon(id: string, props: Partial<import('./overlays.types').PolygonProps>): Promise<void>;\n}\n\n/**\n * 原生 MapView Ref 接口（所有参数必需）\n */\nexport interface NativeMapViewRef {\n  moveCamera(position: CameraPosition, duration: number): Promise<void>;\n  getLatLng(point: Point): Promise<LatLng>;\n  setCenter(center: LatLng, animated: boolean): Promise<void>;\n  setZoom(zoom: number, animated: boolean): Promise<void>;\n  getCameraPosition(): Promise<CameraPosition>;\n  addCircle(id: string, props: import('./overlays.types').CircleProps): Promise<void>;\n  removeCircle(id: string): Promise<void>;\n  updateCircle(id: string, props: Partial<import('./overlays.types').CircleProps>): Promise<void>;\n  addMarker(id: string, props: import('./overlays.types').MarkerProps): Promise<void>;\n  removeMarker(id: string): Promise<void>;\n  updateMarker(id: string, props: Partial<import('./overlays.types').MarkerProps>): Promise<void>;\n  addPolyline(id: string, props: import('./overlays.types').PolylineProps): Promise<void>;\n  removePolyline(id: string): Promise<void>;\n  updatePolyline(id: string, props: Partial<import('./overlays.types').PolylineProps>): Promise<void>;\n  addPolygon(id: string, props: import('./overlays.types').PolygonProps): Promise<void>;\n  removePolygon(id: string): Promise<void>;\n  updatePolygon(id: string, props: Partial<import('./overlays.types').PolygonProps>): Promise<void>;\n}\n"]}

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

@@ -15,7 +15,15 @@ export interface MarkerProps {
     /**
      * 图标
      */
-    icon?: ImageSourcePropType;
+    icon?: string | ImageSourcePropType;
+    /**
+     * 图标宽度（像素）
+     */
+    iconWidth?: number;
+    /**
+     * 图标高度（像素）
+     */
+    iconHeight?: number;
     /**
      * 标题
      */
@@ -27,6 +35,7 @@ export interface MarkerProps {
     /**
      * 透明度 [0, 1]
      * @platform android
+     * @note iOS 不支持
      */
     opacity?: number;
     /**
@@ -36,15 +45,19 @@ export interface MarkerProps {
     /**
      * 是否平贴地图
      * @platform android
+     * @note iOS 不支持
      */
     flat?: boolean;
     /**
      * 层级
+     * @platform android
+     * @note iOS 不支持 (使用 displayPriority)
      */
     zIndex?: number;
     /**
      * 覆盖物锚点比例
      * @platform android
+     * @note iOS 使用 centerOffset
      */
     anchor?: Point;
     /**
@@ -52,8 +65,19 @@ export interface MarkerProps {
      * @platform ios
      */
     centerOffset?: Point;
+    /**
+     * 是否显示动画
+     * @platform ios
+     */
+    animatesDrop?: boolean;
+    /**
+     * 大头针颜色
+     * @platform ios
+     */
+    pinColor?: 'red' | 'green' | 'purple';
     /**
      * 自定义视图
+     * @note 未实现
      */
     children?: React.ReactNode;
     /**
@@ -101,14 +125,20 @@ export interface PolylineProps {
     colors?: ColorValue[];
     /**
      * 是否使用渐变色
+     * @platform android
+     * @note iOS 不支持
      */
     gradient?: boolean;
     /**
      * 是否绘制大地线
+     * @platform android
+     * @note iOS 不支持
      */
     geodesic?: boolean;
     /**
      * 是否绘制虚线
+     * @platform android
+     * @note iOS 不支持
      */
     dotted?: boolean;
     /**

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   * 支持网络图片(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"]}
+{"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?: string | ImageSourcePropType;\n\n  /**\n   * 图标宽度（像素）\n   */\n  iconWidth?: number;\n\n  /**\n   * 图标高度（像素）\n   */\n  iconHeight?: number;\n\n  /**\n   * 标题\n   */\n  title?: string;\n\n  /**\n   * 描述\n   */\n  snippet?: string;\n\n  /**\n   * 透明度 [0, 1]\n   * @platform android\n   * @note iOS 不支持\n   */\n  opacity?: number;\n\n  /**\n   * 是否可拖拽\n   */\n  draggable?: boolean;\n\n  /**\n   * 是否平贴地图\n   * @platform android\n   * @note iOS 不支持\n   */\n  flat?: boolean;\n\n  /**\n   * 层级\n   * @platform android\n   * @note iOS 不支持 (使用 displayPriority)\n   */\n  zIndex?: number;\n\n  /**\n   * 覆盖物锚点比例\n   * @platform android\n   * @note iOS 使用 centerOffset\n   */\n  anchor?: Point;\n\n  /**\n   * 覆盖物偏移位置\n   * @platform ios\n   */\n  centerOffset?: Point;\n\n  /**\n   * 是否显示动画\n   * @platform ios\n   */\n  animatesDrop?: boolean;\n\n  /**\n   * 大头针颜色\n   * @platform ios\n   */\n  pinColor?: 'red' | 'green' | 'purple';\n\n  /**\n   * 自定义视图\n   * @note 未实现\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   * @platform android\n   * @note iOS 不支持\n   */\n  gradient?: boolean;\n\n  /**\n   * 是否绘制大地线\n   * @platform android\n   * @note iOS 不支持\n   */\n  geodesic?: boolean;\n\n  /**\n   * 是否绘制虚线\n   * @platform android\n   * @note iOS 不支持\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 * 热力图属性\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

@@ -167,26 +167,37 @@ configure({
 
 #### 单独配置方法
 
+> **平台支持说明**：部分配置方法仅在特定平台有效，其他平台会静默忽略
+
+##### 通用配置（全平台支持）
+
 | 方法 | 参数 | 说明 |
 |------|------|------|
 | `setLocatingWithReGeocode` | `boolean` | 是否返回逆地理信息 |
-| `setLocationMode` | `0 \| 1 \| 2` | 定位模式 |
-| `setInterval` | `number` | 定位间隔（毫秒） |
+| `setInterval` | `number` | 定位间隔（毫秒）/ 距离过滤（米） |
+| `setGeoLanguage` | `string` | 逆地理语言 |
+
+##### Android 专用配置
+
+| 方法 | 参数 | 说明 |
+|------|------|------|
+| `setLocationMode` | `0 \| 1 \| 2` | 定位模式（0: 高精度, 1: 省电, 2: 仅设备） |
 | `setOnceLocation` | `boolean` | 是否单次定位 |
 | `setSensorEnable` | `boolean` | 是否使用设备传感器 |
 | `setWifiScan` | `boolean` | 是否允许 WiFi 扫描 |
 | `setGpsFirst` | `boolean` | 是否 GPS 优先 |
-| `setGeoLanguage` | `string` | 逆地理语言 |
-| `setLocationCacheEnable` | `boolean` | 是否使用缓存策略（Android） |
-| `setHttpTimeOut` | `number` | 网络请求超时（Android） |
+| `setOnceLocationLatest` | `boolean` | 是否等待 WiFi 列表刷新 |
+| `setLocationCacheEnable` | `boolean` | 是否使用缓存策略 |
+| `setHttpTimeOut` | `number` | 网络请求超时（毫秒） |
 
-#### iOS 特有配置
+##### iOS 专用配置
 
 | 方法 | 参数 | 说明 |
 |------|------|------|
 | `setLocationTimeout` | `number` | 定位超时时间（秒） |
 | `setReGeocodeTimeout` | `number` | 逆地理超时时间（秒） |
-| `setDesiredAccuracy` | `number` | 期望精度（米） |
+| `setDesiredAccuracy` | `number` | 期望精度（0-5，0: 最适合导航, 1: 最佳, 2: 10米, 3: 100米, 4: 1公里, 5: 3公里） |
+| `setDistanceFilter` | `number` | 距离过滤器（米） |
 | `setPausesLocationUpdatesAutomatically` | `boolean` | 是否自动暂停定位更新 |
 | `setAllowsBackgroundLocationUpdates` | `boolean` | 是否允许后台定位 |
 
@@ -203,6 +214,109 @@ configure({
 |------|------|--------|------|
 | `coordinateConvert` | `coordinate, type` | `Promise<LatLng>` | 坐标转换为高德坐标 |
 
+## 覆盖物组件
+
+> **事件回调说明**：所有覆盖物的事件回调（如 `onPress`）仅在**声明式用法**中有效。使用命令式 API（如 `addCircle`、`addMarker` 等）添加的覆盖物无法触发这些事件。
+
+### Circle (圆形)
+
+#### 属性
+
+| 属性 | 类型 | 平台 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| `center` | `LatLng` | 全平台 | - | 圆心坐标（必需） |
+| `radius` | `number` | 全平台 | - | 半径（米） |
+| `fillColor` | `string` | 全平台 | - | 填充颜色（ARGB 格式：`#AARRGGBB`） |
+| `strokeColor` | `string` | 全平台 | - | 边框颜色（ARGB 格式：`#AARRGGBB`） |
+| `strokeWidth` | `number` | 全平台 | `1` | 边框宽度（点/dp） |
+
+#### 事件
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| `onPress` | `() => void` | 点击圆形 |
+
+### Polyline (折线)
+
+#### 属性
+
+| 属性 | 类型 | 平台 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| `points` | `LatLng[]` | 全平台 | - | 折线坐标点数组（必需） |
+| `width` | `number` | 全平台 | `5` | 线宽（点/dp） |
+| `color` | `string` | 全平台 | - | 线条颜色（ARGB 格式：`#AARRGGBB`） |
+| `texture` | `string` | 全平台 | - | 纹理图片 URL |
+| `dotted` | `boolean` | 仅 Android | `false` | 是否绘制虚线 |
+| `geodesic` | `boolean` | 仅 Android | `false` | 是否绘制大地曲线 |
+| `zIndex` | `number` | 全平台 | `0` | 层级 |
+
+#### 事件
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| `onPress` | `() => void` | 点击折线 |
+
+> **纹理说明**：
+> - 支持网络图片（http/https）和本地文件（使用 `Image.resolveAssetSource()`）
+> - 纹理会沿着折线方向平铺显示
+> - 建议纹理折线使用较大的 `width` 值（如 20）以获得更好的显示效果
+> - **分段纹理限制**：单个 Polyline 只能设置一个纹理。如需不同线段使用不同纹理，请创建多个 Polyline 组件
+
+### Polygon (多边形)
+
+#### 属性
+
+| 属性 | 类型 | 平台 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| `points` | `LatLng[]` | 全平台 | - | 多边形顶点坐标数组（必需） |
+| `fillColor` | `string` | 全平台 | - | 填充颜色（ARGB 格式：`#AARRGGBB`） |
+| `strokeColor` | `string` | 全平台 | - | 边框颜色（ARGB 格式：`#AARRGGBB`） |
+| `strokeWidth` | `number` | 全平台 | `1` | 边框宽度（点/dp） |
+
+#### 事件
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| `onPress` | `() => void` | 点击多边形 |
+
+### Marker (标记点)
+
+#### 属性
+
+| 属性 | 类型 | 平台 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| `position` | `LatLng` | 全平台 | - | 标记点坐标（必需） |
+| `title` | `string` | 全平台 | - | 标题 |
+| `snippet` | `string` | 全平台 | - | 描述信息 |
+| `draggable` | `boolean` | 全平台 | `false` | 是否可拖拽 |
+| `icon` | `string \| ImageSourcePropType` | 全平台 | - | 自定义图标 |
+| `iconWidth` | `number` | 全平台 | `40` | 图标宽度（点/dp） |
+| `iconHeight` | `number` | 全平台 | `40` | 图标高度（点/dp） |
+| `opacity` | `number` | 仅 Android | `1.0` | 透明度 [0, 1] |
+| `flat` | `boolean` | 仅 Android | `false` | 是否平贴地图 |
+| `zIndex` | `number` | 仅 Android | `0` | 层级 |
+| `anchor` | `Point` | 仅 Android | `{x: 0.5, y: 1.0}` | 锚点比例 |
+| `centerOffset` | `Point` | 仅 iOS | - | 中心偏移 |
+| `animatesDrop` | `boolean` | 仅 iOS | `false` | 是否显示掉落动画 |
+| `pinColor` | `'red' \| 'green' \| 'purple'` | 仅 iOS | `'red'` | 大头针颜色 |
+
+#### 事件
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| `onPress` | `() => void` | 点击标记点 |
+| `onDragStart` | `() => void` | 开始拖拽 |
+| `onDrag` | `() => void` | 拖拽中 |
+| `onDragEnd` | `(event: { nativeEvent: LatLng }) => void` | 拖拽结束 |
+
+> **⚠️ 重要提示**：事件回调仅在**声明式用法**中有效。使用命令式 API（`addMarker`）添加的标记点无法触发这些事件。
+
+#### 图标说明
+
+- **图标格式**：支持网络图片（http/https）、本地文件（使用 `Image.resolveAssetSource()`）
+- **尺寸单位**：`iconWidth` 和 `iconHeight` 使用点(points)作为单位，在不同密度屏幕上会自动缩放
+- **锚点**：`anchor` 定义图标相对于坐标点的位置，`{x: 0.5, y: 1.0}` 表示图标底部中心对齐坐标点
+
 ## 类型定义
 
 ### MapType

package/docs/EXAMPLES.md

@@ -450,16 +450,18 @@ await mapRef.current?.removeCircle('circle1');
 
 ### Marker (标记点)
 
+#### 基础用法
+
 **声明式用法:**
 ```tsx
 <MapView style={{ flex: 1 }}>
   <Marker
     position={{ latitude: 39.9, longitude: 116.4 }}
     title="标题"
-    description="描述信息"
+    snippet="描述信息"
     draggable={true}
     onPress={() => console.log('点击标记')}
-    onDragEnd={(e) => console.log('拖动结束', e)}
+    onDragEnd={(e) => console.log('拖动结束', e.nativeEvent)}
   />
 </MapView>
 ```
@@ -469,6 +471,7 @@ await mapRef.current?.removeCircle('circle1');
 await mapRef.current?.addMarker('marker1', {
   position: { latitude: 39.9, longitude: 116.4 },
   title: '标题',
+  snippet: '描述信息',
   draggable: true,
 });
 
@@ -479,6 +482,87 @@ await mapRef.current?.updateMarker('marker1', {
 await mapRef.current?.removeMarker('marker1');
 ```
 
+> **⚠️ 限制**：命令式 API 添加的 Marker **不支持事件回调**（onPress, onDragEnd 等）。如需事件处理，请使用声明式 `<Marker>` 组件。
+
+#### 自定义图标
+
+```tsx
+import { Image } from 'react-native';
+
+// 获取本地图片 URI
+const iconUri = Image.resolveAssetSource(require('./assets/marker-icon.png')).uri;
+
+<MapView style={{ flex: 1 }}>
+  <Marker
+    position={{ latitude: 39.9, longitude: 116.4 }}
+    title="自定义图标"
+    icon={iconUri}
+    iconWidth={50}
+    iconHeight={50}
+    onPress={() => console.log('点击自定义图标标记')}
+  />
+</MapView>
+```
+
+> **注意**：
+> - `iconWidth` 和 `iconHeight` 使用点(points)作为单位
+> - 在不同密度屏幕上会自动缩放，保持视觉一致性
+> - 支持网络图片（http/https）和本地图片
+
+#### Android 特有属性
+
+```tsx
+<MapView style={{ flex: 1 }}>
+  <Marker
+    position={{ latitude: 39.9, longitude: 116.4 }}
+    title="Android 特性"
+    opacity={0.8}
+    flat={true}
+    zIndex={10}
+    anchor={{ x: 0.5, y: 1.0 }}
+  />
+</MapView>
+```
+
+#### iOS 特有属性
+
+```tsx
+import { Platform } from 'react-native';
+
+<MapView style={{ flex: 1 }}>
+  {Platform.OS === 'ios' && (
+    <Marker
+      position={{ latitude: 39.9, longitude: 116.4 }}
+      title="iOS 特性"
+      pinColor="green"
+      animatesDrop={true}
+      centerOffset={{ x: 0, y: -20 }}
+    />
+  )}
+</MapView>
+```
+
+#### 拖拽事件处理
+
+> **注意**：事件处理仅在声明式 `<Marker>` 组件中有效
+
+```tsx
+<MapView style={{ flex: 1 }}>
+  <Marker
+    position={{ latitude: 39.9, longitude: 116.4 }}
+    title="可拖拽标记"
+    draggable={true}
+    onDragStart={() => console.log('开始拖拽')}
+    onDrag={() => console.log('拖拽中')}
+    onDragEnd={(e) => {
+      const { latitude, longitude } = e.nativeEvent;
+      console.log(`拖拽结束: ${latitude}, ${longitude}`);
+      Alert.alert('新位置', `纬度: ${latitude.toFixed(6)}\n经度: ${longitude.toFixed(6)}`);
+    }}
+  />
+</MapView>
+```
+
 ### Polyline (折线)
 
 **声明式用法 - 普通折线:**