expo-gaode-map-navigation 2.0.17 → 2.0.19

package/build/src/map/types/location.types.js

@@ -0,0 +1,93 @@
+/**
+ * 高德地图定位相关类型定义
+ * 基于 Expo Modules API
+ */
+/**
+ * 定位精度级别
+ * @platform ios
+ */
+export var LocationAccuracy;
+(function (LocationAccuracy) {
+    /**
+     * 最适合导航
+     */
+    LocationAccuracy[LocationAccuracy["BestForNavigation"] = 0] = "BestForNavigation";
+    /**
+     * 最高精度（约10米，耗时约10秒）
+     */
+    LocationAccuracy[LocationAccuracy["Best"] = 1] = "Best";
+    /**
+     * 10米精度
+     */
+    LocationAccuracy[LocationAccuracy["NearestTenMeters"] = 2] = "NearestTenMeters";
+    /**
+     * 100米精度（推荐）
+     */
+    LocationAccuracy[LocationAccuracy["HundredMeters"] = 3] = "HundredMeters";
+    /**
+     * 1公里精度
+     */
+    LocationAccuracy[LocationAccuracy["Kilometer"] = 4] = "Kilometer";
+    /**
+     * 3公里精度
+     */
+    LocationAccuracy[LocationAccuracy["ThreeKilometers"] = 5] = "ThreeKilometers";
+})(LocationAccuracy || (LocationAccuracy = {}));
+/**
+ * 定位模式
+ * @platform android
+ */
+export var LocationMode;
+(function (LocationMode) {
+    /**
+     * 高精度模式（网络+卫星）
+     */
+    LocationMode[LocationMode["HighAccuracy"] = 1] = "HighAccuracy";
+    /**
+     * 低功耗模式（仅网络）
+     */
+    LocationMode[LocationMode["BatterySaving"] = 2] = "BatterySaving";
+    /**
+     * 仅设备模式（仅卫星）
+     */
+    LocationMode[LocationMode["DeviceSensors"] = 3] = "DeviceSensors";
+})(LocationMode || (LocationMode = {}));
+/**
+ * 坐标系类型
+ */
+export var CoordinateType;
+(function (CoordinateType) {
+    /**
+     * 高德坐标系
+     */
+    CoordinateType[CoordinateType["AMap"] = -1] = "AMap";
+    /**
+     * 百度坐标系
+     */
+    CoordinateType[CoordinateType["Baidu"] = 0] = "Baidu";
+    /**
+     * MapBar坐标系
+     */
+    CoordinateType[CoordinateType["MapBar"] = 1] = "MapBar";
+    /**
+     * MapABC坐标系
+     */
+    CoordinateType[CoordinateType["MapABC"] = 2] = "MapABC";
+    /**
+     * 搜搜地图坐标系
+     */
+    CoordinateType[CoordinateType["SoSoMap"] = 3] = "SoSoMap";
+    /**
+     * 阿里云坐标系
+     */
+    CoordinateType[CoordinateType["AliYun"] = 4] = "AliYun";
+    /**
+     * 谷歌坐标系
+     */
+    CoordinateType[CoordinateType["Google"] = 5] = "Google";
+    /**
+     * GPS坐标系
+     */
+    CoordinateType[CoordinateType["GPS"] = 6] = "GPS";
+})(CoordinateType || (CoordinateType = {}));
+//# sourceMappingURL=location.types.js.map

