expo-gaode-map 0.1.0

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

@@ -0,0 +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   * 当为 true 时，地图会自动移动跟随用户位置（适合导航场景）\n   * 当为 false 时，只显示定位点，不会自动移动地图（默认值，适合浏览场景）\n   * @default false\n   */\n  followUserLocation?: boolean;\n\n  /**\n   * 是否显示定位图标\n   */\n  myLocationIcon?: boolean;\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  onPress?: (event: LatLng) => void;\n\n  /**\n   * 点击标注点事件\n   */\n  onPressPoi?: (event: MapPoi) => void;\n\n  /**\n   * 长按地图事件\n   */\n  onLongPress?: (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"]}

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

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * 高德地图覆盖物相关类型定义
+ * 基于 Expo Modules API
+ */
+export {};
+//# sourceMappingURL=overlays.types.js.map

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

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

package/build/types/sdk.types.d.ts

@@ -0,0 +1,113 @@
+/**
+ * 高德地图 SDK 模块类型定义
+ * 基于 Expo Modules API
+ */
+import type { LatLng } from './common.types';
+import type { Coordinates, ReGeocode, LocationOptions, LocationListener, CoordinateType } from './location.types';
+/**
+ * SDK 初始化配置
+ */
+export interface SDKConfig {
+    /**
+     * iOS API Key
+     */
+    iosKey?: string;
+    /**
+     * Android API Key
+     */
+    androidKey?: string;
+}
+/**
+ * 高德地图 SDK 模块接口
+ */
+export interface AMapSDKModule {
+    /**
+     * 初始化 SDK
+     * @param config SDK配置
+     */
+    initSDK(config: SDKConfig): void;
+    /**
+     * 获取 SDK 版本号
+     */
+    getVersion(): Promise<string>;
+    /**
+     * 设置 API Key（单平台）
+     * @param key API密钥
+     */
+    setApiKey(key: string): void;
+}
+/**
+ * 高德定位模块接口
+ */
+export interface AMapLocationModule {
+    /**
+     * 配置定位选项
+     * @param options 定位配置选项
+     */
+    configure(options: LocationOptions): void;
+    /**
+     * 开始连续定位
+     */
+    start(): void;
+    /**
+     * 停止定位
+     */
+    stop(): void;
+    /**
+     * 是否正在定位
+     */
+    isStarted(): Promise<boolean>;
+    /**
+     * 获取当前位置（单次定位）
+     */
+    getCurrentLocation(): Promise<Coordinates | ReGeocode>;
+    /**
+     * 添加定位监听器
+     * @param listener 定位回调函数
+     * @returns 订阅对象，用于取消监听
+     */
+    addLocationListener(listener: LocationListener): {
+        remove: () => void;
+    };
+    /**
+     * 坐标转换
+     * @param coordinate 待转换的坐标
+     * @param type 坐标系类型
+     */
+    coordinateConvert(coordinate: LatLng, type: CoordinateType): Promise<LatLng>;
+    /**
+     * 开始获取设备朝向
+     * @platform ios
+     */
+    startUpdatingHeading(): void;
+    /**
+     * 停止获取设备朝向
+     * @platform ios
+     */
+    stopUpdatingHeading(): void;
+}
+/**
+ * 模块事件类型
+ */
+export interface ModuleEvents {
+    /**
+     * 定位更新事件
+     */
+    onLocationUpdate: (location: Coordinates | ReGeocode) => void;
+    /**
+     * 定位错误事件
+     */
+    onLocationError: (error: {
+        code: number;
+        message: string;
+    }) => void;
+    /**
+     * 朝向更新事件
+     * @platform ios
+     */
+    onHeadingUpdate: (heading: {
+        magneticHeading: number;
+        trueHeading: number;
+    }) => void;
+}
+//# sourceMappingURL=sdk.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.types.d.ts","sourceRoot":"","sources":["../../src/types/sdk.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,cAAc,EACf,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IAEjC;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9B;;;OAGG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IAE1C;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;OAEG;IACH,IAAI,IAAI,IAAI,CAAC;IAEb;;OAEG;IACH,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9B;;OAEG;IACH,kBAAkB,IAAI,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IAEvD;;;;OAIG;IACH,mBAAmB,CAAC,QAAQ,EAAE,gBAAgB,GAAG;QAAE,MAAM,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;IAExE;;;;OAIG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE7E;;;OAGG;IACH,oBAAoB,IAAI,IAAI,CAAC;IAE7B;;;OAGG;IACH,mBAAmB,IAAI,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,gBAAgB,EAAE,CAAC,QAAQ,EAAE,WAAW,GAAG,SAAS,KAAK,IAAI,CAAC;IAE9D;;OAEG;IACH,eAAe,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAEpE;;;OAGG;IACH,eAAe,EAAE,CAAC,OAAO,EAAE;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACtF"}

package/build/types/sdk.types.js

@@ -0,0 +1,6 @@
+/**
+ * 高德地图 SDK 模块类型定义
+ * 基于 Expo Modules API
+ */
+export {};
+//# sourceMappingURL=sdk.types.js.map

package/build/types/sdk.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.types.js","sourceRoot":"","sources":["../../src/types/sdk.types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * 高德地图 SDK 模块类型定义\n * 基于 Expo Modules API\n */\n\nimport type { LatLng } from './common.types';\nimport type { \n  Coordinates, \n  ReGeocode, \n  LocationOptions, \n  LocationListener,\n  CoordinateType \n} from './location.types';\n\n/**\n * SDK 初始化配置\n */\nexport interface SDKConfig {\n  /**\n   * iOS API Key\n   */\n  iosKey?: string;\n\n  /**\n   * Android API Key\n   */\n  androidKey?: string;\n}\n\n/**\n * 高德地图 SDK 模块接口\n */\nexport interface AMapSDKModule {\n  /**\n   * 初始化 SDK\n   * @param config SDK配置\n   */\n  initSDK(config: SDKConfig): void;\n\n  /**\n   * 获取 SDK 版本号\n   */\n  getVersion(): Promise<string>;\n\n  /**\n   * 设置 API Key（单平台）\n   * @param key API密钥\n   */\n  setApiKey(key: string): void;\n}\n\n/**\n * 高德定位模块接口\n */\nexport interface AMapLocationModule {\n  /**\n   * 配置定位选项\n   * @param options 定位配置选项\n   */\n  configure(options: LocationOptions): void;\n\n  /**\n   * 开始连续定位\n   */\n  start(): void;\n\n  /**\n   * 停止定位\n   */\n  stop(): void;\n\n  /**\n   * 是否正在定位\n   */\n  isStarted(): Promise<boolean>;\n\n  /**\n   * 获取当前位置（单次定位）\n   */\n  getCurrentLocation(): Promise<Coordinates | ReGeocode>;\n\n  /**\n   * 添加定位监听器\n   * @param listener 定位回调函数\n   * @returns 订阅对象，用于取消监听\n   */\n  addLocationListener(listener: LocationListener): { remove: () => void };\n\n  /**\n   * 坐标转换\n   * @param coordinate 待转换的坐标\n   * @param type 坐标系类型\n   */\n  coordinateConvert(coordinate: LatLng, type: CoordinateType): Promise<LatLng>;\n\n  /**\n   * 开始获取设备朝向\n   * @platform ios\n   */\n  startUpdatingHeading(): void;\n\n  /**\n   * 停止获取设备朝向\n   * @platform ios\n   */\n  stopUpdatingHeading(): void;\n}\n\n/**\n * 模块事件类型\n */\nexport interface ModuleEvents {\n  /**\n   * 定位更新事件\n   */\n  onLocationUpdate: (location: Coordinates | ReGeocode) => void;\n\n  /**\n   * 定位错误事件\n   */\n  onLocationError: (error: { code: number; message: string }) => void;\n\n  /**\n   * 朝向更新事件\n   * @platform ios\n   */\n  onHeadingUpdate: (heading: { magneticHeading: number; trueHeading: number }) => void;\n}\n"]}

package/docs/followUserLocation.md

@@ -0,0 +1,186 @@
+# followUserLocation 属性使用说明
+
+## 📖 概述
+
+`followUserLocation` 是地图组件的一个可选属性，用于控制地图是否自动跟随用户位置移动。
+
+## 🎯 使用场景
+
+### 1. **浏览模式**（默认 - `false`）
+- ✅ 显示用户定位点
+- ✅ 用户可以自由滑动地图
+- ✅ 地图**不会**自动移动
+
+**适用场景**：
+- 地图浏览
+- 查看周边信息
+- 选择地点
+
+```tsx
+<MapView
+  myLocationEnabled={true}
+  followUserLocation={false}  // 默认值，可以省略
+  style={{ flex: 1 }}
+/>
+```
+
+### 2. **导航模式**（`true`）
+- ✅ 显示用户定位点
+- ✅ 地图会自动跟随用户位置移动
+- ⚠️ 用户滑动后，定位更新时会重新跟随
+
+**适用场景**：
+- 实时导航
+- 运动轨迹记录
+- 位置追踪
+
+```tsx
+<MapView
+  myLocationEnabled={true}
+  followUserLocation={true}  // 开启跟随
+  style={{ flex: 1 }}
+/>
+```
+
+## 💡 完整示例
+
+### 可切换跟随模式
+
+```tsx
+import React, { useState } from 'react';
+import { View, Button, StyleSheet } from 'react-native';
+import { MapView } from 'expo-gaode-map';
+
+export default function App() {
+  const [followMode, setFollowMode] = useState(false);
+
+  return (
+    <View style={styles.container}>
+      <MapView
+        style={styles.map}
+        myLocationEnabled={true}
+        followUserLocation={followMode}
+        initialCameraPosition={{
+          target: { latitude: 39.9, longitude: 116.4 },
+          zoom: 15,
+        }}
+      />
+      
+      <View style={styles.controls}>
+        <Button
+          title={followMode ? '浏览模式' : '跟随模式'}
+          onPress={() => setFollowMode(!followMode)}
+        />
+      </View>
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+  },
+  map: {
+    flex: 1,
+  },
+  controls: {
+    position: 'absolute',
+    bottom: 20,
+    left: 20,
+    right: 20,
+  },
+});
+```
+
+## 📋 属性详情
+
+| 属性 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `followUserLocation` | `boolean` | `false` | 是否跟随用户位置 |
+| `myLocationEnabled` | `boolean` | `false` | 是否显示定位点（必须同时开启） |
+
+## 🔧 实现原理
+
+### Android 端定位模式
+
+| `followUserLocation` | 高德地图模式 | 行为 |
+|---------------------|------------|------|
+| `false` | `LOCATION_TYPE_SHOW` | 只显示定位点 |
+| `true` | `LOCATION_TYPE_FOLLOW` | 跟随用户位置 |
+
+## ⚠️ 注意事项
+
+1. **必须先开启定位**
+   ```tsx
+   // ❌ 错误 - 没有开启定位
+   <MapView followUserLocation={true} />
+   
+   // ✅ 正确 - 同时开启定位
+   <MapView 
+     myLocationEnabled={true}
+     followUserLocation={true}
+   />
+   ```
+
+2. **权限要求**
+   - 需要定位权限（`ACCESS_FINE_LOCATION`）
+   - 需要在 `app.json` 中配置
+
+3. **默认行为已优化**
+   - 不设置 `followUserLocation` 时，默认为 `false`
+   - 不会再出现自动跟随的问题
+
+## 🎨 UI 建议
+
+建议提供一个按钮让用户切换模式：
+
+```tsx
+<TouchableOpacity
+  style={styles.locationButton}
+  onPress={() => setFollowMode(!followMode)}
+>
+  <Icon 
+    name={followMode ? 'location-arrow' : 'location'} 
+    size={24} 
+  />
+</TouchableOpacity>
+```
+
+## 🐛 常见问题
+
+### Q: 为什么地图一直自动移动？
+A: 因为 `followUserLocation` 被设置为 `true` 或使用了旧版本。解决方法：
+```tsx
+// 方案1：不设置（默认 false）
+<MapView myLocationEnabled={true} />
+
+// 方案2：显式设置为 false
+<MapView 
+  myLocationEnabled={true}
+  followUserLocation={false}
+/>
+```
+
+### Q: 如何只在首次定位时移动地图？
+A: 使用 `onLoad` 事件：
+```tsx
+const [hasInitialized, setHasInitialized] = useState(false);
+
+<MapView
+  myLocationEnabled={true}
+  followUserLocation={false}
+  onLoad={async () => {
+    if (!hasInitialized) {
+      const position = await getCurrentLocation();
+      mapRef.current?.setCenter(position, true);
+      setHasInitialized(true);
+    }
+  }}
+/>
+```
+
+## 📚 相关文档
+
+- [MapView API 文档](./MapView.md)
+- [定位功能文档](./Location.md)
+- [高德地图官方文档](https://lbs.amap.com/api/android-sdk/guide/map/mylocation)

package/expo-module.config.json

@@ -0,0 +1,9 @@
+{
+  "platforms": ["apple", "android", "web"],
+  "apple": {
+    "modules": ["ExpoGaodeMapModule"]
+  },
+  "android": {
+    "modules": ["expo.modules.gaodemap.ExpoGaodeMapModule"]
+  }
+}

package/ios/ExpoGaodeMap.podspec

@@ -0,0 +1,29 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, '..', 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name           = 'ExpoGaodeMap'
+  s.version        = package['version']
+  s.summary        = package['description']
+  s.description    = package['description']
+  s.license        = package['license']
+  s.author         = package['author']
+  s.homepage       = package['homepage']
+  s.platforms      = {
+    :ios => '15.1',
+    :tvos => '15.1'
+  }
+  s.swift_version  = '5.9'
+  s.source         = { git: 'https://github.com/TomWq/expo-gaode-map' }
+  s.static_framework = true
+
+  s.dependency 'ExpoModulesCore'
+  s.dependency 'AMap3DMap', '10.0.600'
+  # Swift/Objective-C compatibility
+  s.pod_target_xcconfig = {
+    'DEFINES_MODULE' => 'YES',
+  }
+
+  s.source_files = "**/*.{h,m,mm,swift,hpp,cpp}"
+end