package/build/src/map/types/location.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"location.types.js","sourceRoot":"","sources":["../../../../src/map/types/location.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmJH;;;GAGG;AACH,MAAM,CAAN,IAAY,gBA8BX;AA9BD,WAAY,gBAAgB;IAC1B;;OAEG;IACH,iFAAqB,CAAA;IAErB;;OAEG;IACH,uDAAQ,CAAA;IAER;;OAEG;IACH,+EAAoB,CAAA;IAEpB;;OAEG;IACH,yEAAiB,CAAA;IAEjB;;OAEG;IACH,iEAAa,CAAA;IAEb;;OAEG;IACH,6EAAmB,CAAA;AACrB,CAAC,EA9BW,gBAAgB,KAAhB,gBAAgB,QA8B3B;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,YAeX;AAfD,WAAY,YAAY;IACtB;;OAEG;IACH,+DAAgB,CAAA;IAEhB;;OAEG;IACH,iEAAiB,CAAA;IAEjB;;OAEG;IACH,iEAAiB,CAAA;AACnB,CAAC,EAfW,YAAY,KAAZ,YAAY,QAevB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,cAwCX;AAxCD,WAAY,cAAc;IACxB;;OAEG;IACH,oDAAS,CAAA;IAET;;OAEG;IACH,qDAAS,CAAA;IAET;;OAEG;IACH,uDAAU,CAAA;IAEV;;OAEG;IACH,uDAAU,CAAA;IAEV;;OAEG;IACH,yDAAW,CAAA;IAEX;;OAEG;IACH,uDAAU,CAAA;IAEV;;OAEG;IACH,uDAAU,CAAA;IAEV;;OAEG;IACH,iDAAO,CAAA;AACT,CAAC,EAxCW,cAAc,KAAd,cAAc,QAwCzB","sourcesContent":["/**\n * 高德地图定位相关类型定义\n * 基于 Expo Modules API\n */\n\nimport type { LatLng } from './common.types';\n\n/**\n * 坐标信息（基础定位）\n */\nexport interface Coordinates extends LatLng {\n  /**\n   * 海拔高度（米）\n   */\n  altitude: number;\n\n  /**\n   * 水平精度（米）\n   */\n  accuracy: number;\n\n  /**\n   * 移动方向（度，需要 GPS）\n   */\n  heading: number;\n\n  /**\n   * 移动速度（米/秒，需要 GPS）\n   */\n  speed: number;\n\n  /**\n   * 时间戳\n   */\n  timestamp: number;\n\n  /**\n   * 是否有可用坐标\n   * @platform ios\n   */\n  isAvailableCoordinate?: boolean;\n\n  /**\n   * 格式化地址（仅在启用逆地理编码时可用）\n   */\n  address?: string;\n\n  /**\n   * 是否来自模拟位置\n   * @platform android\n   */\n  isMock?: boolean;\n\n  /**\n   * 定位可信度等级（1-4）\n   * @platform android\n   */\n  trustedLevel?: number;\n\n  /**\n   * 是否由软件模拟产生\n   * @platform ios iOS 15+\n   */\n  isSimulatedBySoftware?: boolean;\n\n  /**\n   * 是否由外接设备产生\n   * @platform ios iOS 15+\n   */\n  isProducedByAccessory?: boolean;\n}\n\n/**\n * 逆地理编码信息\n */\nexport interface ReGeocode extends Coordinates {\n  /**\n   * 格式化地址\n   */\n  address: string;\n\n  /**\n   * 国家\n   */\n  country: string;\n\n  /**\n   * 省/直辖市，如 `湖北省`\n   */\n  province: string;\n\n  /**\n   * 市，如 `武汉市`\n   */\n  city: string;\n\n  /**\n   * 区，如 `武昌区`\n   */\n  district: string;\n\n  /**\n   * 城市编码\n   */\n  cityCode: string;\n\n  /**\n   * 区域编码\n   */\n  adCode: string;\n\n  /**\n   * 街道名称\n   */\n  street: string;\n\n  /**\n   * 门牌号\n   */\n  streetNumber: string;\n\n  /**\n   * 兴趣点名称\n   */\n  poiName: string;\n\n  /**\n   * 所属兴趣点名称\n   */\n  aoiName: string;\n\n  /**\n   * 定位信息描述\n   * @platform android\n   */\n  description?: string;\n\n  /**\n   * 坐标系类型\n   * @platform android\n   */\n  coordType?: 'GCJ02' | 'WGS84';\n\n  /**\n   * 室内定位建筑物ID\n   * @platform android\n   */\n  buildingId?: string;\n}\n\n/**\n * 定位精度级别\n * @platform ios\n */\nexport enum LocationAccuracy {\n  /**\n   * 最适合导航\n   */\n  BestForNavigation = 0,\n\n  /**\n   * 最高精度（约10米，耗时约10秒）\n   */\n  Best = 1,\n\n  /**\n   * 10米精度\n   */\n  NearestTenMeters = 2,\n\n  /**\n   * 100米精度（推荐）\n   */\n  HundredMeters = 3,\n\n  /**\n   * 1公里精度\n   */\n  Kilometer = 4,\n\n  /**\n   * 3公里精度\n   */\n  ThreeKilometers = 5,\n}\n\n/**\n * 定位模式\n * @platform android\n */\nexport enum LocationMode {\n  /**\n   * 高精度模式（网络+卫星）\n   */\n  HighAccuracy = 1,\n\n  /**\n   * 低功耗模式（仅网络）\n   */\n  BatterySaving = 2,\n\n  /**\n   * 仅设备模式（仅卫星）\n   */\n  DeviceSensors = 3,\n}\n\n/**\n * 坐标系类型\n */\nexport enum CoordinateType {\n  /**\n   * 高德坐标系\n   */\n  AMap = -1,\n\n  /**\n   * 百度坐标系\n   */\n  Baidu = 0,\n\n  /**\n   * MapBar坐标系\n   */\n  MapBar = 1,\n\n  /**\n   * MapABC坐标系\n   */\n  MapABC = 2,\n\n  /**\n   * 搜搜地图坐标系\n   */\n  SoSoMap = 3,\n\n  /**\n   * 阿里云坐标系\n   */\n  AliYun = 4,\n\n  /**\n   * 谷歌坐标系\n   */\n  Google = 5,\n\n  /**\n   * GPS坐标系\n   */\n  GPS = 6,\n}\n\n/**\n * 地理语言\n */\nexport type GeoLanguage = 'DEFAULT' | 'EN' | 'ZH';\n\n/**\n * 网络协议\n * @platform android\n */\nexport type LocationProtocol = 'HTTP' | 'HTTPS';\n\n/**\n * 定位配置选项\n */\nexport interface LocationOptions {\n  /**\n   * 是否返回逆地理信息\n   * @default true\n   */\n  withReGeocode?: boolean;\n\n  /**\n   * 定位精度\n   * @platform ios\n   */\n  accuracy?: LocationAccuracy;\n\n  /**\n   * 定位模式\n   * @platform android\n   */\n  mode?: LocationMode;\n\n  /**\n   * 是否单次定位\n   * @platform android\n   * @default false\n   */\n  onceLocation?: boolean;\n\n  /**\n   * 定位间隔（毫秒）\n   * @platform android\n   * @default 2000\n   */\n  interval?: number;\n\n  /**\n   * 定位超时时间（秒）\n   * @platform ios\n   * @default 10\n   */\n  timeout?: number;\n\n  /**\n   * 逆地理编码超时时间（秒）\n   * @platform ios\n   * @default 2\n   */\n  reGeocodeTimeout?: number;\n\n  /**\n   * 最小更新距离（米）\n   * @platform ios\n   */\n  distanceFilter?: number;\n\n  /**\n   * 是否启用设备传感器\n   * @platform android\n   * @default false\n   */\n  sensorEnable?: boolean;\n\n  /**\n   * 是否允许WIFI刷新\n   * @platform android\n   * @default true\n   */\n  wifiScan?: boolean;\n\n  /**\n   * 是否GPS优先\n   * @platform android\n   * @default false\n   */\n  gpsFirst?: boolean;\n\n  /**\n   * 是否允许返回模拟位置\n   * @platform android\n   * @default false\n   */\n  mockEnable?: boolean;\n\n  /**\n   * 是否等待WIFI列表刷新\n   * 定位精度会更高，但是定位速度会变慢1-3秒\n   * @platform android\n   * @default false\n   */\n  onceLocationLatest?: boolean;\n\n  /**\n   * 逆地理语言\n   */\n  geoLanguage?: GeoLanguage;\n\n  /**\n   * 是否允许后台定位\n   * @default false\n   */\n  allowsBackgroundLocationUpdates?: boolean;\n\n  /**\n   * 是否自动暂停定位\n   * @platform ios\n   * @default false\n   */\n  pausesLocationUpdatesAutomatically?: boolean;\n\n  /**\n   * 是否使用缓存策略\n   * @platform android\n   * @default true\n   */\n  locationCacheEnable?: boolean;\n\n  /**\n   * 网络请求超时时间（毫秒）\n   * @platform android\n   * @default 30000\n   */\n  httpTimeout?: number;\n\n  /**\n   * 网络协议\n   * @platform android\n   * @default 'HTTP'\n   */\n  protocol?: LocationProtocol;\n}\n\n/**\n * 定位事件监听器\n */\nexport type LocationListener = (location: Coordinates | ReGeocode) => void;\n\n/**\n * 方向更新事件数据\n */\nexport interface HeadingUpdate {\n  /** 磁北方向角度 (0-359.9) */\n  magneticHeading: number;\n\n  /** 真北方向角度 (0-359.9) */\n  trueHeading: number;\n\n  /** 方向精度 */\n  headingAccuracy: number;\n\n  /** X 轴原始数据 */\n  x: number;\n\n  /** Y 轴原始数据 */\n  y: number;\n\n  /** Z 轴原始数据 */\n  z: number;\n\n  /** 时间戳 */\n  timestamp: number;\n}\n\n/**\n * 方向事件监听器\n */\nexport type HeadingListener = (heading: HeadingUpdate) => void;\n\n\n"]}

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

@@ -0,0 +1,340 @@
+/**
+ * 高德地图视图相关类型定义
+ * 基于 Expo Modules API
+ */
+import type { StyleProp, ViewStyle, NativeSyntheticEvent } from 'react-native';
+import type { CameraPosition, CameraUpdate, LatLng, LatLngBounds, MapPoi, MapType, Point, LatLngPoint } from './common.types';
+import type { Coordinates, ReGeocode, HeadingUpdate } from './location.types';
+import type { FitToCoordinatesOptions } from './route-playback.types';
+/**
+ * 定位事件数据
+ */
+export interface LocationEvent {
+    /**
+     * 纬度
+     */
+    latitude: number;
+    /**
+     * 经度
+     */
+    longitude: number;
+    /**
+     * 定位精度（米）
+     */
+    accuracy: number;
+}
+/**
+ * 地图相机事件
+ */
+export interface CameraEvent {
+    /**
+     * 相机位置
+     */
+    cameraPosition: CameraPosition;
+    /**
+     * 可见区域边界
+     */
+    latLngBounds: LatLngBounds;
+}
+/**
+ * 地图视图属性
+ */
+export interface MapViewProps {
+    /**
+     * 地图类型
+     */
+    mapType?: MapType;
+    /**
+     * 初始相机位置
+     */
+    initialCameraPosition?: CameraPosition;
+    /**
+     * 是否显示当前定位
+     */
+    myLocationEnabled?: boolean;
+    /**
+     * 是否跟随用户位置
+     * @default false
+     */
+    followUserLocation?: boolean;
+    /**
+     * 定位蓝点配置
+     */
+    userLocationRepresentation?: {
+        /** 精度圈是否显示 @default true */
+        showsAccuracyRing?: boolean;
+        /** 是否显示方向指示 @default true @platform ios */
+        showsHeadingIndicator?: boolean;
+        /** 精度圈填充颜色 支持 '#RRGGBB'、'red' 或 ARGB 数字 */
+        fillColor?: string | number;
+        /** 精度圈边线颜色 */
+        strokeColor?: string | number;
+        /** 精度圈边线宽度 @default 0 */
+        lineWidth?: number;
+        /** 内部蓝色圆点是否使用律动效果 @default true @platform ios */
+        enablePulseAnimation?: boolean;
+        /** 定位点背景色 @default 'white' @platform ios */
+        locationDotBgColor?: string | number;
+        /** 定位点蓝色圆点颜色 @default 'blue' @platform ios */
+        locationDotFillColor?: string | number;
+        /** 定位图标 支持网络图片(http/https)、本地文件(file://)或资源名称 */
+        image?: string;
+        /** 定位图标宽度(像素) */
+        imageWidth?: number;
+        /** 定位图标高度(像素) */
+        imageHeight?: number;
+        /**
+         * 是否显示定位蓝点 @default true
+         * - iOS: 对应 mapView.showsUserLocation
+         * - Android: 对应 MyLocationStyle.showMyLocation() (5.1.0+)
+         */
+        showMyLocation?: boolean;
+        /** 定位图标锚点 U 坐标 (0.0-1.0) @platform android */
+        anchorU?: number;
+        /** 定位图标锚点 V 坐标 (0.0-1.0) @platform android */
+        anchorV?: number;
+        /**
+         * 定位蓝点展现模式 @platform android
+         * @default 'LOCATION_ROTATE_NO_CENTER' (连续定位、定位点旋转、不移动到中心)
+         *
+         * 🧭 **方向指示说明**：
+         * - Android 通过 locationType 实现方向指示（定位点依照设备方向旋转）
+         * - iOS 通过 showsHeadingIndicator 实现方向指示（显示扇形方向指示器）
+         *
+         * 📱 **Android 方向指示模式**（推荐使用以下两种）：
+         * - 'LOCATION_ROTATE': 定位点依照设备方向旋转，视角跟随移动到中心
+         * - 'LOCATION_ROTATE_NO_CENTER': 定位点依照设备方向旋转，视角不移动到中心 ⭐
+         *
+         * 🗺️ **其他模式**：
+         * - 'SHOW': 只定位一次
+         * - 'LOCATE': 定位一次，且将视角移动到地图中心点
+         * - 'FOLLOW': 连续定位、跟随移动，但定位点不旋转
+         * - 'MAP_ROTATE': 地图依照设备方向旋转（而非定位点旋转）
+         * - 'FOLLOW_NO_CENTER': 连续定位、不移动到中心，定位点不旋转
+         * - 'MAP_ROTATE_NO_CENTER': 地图依照设备方向旋转，不移动到中心
+         *
+         * 显式设置 locationType 时，会覆盖 followUserLocation 的默认模式选择。
+         */
+        locationType?: 'SHOW' | 'LOCATE' | 'FOLLOW' | 'MAP_ROTATE' | 'LOCATION_ROTATE' | 'LOCATION_ROTATE_NO_CENTER' | 'FOLLOW_NO_CENTER' | 'MAP_ROTATE_NO_CENTER';
+    };
+    /**
+     * 是否显示室内地图
+     *
+     */
+    indoorViewEnabled?: boolean;
+    /**
+     * 是否显示3D建筑
+     */
+    buildingsEnabled?: boolean;
+    /**
+     * 是否显示标注
+     */
+    labelsEnabled?: boolean;
+    /**
+     * 是否显示指南针
+     */
+    compassEnabled?: boolean;
+    /**
+     * 是否显示缩放按钮
+     * @platform android
+     */
+    zoomControlsEnabled?: boolean;
+    /**
+     * 是否显示比例尺
+     */
+    scaleControlsEnabled?: boolean;
+    /**
+     * 是否显示定位按钮
+     * @platform android
+     */
+    myLocationButtonEnabled?: boolean;
+    /**
+     * 是否显示路况
+     */
+    trafficEnabled?: boolean;
+    /**
+     * 最大缩放级别
+     */
+    maxZoom?: number;
+    /**
+     * 最小缩放级别
+     */
+    minZoom?: number;
+    /**
+     * 是否启用缩放手势
+     */
+    zoomGesturesEnabled?: boolean;
+    /**
+     * 是否启用滑动手势
+     */
+    scrollGesturesEnabled?: boolean;
+    /**
+     * 是否启用旋转手势
+     */
+    rotateGesturesEnabled?: boolean;
+    /**
+     * 是否启用倾斜手势
+     */
+    tiltGesturesEnabled?: boolean;
+    /**
+     * 定位的最小更新距离（米）
+     * @platform ios
+     */
+    distanceFilter?: number;
+    /**
+     * 最小更新角度（度）
+     * @platform ios
+     */
+    headingFilter?: number;
+    /**
+     * 是否启用国内外地图自动切换
+     * - true: 当中心点在国外时自动切换到苹果地图（iOS），国内时切换回高德地图
+     * - false: 始终使用高德地图
+     * @platform ios 当前仅支持 iOS 安卓因为需要使用 Google Maps SDK和谷歌服务
+     * @default false
+     */
+    worldMapSwitchEnabled?: boolean;
+    /**
+     * 自定义地图样式
+     *
+     * 支持两种方式：
+     * 1. 在线样式：提供 styleId（从高德开放平台获取）
+     * 2. 本地样式：提供 styleDataPath 和可选的 extraStyleDataPath
+     *
+     * @example
+     * // 使用在线样式
+     * customMapStyle={{ styleId: "your-style-id" }}
+     *
+     * @example
+     * // 使用本地样式文件
+     * customMapStyle={{
+     *   styleDataPath: "path/to/style.data",
+     *   extraStyleDataPath: "path/to/extra.data"
+     * }}
+     */
+    customMapStyle?: {
+        /** 在线样式ID（从高德开放平台获取） */
+        styleId?: string;
+        /** 本地样式文件路径 */
+        styleDataPath?: string;
+        /** 额外样式文件路径（可选） */
+        extraStyleDataPath?: string;
+    };
+    /**
+     * 样式
+     */
+    style?: StyleProp<ViewStyle>;
+    /**
+     * 点击地图事件
+     */
+    onMapPress?: (event: NativeSyntheticEvent<LatLng>) => void;
+    /**
+     * 点击标注点事件
+     */
+    onPressPoi?: (event: NativeSyntheticEvent<MapPoi>) => void;
+    /**
+     * 长按地图事件
+     */
+    onMapLongPress?: (event: NativeSyntheticEvent<LatLng>) => void;
+    /**
+     * 地图状态改变事件（实时触发）
+     * 可配合 `cameraEventThrottleMs` 控制事件频率
+     */
+    onCameraMove?: (event: NativeSyntheticEvent<CameraEvent>) => void;
+    /**
+     * 地图移动事件节流间隔（毫秒）
+     * `0` 表示不节流
+     * @default 32
+     */
+    cameraEventThrottleMs?: number;
+    /**
+     * 地图状态改变完成事件
+     */
+    onCameraIdle?: (event: NativeSyntheticEvent<CameraEvent>) => void;
+    /**
+     * 地图加载完成事件
+     */
+    onLoad?: (event: NativeSyntheticEvent<{}>) => void;
+    /**
+     * 地图定位更新事件
+     */
+    onLocation?: (event: NativeSyntheticEvent<LocationEvent>) => void;
+    /**
+     * 子组件
+     */
+    children?: React.ReactNode;
+}
+/**
+ * 地图视图方法
+ */
+export interface MapViewMethods {
+    /**
+     * 移动相机
+     * @param cameraPosition 目标相机位置
+     * @param duration 动画时长（毫秒）
+     */
+    moveCamera(cameraPosition: CameraUpdate, duration?: number): Promise<void>;
+    /**
+     * 将屏幕坐标转换为地理坐标
+     * @param point 屏幕坐标
+     * @returns 地理坐标
+     */
+    getLatLng(point: Point): Promise<LatLng>;
+    /**
+     * 设置地图中心点
+     * @param center 中心点
+     * @param animated 是否启用动画
+     */
+    setCenter(center: LatLngPoint, animated?: boolean): Promise<void>;
+    /**
+     * 设置地图缩放级别
+     * @param zoom 缩放级别
+     * @param animated 是否启用动画
+     */
+    setZoom(zoom: number, animated?: boolean): Promise<void>;
+    /**
+     * 获取相机位置
+     * @returns 相机位置
+     */
+    getCameraPosition(): Promise<CameraPosition>;
+    /**
+     * 截取地图快照
+     * @returns 快照图片文件路径
+     */
+    takeSnapshot(): Promise<string>;
+    /**
+     * 根据坐标集合自动移动相机
+     */
+    fitToCoordinates(points: LatLngPoint[], options?: FitToCoordinatesOptions): Promise<void>;
+}
+/**
+ * MapView Ref 公开接口（用户使用）
+ */
+export interface MapViewRef {
+    moveCamera(position: CameraUpdate, duration?: number): Promise<void>;
+    getLatLng(point: Point): Promise<LatLng>;
+    setCenter(center: LatLngPoint, animated?: boolean): Promise<void>;
+    setZoom(zoom: number, animated?: boolean): Promise<void>;
+    getCameraPosition(): Promise<CameraPosition>;
+    takeSnapshot(): Promise<string>;
+    fitToCoordinates(points: LatLngPoint[], options?: FitToCoordinatesOptions): Promise<void>;
+}
+/**
+ * Expo 模块事件类型
+ * 定义了原生模块可以触发的事件
+ */
+export type ExpoGaodeMapModuleEvents = {
+    /**
+     * 定位更新事件
+     * 当位置发生变化时触发
+     * @param location 位置信息，包含坐标和可选的逆地理编码信息
+     */
+    onLocationUpdate: (location: Coordinates | ReGeocode) => void;
+    /**
+     * 方向更新事件（iOS）
+     * 当设备方向发生变化时触发
+     * @param heading 方向信息
+     */
+    onHeadingUpdate: (heading: HeadingUpdate) => void;
+};
+//# sourceMappingURL=map-view.types.d.ts.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"map-view.types.js","sourceRoot":"","sources":["../../../../src/map/types/map-view.types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * 高德地图视图相关类型定义\n * 基于 Expo Modules API\n */\n\nimport type { StyleProp, ViewStyle, NativeSyntheticEvent } from 'react-native';\nimport type { CameraPosition, CameraUpdate, LatLng, LatLngBounds, MapPoi, MapType, Point, LatLngPoint } from './common.types';\nimport type { Coordinates, ReGeocode, HeadingUpdate } from './location.types';\nimport type { FitToCoordinatesOptions } from './route-playback.types';\n\n/**\n * 定位事件数据\n */\nexport interface LocationEvent {\n  /**\n   * 纬度\n   */\n  latitude: number;\n  \n  /**\n   * 经度\n   */\n  longitude: number;\n  \n  /**\n   * 定位精度（米）\n   */\n  accuracy: number;\n}\n\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     * 是否显示定位蓝点 @default true\n     * - iOS: 对应 mapView.showsUserLocation\n     * - Android: 对应 MyLocationStyle.showMyLocation() (5.1.0+)\n     */\n    showMyLocation?: boolean;\n    /** 定位图标锚点 U 坐标 (0.0-1.0) @platform android */\n    anchorU?: number;\n    /** 定位图标锚点 V 坐标 (0.0-1.0) @platform android */\n    anchorV?: number;\n    /**\n     * 定位蓝点展现模式 @platform android\n     * @default 'LOCATION_ROTATE_NO_CENTER' (连续定位、定位点旋转、不移动到中心)\n     *\n     * 🧭 **方向指示说明**：\n     * - Android 通过 locationType 实现方向指示（定位点依照设备方向旋转）\n     * - iOS 通过 showsHeadingIndicator 实现方向指示（显示扇形方向指示器）\n     *\n     * 📱 **Android 方向指示模式**（推荐使用以下两种）：\n     * - 'LOCATION_ROTATE': 定位点依照设备方向旋转，视角跟随移动到中心\n     * - 'LOCATION_ROTATE_NO_CENTER': 定位点依照设备方向旋转，视角不移动到中心 ⭐\n     *\n     * 🗺️ **其他模式**：\n     * - 'SHOW': 只定位一次\n     * - 'LOCATE': 定位一次，且将视角移动到地图中心点\n     * - 'FOLLOW': 连续定位、跟随移动，但定位点不旋转\n     * - 'MAP_ROTATE': 地图依照设备方向旋转（而非定位点旋转）\n     * - 'FOLLOW_NO_CENTER': 连续定位、不移动到中心，定位点不旋转\n     * - 'MAP_ROTATE_NO_CENTER': 地图依照设备方向旋转，不移动到中心\n     *\n     * 显式设置 locationType 时，会覆盖 followUserLocation 的默认模式选择。\n     */\n    locationType?: 'SHOW' | 'LOCATE' | 'FOLLOW' | 'MAP_ROTATE' | 'LOCATION_ROTATE' |\n                   'LOCATION_ROTATE_NO_CENTER' | 'FOLLOW_NO_CENTER' | 'MAP_ROTATE_NO_CENTER';\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   * - true: 当中心点在国外时自动切换到苹果地图（iOS），国内时切换回高德地图\n   * - false: 始终使用高德地图\n   * @platform ios 当前仅支持 iOS 安卓因为需要使用 Google Maps SDK和谷歌服务\n   * @default false\n   */\n  worldMapSwitchEnabled?: boolean;\n\n  /**\n   * 自定义地图样式\n   *\n   * 支持两种方式：\n   * 1. 在线样式：提供 styleId（从高德开放平台获取）\n   * 2. 本地样式：提供 styleDataPath 和可选的 extraStyleDataPath\n   *\n   * @example\n   * // 使用在线样式\n   * customMapStyle={{ styleId: \"your-style-id\" }}\n   *\n   * @example\n   * // 使用本地样式文件\n   * customMapStyle={{\n   *   styleDataPath: \"path/to/style.data\",\n   *   extraStyleDataPath: \"path/to/extra.data\"\n   * }}\n   */\n  customMapStyle?: {\n    /** 在线样式ID（从高德开放平台获取） */\n    styleId?: string;\n    /** 本地样式文件路径 */\n    styleDataPath?: string;\n    /** 额外样式文件路径（可选） */\n    extraStyleDataPath?: string;\n  };\n\n  /**\n   * 样式\n   */\n  style?: StyleProp<ViewStyle>;\n\n  /**\n   * 点击地图事件\n   */\n  onMapPress?: (event: NativeSyntheticEvent<LatLng>) => void;\n\n  /**\n   * 点击标注点事件\n   */\n  onPressPoi?: (event: NativeSyntheticEvent<MapPoi>) => void;\n\n  /**\n   * 长按地图事件\n   */\n  onMapLongPress?: (event: NativeSyntheticEvent<LatLng>) => void;\n\n  /**\n   * 地图状态改变事件（实时触发）\n   * 可配合 `cameraEventThrottleMs` 控制事件频率\n   */\n  onCameraMove?: (event: NativeSyntheticEvent<CameraEvent>) => void;\n\n  /**\n   * 地图移动事件节流间隔（毫秒）\n   * `0` 表示不节流\n   * @default 32\n   */\n  cameraEventThrottleMs?: number;\n\n  /**\n   * 地图状态改变完成事件\n   */\n  onCameraIdle?: (event: NativeSyntheticEvent<CameraEvent>) => void;\n\n  /**\n   * 地图加载完成事件\n   */\n  onLoad?: (event: NativeSyntheticEvent<{}>) => void;\n\n  /**\n   * 地图定位更新事件\n   */\n  onLocation?: (event: NativeSyntheticEvent<LocationEvent>) => void;\n\n  /**\n   * 子组件\n   */\n  children?: React.ReactNode;\n}\n\n\n/**\n * 地图视图方法\n */\nexport interface MapViewMethods {\n  /**\n   * 移动相机\n   * @param cameraPosition 目标相机位置\n   * @param duration 动画时长（毫秒）\n   */\n  moveCamera(cameraPosition: CameraUpdate, duration?: number): Promise<void>;\n\n  /**\n   * 将屏幕坐标转换为地理坐标\n   * @param point 屏幕坐标\n   * @returns 地理坐标\n   */\n  getLatLng(point: Point): Promise<LatLng>;\n\n  /**\n   * 设置地图中心点\n   * @param center 中心点\n   * @param animated 是否启用动画\n   */\n  setCenter(center: LatLngPoint, animated?: boolean): Promise<void>;\n\n  /**\n   * 设置地图缩放级别\n   * @param zoom 缩放级别\n   * @param animated 是否启用动画\n   */\n  setZoom(zoom: number, animated?: boolean): Promise<void>;\n\n  /**\n   * 获取相机位置\n   * @returns 相机位置\n   */\n  getCameraPosition(): Promise<CameraPosition>;\n\n  /**\n   * 截取地图快照\n   * @returns 快照图片文件路径\n   */\n  takeSnapshot(): Promise<string>;\n\n  /**\n   * 根据坐标集合自动移动相机\n   */\n  fitToCoordinates(points: LatLngPoint[], options?: FitToCoordinatesOptions): Promise<void>;\n}\n\n/**\n * MapView Ref 公开接口（用户使用）\n */\nexport interface MapViewRef {\n  moveCamera(position: CameraUpdate, duration?: number): Promise<void>;\n  getLatLng(point: Point): Promise<LatLng>;\n  setCenter(center: LatLngPoint, animated?: boolean): Promise<void>;\n  setZoom(zoom: number, animated?: boolean): Promise<void>;\n  getCameraPosition(): Promise<CameraPosition>;\n  takeSnapshot(): Promise<string>;\n  fitToCoordinates(points: LatLngPoint[], options?: FitToCoordinatesOptions): Promise<void>;\n}\n\n/**\n * Expo 模块事件类型\n * 定义了原生模块可以触发的事件\n */\nexport type ExpoGaodeMapModuleEvents = {\n  /**\n   * 定位更新事件\n   * 当位置发生变化时触发\n   * @param location 位置信息，包含坐标和可选的逆地理编码信息\n   */\n  onLocationUpdate: (location: Coordinates | ReGeocode) => void;\n  \n  /**\n   * 方向更新事件（iOS）\n   * 当设备方向发生变化时触发\n   * @param heading 方向信息\n   */\n  onHeadingUpdate: (heading: HeadingUpdate) => void;\n};\n"]}