expo-gaode-map 2.2.38 → 2.2.40-next.0

package/build/search/ExpoGaodeMapSearchModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoGaodeMapSearchModule.js","sourceRoot":"","sources":["../../src/search/ExpoGaodeMapSearchModule.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAiBxD;;;;GAIG;AACH,SAAS,mBAAmB;IAC1B,IAAI,CAAC;QACH,iBAAiB;QACjB,sDAAsD;QACtD,gCAAgC;QAChC,kDAAkD;QAClD,mBAAmB,CAAC,cAAc,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,GACP,kCAAkC;YAClC,2CAA2C;YAC3C,2BAA2B,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAwED;;;;GAIG;AACH,IAAI,iBAAiB,GAAwC,IAAI,CAAC;AAElE,SAAS,eAAe;IACtB,mBAAmB,EAAE,CAAC;IACtB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,iBAAiB,GAAG,mBAAmB,CAA+B,oBAAoB,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,SAAS,mBAAmB,CAC1B,MAAoC,EACpC,IAAiB;IAEjB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAgB,EAAE,IAAI,EAAE,MAAgB,CAAC,CAAC;IACpE,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,IAAe,EAAE,EAAE,CAC3B,KAA2C,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,eAAe,IAAI,KAAK,CAAC,EAAkC,EAAE;IAC3D,GAAG,CAAC,OAAO,EAAE,IAAI;QACf,OAAO,mBAAmB,CAAC,eAAe,EAAE,EAAE,IAAI,CAAC,CAAC;IACtD,CAAC;CACF,CAAC,CAAC","sourcesContent":["\nimport { requireNativeModule } from 'expo-modules-core';\n\nimport {\n  AlongSearchOptions,\n  InputTipsOptions,\n  InputTipsResult,\n  NearbySearchOptions,\n  POI,\n  POISearchOptions,\n  PolygonSearchOptions,\n  ReGeocodeOptions,\n  ReGeocodeResult,\n  RoutePOIType,\n  SearchResult,\n} from './ExpoGaodeMapSearch.types';\n\n\n/**\n * 在加载原生搜索模块前，强制校验基础地图组件是否已安装。\n * 支持两种“基础地图提供者”：expo-gaode-map 或 expo-gaode-map-navigation（导航内置地图）。\n * 这样可避免导航与核心包的 SDK 冲突时无法使用搜索模块的问题。\n */\nfunction ensureBaseInstalled() {\n  try {\n    // 检查核心地图原生模块是否存在\n    // 无论是安装了 expo-gaode-map 还是 expo-gaode-map-navigation，\n    // 原生端都会注册名为 'ExpoGaodeMap' 的模块。\n    // 我们通过 requireNativeModule 来检测，避免在 JS 层面引入对包的硬依赖。\n    requireNativeModule('ExpoGaodeMap');\n  } catch (_) {\n    const msg =\n      '[expo-gaode-map] 未检测到基础地图原生模块。\\n' +\n      '请确保已安装以下任一包并重新构建应用 (npx expo prebuild)：\\n' +\n      '  - expo-gaode-map（核心地图包）';\n    throw new Error(msg);\n  }\n}\n\ndeclare class ExpoGaodeMapSearchModuleType {\n  /**\n   * 初始化搜索模块（可选）\n   *\n   * 如果 API Key 已通过以下方式设置，则无需调用此方法：\n   * 1. app.json 的 plugins 中配置了 iosKey（推荐）\n   * 2. 调用了 ExpoGaodeMap.initSDK()\n   * 3. 在 AppDelegate 中手动设置\n   *\n   * 此方法会在首次调用搜索功能时自动执行，手动调用可以提前检测配置问题。\n   */\n  initSearch(): void;\n  /**\n   * 搜索 POI（兴趣点）\n   * 根据关键词和可选参数返回匹配的 POI 列表。\n   *\n   * @param options 搜索参数，包含关键词、城市、类型等\n   * @returns 匹配的 POI 列表\n   */\n  searchPOI(options: POISearchOptions): Promise<SearchResult>;\n  /**\n   * 搜索周边 POI\n   * 根据位置和半径返回周边的 POI 列表。\n   *\n   * @param options 搜索参数，包含位置、半径、类型等\n   * @returns 周边的 POI 列表\n   */\n  searchNearby(options: NearbySearchOptions): Promise<SearchResult>;\n  /**\n   * 搜索沿途 POI\n   * 根据路线和半径返回沿途的 POI 列表。\n   *\n   * @param options 搜索参数，包含路线、半径、类型等\n   * @returns 沿途的 POI 列表\n   */\n  searchAlong(options: AlongSearchOptions): Promise<SearchResult>;\n  /**\n   * 搜索多边形内的 POI\n   * 根据多边形区域返回其内的 POI 列表。\n   *\n   * @param options 搜索参数，包含多边形区域、类型等\n   * @returns 多边形内的 POI 列表\n   */\n  searchPolygon(options: PolygonSearchOptions): Promise<SearchResult>;\n  /**\n   * 获取输入提示\n   * 根据用户输入返回可能的搜索建议。\n   *\n   * @param options 输入提示参数，包含关键词、城市等\n   * @returns 输入提示结果\n   */\n  getInputTips(options: InputTipsOptions): Promise<InputTipsResult>;\n  /**\n   * 逆地理编码\n   * 根据经纬度返回地址信息。\n   *\n   * @param options 逆地理编码参数，包含经纬度等\n   * @returns 逆地理编码结果\n   */\n  reGeocode(options: ReGeocodeOptions): Promise<ReGeocodeResult>;\n  /**\n   * 获取 POI 详情\n   * 根据 POI ID 返回详细信息。\n   *\n   * @param id POI 唯一标识符\n   * @returns POI 详情\n   */\n  getPoiDetail(id: string): Promise<POI>;\n}\n\n/**\n * 高德地图搜索模块\n *\n * 提供 POI 搜索、周边搜索、沿途搜索、多边形搜索和输入提示功能\n */\nlet nativeModuleCache: ExpoGaodeMapSearchModuleType | null = null;\n\nfunction getNativeModule(): ExpoGaodeMapSearchModuleType {\n  ensureBaseInstalled();\n  if (!nativeModuleCache) {\n    nativeModuleCache = requireNativeModule<ExpoGaodeMapSearchModuleType>('ExpoGaodeMapSearch');\n  }\n  return nativeModuleCache;\n}\n\nfunction getBoundNativeValue(\n  module: ExpoGaodeMapSearchModuleType,\n  prop: PropertyKey\n): unknown {\n  const value = Reflect.get(module as object, prop, module as object);\n  if (typeof value === 'function') {\n    return (...args: unknown[]) =>\n      (value as (...fnArgs: unknown[]) => unknown).apply(module, args);\n  }\n  return value;\n}\n\nexport default new Proxy({} as ExpoGaodeMapSearchModuleType, {\n  get(_target, prop) {\n    return getBoundNativeValue(getNativeModule(), prop);\n  },\n});\n\nexport type { RoutePOIType };\n"]}
+{"version":3,"file":"ExpoGaodeMapSearchModule.js","sourceRoot":"","sources":["../../src/search/ExpoGaodeMapSearchModule.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAiBxD;;;;GAIG;AACH,SAAS,mBAAmB;IAC1B,IAAI,CAAC;QACH,iBAAiB;QACjB,sDAAsD;QACtD,gCAAgC;QAChC,kDAAkD;QAClD,mBAAmB,CAAC,cAAc,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,GAAG,GACP,kCAAkC;YAClC,2CAA2C;YAC3C,2BAA2B,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAwED;;;;GAIG;AACH,IAAI,iBAAiB,GAAwC,IAAI,CAAC;AAElE,SAAS,eAAe;IACtB,mBAAmB,EAAE,CAAC;IACtB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,iBAAiB,GAAG,mBAAmB,CAA+B,oBAAoB,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,SAAS,mBAAmB,CAC1B,MAAoC,EACpC,IAAiB;IAEjB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAgB,EAAE,IAAI,EAAE,MAAgB,CAAC,CAAC;IACpE,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,IAAe,EAAE,EAAE,CAC3B,KAA2C,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,eAAe,IAAI,KAAK,CAAC,EAAkC,EAAE;IAC3D,GAAG,CAAC,OAAO,EAAE,IAAI;QACf,OAAO,mBAAmB,CAAC,eAAe,EAAE,EAAE,IAAI,CAAC,CAAC;IACtD,CAAC;CACF,CAAC,CAAC","sourcesContent":["\nimport { requireNativeModule } from 'expo-modules-core';\n\nimport type {\n  AlongSearchOptions,\n  InputTipsOptions,\n  InputTipsResult,\n  NearbySearchOptions,\n  POI,\n  POISearchOptions,\n  PolygonSearchOptions,\n  ReGeocodeOptions,\n  ReGeocodeResult,\n  RoutePOIType,\n  SearchResult,\n} from './ExpoGaodeMapSearch.types';\n\n\n/**\n * 在加载原生搜索模块前，强制校验基础地图组件是否已安装。\n * 支持两种“基础地图提供者”：expo-gaode-map 或 expo-gaode-map-navigation（导航内置地图）。\n * 这样可避免导航与核心包的 SDK 冲突时无法使用搜索模块的问题。\n */\nfunction ensureBaseInstalled() {\n  try {\n    // 检查核心地图原生模块是否存在\n    // 无论是安装了 expo-gaode-map 还是 expo-gaode-map-navigation，\n    // 原生端都会注册名为 'ExpoGaodeMap' 的模块。\n    // 我们通过 requireNativeModule 来检测，避免在 JS 层面引入对包的硬依赖。\n    requireNativeModule('ExpoGaodeMap');\n  } catch (_) {\n    const msg =\n      '[expo-gaode-map] 未检测到基础地图原生模块。\\n' +\n      '请确保已安装以下任一包并重新构建应用 (npx expo prebuild)：\\n' +\n      '  - expo-gaode-map（核心地图包）';\n    throw new Error(msg);\n  }\n}\n\ndeclare class ExpoGaodeMapSearchModuleType {\n  /**\n   * 初始化搜索模块（可选）\n   *\n   * 如果 API Key 已通过以下方式设置，则无需调用此方法：\n   * 1. app.json 的 plugins 中配置了 iosKey（推荐）\n   * 2. 调用了 ExpoGaodeMap.initSDK()\n   * 3. 在 AppDelegate 中手动设置\n   *\n   * 此方法会在首次调用搜索功能时自动执行，手动调用可以提前检测配置问题。\n   */\n  initSearch(): void;\n  /**\n   * 搜索 POI（兴趣点）\n   * 根据关键词和可选参数返回匹配的 POI 列表。\n   *\n   * @param options 搜索参数，包含关键词、城市、类型等\n   * @returns 匹配的 POI 列表\n   */\n  searchPOI(options: POISearchOptions): Promise<SearchResult>;\n  /**\n   * 搜索周边 POI\n   * 根据位置和半径返回周边的 POI 列表。\n   *\n   * @param options 搜索参数，包含位置、半径、类型等\n   * @returns 周边的 POI 列表\n   */\n  searchNearby(options: NearbySearchOptions): Promise<SearchResult>;\n  /**\n   * 搜索沿途 POI\n   * 根据路线和半径返回沿途的 POI 列表。\n   *\n   * @param options 搜索参数，包含路线、半径、类型等\n   * @returns 沿途的 POI 列表\n   */\n  searchAlong(options: AlongSearchOptions): Promise<SearchResult>;\n  /**\n   * 搜索多边形内的 POI\n   * 根据多边形区域返回其内的 POI 列表。\n   *\n   * @param options 搜索参数，包含多边形区域、类型等\n   * @returns 多边形内的 POI 列表\n   */\n  searchPolygon(options: PolygonSearchOptions): Promise<SearchResult>;\n  /**\n   * 获取输入提示\n   * 根据用户输入返回可能的搜索建议。\n   *\n   * @param options 输入提示参数，包含关键词、城市等\n   * @returns 输入提示结果\n   */\n  getInputTips(options: InputTipsOptions): Promise<InputTipsResult>;\n  /**\n   * 逆地理编码\n   * 根据经纬度返回地址信息。\n   *\n   * @param options 逆地理编码参数，包含经纬度等\n   * @returns 逆地理编码结果\n   */\n  reGeocode(options: ReGeocodeOptions): Promise<ReGeocodeResult>;\n  /**\n   * 获取 POI 详情\n   * 根据 POI ID 返回详细信息。\n   *\n   * @param id POI 唯一标识符\n   * @returns POI 详情\n   */\n  getPoiDetail(id: string): Promise<POI>;\n}\n\n/**\n * 高德地图搜索模块\n *\n * 提供 POI 搜索、周边搜索、沿途搜索、多边形搜索和输入提示功能\n */\nlet nativeModuleCache: ExpoGaodeMapSearchModuleType | null = null;\n\nfunction getNativeModule(): ExpoGaodeMapSearchModuleType {\n  ensureBaseInstalled();\n  if (!nativeModuleCache) {\n    nativeModuleCache = requireNativeModule<ExpoGaodeMapSearchModuleType>('ExpoGaodeMapSearch');\n  }\n  return nativeModuleCache;\n}\n\nfunction getBoundNativeValue(\n  module: ExpoGaodeMapSearchModuleType,\n  prop: PropertyKey\n): unknown {\n  const value = Reflect.get(module as object, prop, module as object);\n  if (typeof value === 'function') {\n    return (...args: unknown[]) =>\n      (value as (...fnArgs: unknown[]) => unknown).apply(module, args);\n  }\n  return value;\n}\n\nexport default new Proxy({} as ExpoGaodeMapSearchModuleType, {\n  get(_target, prop) {\n    return getBoundNativeValue(getNativeModule(), prop);\n  },\n});\n\nexport type { RoutePOIType };\n"]}

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

@@ -2,7 +2,7 @@
  * 高德地图通用类型定义
  * 基于 Expo Modules API
  */
-import { PermissionResponse } from 'expo-modules-core';
+import type { PermissionResponse } from 'expo-modules-core';
 /**
  * SDK 配置参数
  */

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

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

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

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

package/build/types/index.d.ts

@@ -4,7 +4,7 @@
  */
 export type { Point, LatLng, LatLngPoint, MapPoi, LatLngBounds, CameraPosition, CameraUpdate, ColorValue, SDKConfig, PermissionStatus, } from './common.types';
 export { MapType } from './common.types';
-export type { LocationEvent, CameraEvent, MapViewProps, MapViewMethods, MapViewRef, ExpoGaodeMapModuleEvents, } from './map-view.types';
+export type { LocationEvent, CameraEvent, ZoomGestureAnchor, MapViewProps, MapViewMethods, MapViewRef, ExpoGaodeMapModuleEvents, } from './map-view.types';
 export type { Coordinates, ReGeocode, HeadingUpdate, LocationOptions, LocationListener, HeadingListener, GeoLanguage, LocationProtocol, } from './location.types';
 export { LocationAccuracy, LocationMode, CoordinateType, } from './location.types';
 export type { MarkerProps, PolylineProps, PolygonProps, CircleProps, HeatMapProps, MultiPointItem, MultiPointProps, ClusterParams, ClusterPoint, ClusterProps, } from './overlays.types';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,KAAK,EACL,MAAM,EACN,WAAW,EACX,MAAM,EACN,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,UAAU,EACV,SAAS,EACT,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGzC,YAAY,EACV,aAAa,EACb,WAAW,EACX,YAAY,EACZ,cAAc,EACd,UAAU,EACV,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,WAAW,EACX,SAAS,EACT,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,cAAc,GACf,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,WAAW,EACX,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,cAAc,EACd,eAAe,EACf,aAAa,EACb,YAAY,EACZ,YAAY,GACb,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,YAAY,EACV,oBAAoB,EACpB,uBAAuB,EACvB,WAAW,EACX,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,KAAK,EACL,MAAM,EACN,WAAW,EACX,MAAM,EACN,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,UAAU,EACV,SAAS,EACT,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGzC,YAAY,EACV,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,WAAW,EACX,SAAS,EACT,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,cAAc,GACf,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,WAAW,EACX,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,cAAc,EACd,eAAe,EACf,aAAa,EACb,YAAY,EACZ,YAAY,GACb,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,YAAY,EACV,oBAAoB,EACpB,uBAAuB,EACvB,WAAW,EACX,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC"}

package/build/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAwBzC,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,cAAc,GACf,MAAM,kBAAkB,CAAC","sourcesContent":["/**\n * 高德地图 Expo Module 类型定义统一导出\n * 基于 Expo Modules API 重新设计\n */\n\n// 通用类型\nexport type {\n  Point,\n  LatLng,\n  LatLngPoint,\n  MapPoi,\n  LatLngBounds,\n  CameraPosition,\n  CameraUpdate,\n  ColorValue,\n  SDKConfig,\n  PermissionStatus,\n} from './common.types';\n\nexport { MapType } from './common.types';\n\n// 地图视图类型\nexport type {\n  LocationEvent,\n  CameraEvent,\n  MapViewProps,\n  MapViewMethods,\n  MapViewRef,\n  ExpoGaodeMapModuleEvents,\n} from './map-view.types';\n\n// 定位类型\nexport type {\n  Coordinates,\n  ReGeocode,\n  HeadingUpdate,\n  LocationOptions,\n  LocationListener,\n  HeadingListener,\n  GeoLanguage,\n  LocationProtocol,\n} from './location.types';\n\nexport {\n  LocationAccuracy,\n  LocationMode,\n  CoordinateType,\n} from './location.types';\n\n// 覆盖物类型\nexport type {\n  MarkerProps,\n  PolylineProps,\n  PolygonProps,\n  CircleProps,\n  HeatMapProps,\n  MultiPointItem,\n  MultiPointProps,\n  ClusterParams,\n  ClusterPoint,\n  ClusterProps,\n} from './overlays.types';\n\n// 模块 facade 类型\nexport type { ExpoGaodeMapModule } from '../ExpoGaodeMapModule';\n\nexport type {\n  AreaMaskOverlayProps,\n  FitToCoordinatesOptions,\n  RouteBounds,\n  RouteOverlayProps,\n  RoutePlaybackController,\n  RoutePlaybackOptions,\n  RoutePlaybackState,\n  SmoothMoveEndEvent,\n  SmoothMoveProgressEvent,\n} from './route-playback.types';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAyBzC,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,cAAc,GACf,MAAM,kBAAkB,CAAC","sourcesContent":["/**\n * 高德地图 Expo Module 类型定义统一导出\n * 基于 Expo Modules API 重新设计\n */\n\n// 通用类型\nexport type {\n  Point,\n  LatLng,\n  LatLngPoint,\n  MapPoi,\n  LatLngBounds,\n  CameraPosition,\n  CameraUpdate,\n  ColorValue,\n  SDKConfig,\n  PermissionStatus,\n} from './common.types';\n\nexport { MapType } from './common.types';\n\n// 地图视图类型\nexport type {\n  LocationEvent,\n  CameraEvent,\n  ZoomGestureAnchor,\n  MapViewProps,\n  MapViewMethods,\n  MapViewRef,\n  ExpoGaodeMapModuleEvents,\n} from './map-view.types';\n\n// 定位类型\nexport type {\n  Coordinates,\n  ReGeocode,\n  HeadingUpdate,\n  LocationOptions,\n  LocationListener,\n  HeadingListener,\n  GeoLanguage,\n  LocationProtocol,\n} from './location.types';\n\nexport {\n  LocationAccuracy,\n  LocationMode,\n  CoordinateType,\n} from './location.types';\n\n// 覆盖物类型\nexport type {\n  MarkerProps,\n  PolylineProps,\n  PolygonProps,\n  CircleProps,\n  HeatMapProps,\n  MultiPointItem,\n  MultiPointProps,\n  ClusterParams,\n  ClusterPoint,\n  ClusterProps,\n} from './overlays.types';\n\n// 模块 facade 类型\nexport type { ExpoGaodeMapModule } from '../ExpoGaodeMapModule';\n\nexport type {\n  AreaMaskOverlayProps,\n  FitToCoordinatesOptions,\n  RouteBounds,\n  RouteOverlayProps,\n  RoutePlaybackController,\n  RoutePlaybackOptions,\n  RoutePlaybackState,\n  SmoothMoveEndEvent,\n  SmoothMoveProgressEvent,\n} from './route-playback.types';\n"]}

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

@@ -36,6 +36,12 @@ export interface CameraEvent {
      */
     latLngBounds: LatLngBounds;
 }
+/**
+ * 缩放手势锚点
+ * - `gesture`: 跟随手势中心点缩放（默认）
+ * - `center`: 固定地图中心点缩放
+ */
+export type ZoomGestureAnchor = 'gesture' | 'center';
 /**
  * 地图视图属性
  */
@@ -63,7 +69,7 @@ export interface MapViewProps {
     userLocationRepresentation?: {
         /** 精度圈是否显示 @default true */
         showsAccuracyRing?: boolean;
-        /** 是否显示方向指示 @default true @platform ios */
+        /** 是否显示 SDK 方向指示扇形；iOS 无默认箭头图片，如需箭头请配合 image 传自定义定位图 @default true @platform ios */
         showsHeadingIndicator?: boolean;
         /** 精度圈填充颜色 支持 '#RRGGBB'、'red' 或 ARGB 数字 */
         fillColor?: string | number;
@@ -99,7 +105,7 @@ export interface MapViewProps {
          *
          * 🧭 **方向指示说明**：
          * - Android 通过 locationType 实现方向指示（定位点依照设备方向旋转）
-         * - iOS 通过 showsHeadingIndicator 实现方向指示（显示扇形方向指示器）
+         * - iOS 通过 showsHeadingIndicator 显示方向指示扇形；SDK 无默认箭头图片，如需箭头请配合 image 传自定义定位图
          *
          * 📱 **Android 方向指示模式**（推荐使用以下两种）：
          * - 'LOCATION_ROTATE': 定位点依照设备方向旋转，视角跟随移动到中心
@@ -166,6 +172,11 @@ export interface MapViewProps {
      * 是否启用缩放手势
      */
     zoomGesturesEnabled?: boolean;
+    /**
+     * 缩放手势锚点
+     * @default 'gesture'
+     */
+    zoomGestureAnchor?: ZoomGestureAnchor;
     /**
      * 是否启用滑动手势
      */

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":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC9H,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAGD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,cAAc,EAAE,cAAc,CAAC;IAE/B;;OAEG;IACH,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,qBAAqB,CAAC,EAAE,cAAc,CAAC;IAEvC;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;OAEG;IACH,0BAA0B,CAAC,EAAE;QAC3B,4BAA4B;QAC5B,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,2CAA2C;QAC3C,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAChC,2CAA2C;QAC3C,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAC5B,cAAc;QACd,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAC9B,yBAAyB;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,iDAAiD;QACjD,oBAAoB,CAAC,EAAE,OAAO,CAAC;QAC/B,4CAA4C;QAC5C,kBAAkB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACrC,8CAA8C;QAC9C,oBAAoB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACvC,iDAAiD;QACjD,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,iBAAiB;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,iBAAiB;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB;;;;WAIG;QACH,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,8CAA8C;QAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,8CAA8C;QAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB;;;;;;;;;;;;;;;;;;;;;WAqBG;QACH,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,iBAAiB,GAC/D,2BAA2B,GAAG,kBAAkB,GAAG,sBAAsB,CAAC;KAC1F,CAAC;IAEF;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;OAEG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;;OAGG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;OAEG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;OAEG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;OAEG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;;;;;;;;;;;;;;;;OAiBG;IACH,cAAc,CAAC,EAAE;QACf,wBAAwB;QACxB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,eAAe;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,mBAAmB;QACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC7B,CAAC;IAEF;;OAEG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAE7B;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IAE3D;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IAE3D;;OAEG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IAE/D;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAElE;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IAElE;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IAEnD;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC,aAAa,CAAC,KAAK,IAAI,CAAC;IAElE;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAGD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,UAAU,CAAC,cAAc,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3E;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEzC;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElE;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzD;;;OAGG;IACH,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IAE7C;;;OAGG;IACH,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhC;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3F;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7C,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3F;AAED;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;;OAIG;IACH,gBAAgB,EAAE,CAAC,QAAQ,EAAE,WAAW,GAAG,SAAS,KAAK,IAAI,CAAC;IAE9D;;;;OAIG;IACH,eAAe,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;CACnD,CAAC"}
+{"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, 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   * @platform android\n   * @note iOS 暂不支持\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"]}
+{"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, 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 * - `gesture`: 跟随手势中心点缩放（默认）\n * - `center`: 固定地图中心点缩放\n */\nexport type ZoomGestureAnchor = 'gesture' | 'center';\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    /** 是否显示 SDK 方向指示扇形；iOS 无默认箭头图片，如需箭头请配合 image 传自定义定位图 @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 显示方向指示扇形；SDK 无默认箭头图片，如需箭头请配合 image 传自定义定位图\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   * @platform android\n   * @note iOS 暂不支持\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   * @default 'gesture'\n   */\n  zoomGestureAnchor?: ZoomGestureAnchor;\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"]}

package/build/utils/GeoUtils.d.ts

@@ -1,7 +1,7 @@
 /**
  * 地理位置工具类
  */
-import { LatLng, LatLngPoint } from '../types/common.types';
+import type { LatLng, LatLngPoint } from '../types/common.types';
 /**
  * 将坐标点归一化为对象格式
  * 支持 [longitude, latitude] 数组或 { latitude, longitude } 对象
@@ -9,7 +9,7 @@ import { LatLng, LatLngPoint } from '../types/common.types';
  *
  * @param point 坐标点
  * @returns { latitude, longitude } 对象
- */
+  */
 export declare function normalizeLatLng(point: LatLngPoint): LatLng;
 /**
  * 将坐标点数组归一化为对象数组

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

@@ -1 +1 @@
-{"version":3,"file":"GeoUtils.d.ts","sourceRoot":"","sources":["../../src/utils/GeoUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAO5D;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CA+B1D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE,CAAC;AACrE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC;AACzE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC"}
+{"version":3,"file":"GeoUtils.d.ts","sourceRoot":"","sources":["../../src/utils/GeoUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAOjE;;;;;;;IAOI;AACJ,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CA+B1D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE,CAAC;AACrE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC;AACzE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC"}

package/build/utils/GeoUtils.js

@@ -5,11 +5,11 @@
  *
  * @param point 坐标点
  * @returns { latitude, longitude } 对象
- */
+  */
 export function normalizeLatLng(point) {
     if (Array.isArray(point)) {
-        let longitude = Number(point[0]);
-        let latitude = Number(point[1]);
+        const longitude = Number(point[0]);
+        const latitude = Number(point[1]);
         // 智能纠错：如果纬度超出范围 [-90, 90] 且交换后在范围内，则认为是用户传反了
         if (Math.abs(latitude) > 90 && Math.abs(longitude) <= 90) {
             console.warn(`[expo-gaode-map] 检测到坐标数组格式可能为 [latitude, longitude] (${point})，已自动纠正为 [longitude, latitude]。建议显式使用 [经度, 纬度] 格式以遵循 GeoJSON 标准。`);

package/build/utils/GeoUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"GeoUtils.js","sourceRoot":"","sources":["../../src/utils/GeoUtils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 地理位置工具类\n */\nimport { LatLng, LatLngPoint } from '../types/common.types';\n\ntype LatLngLike = {\n  latitude?: unknown;\n  longitude?: unknown;\n};\n\n/**\n * 将坐标点归一化为对象格式\n * 支持 [longitude, latitude] 数组或 { latitude, longitude } 对象\n * 注意：数组格式遵循 GeoJSON 标准，即 [经度, 纬度]\n * \n * @param point 坐标点\n * @returns { latitude, longitude } 对象\n */\nexport function normalizeLatLng(point: LatLngPoint): LatLng {\n  if (Array.isArray(point)) {\n    let longitude = Number(point[0]);\n    let latitude = Number(point[1]);\n\n    // 智能纠错：如果纬度超出范围 [-90, 90] 且交换后在范围内，则认为是用户传反了\n    if (Math.abs(latitude) > 90 && Math.abs(longitude) <= 90) {\n      console.warn(\n        `[expo-gaode-map] 检测到坐标数组格式可能为 [latitude, longitude] (${point})，已自动纠正为 [longitude, latitude]。建议显式使用 [经度, 纬度] 格式以遵循 GeoJSON 标准。`\n      );\n      return {\n        latitude: longitude,\n        longitude: latitude\n      };\n    }\n\n    return {\n      longitude,\n      latitude,\n    };\n  }\n  // 对象格式：强制转换为数字，防止传入 string 类型导致原生层 Crash\n  if (point && typeof point === 'object') {\n    const p = point as LatLngLike;\n    return {\n      latitude: Number(p.latitude),\n      longitude: Number(p.longitude),\n    };\n  }\n  \n  return point as LatLng;\n}\n\n/**\n * 将坐标点数组归一化为对象数组\n * 支持一维数组 [p1, p2, ...] 或二维嵌套数组 [[p1, p2, ...], [p3, p4, ...]]\n * \n * @param points 坐标点数组或嵌套数组\n * @returns 归一化后的坐标数组\n */\nexport function normalizeLatLngList(points: LatLngPoint[]): LatLng[];\nexport function normalizeLatLngList(points: LatLngPoint[][]): LatLng[][];\nexport function normalizeLatLngList(points: LatLngPoint[] | LatLngPoint[][]): LatLng[] | LatLng[][];\nexport function normalizeLatLngList(\n  points: LatLngPoint[] | LatLngPoint[][]\n): LatLng[] | LatLng[][] {\n  if (!points || points.length === 0) return [];\n\n  // 检查是否为嵌套数组 (检查第一项是否也是数组或对象，且不符合 LatLngPoint 的基本判断)\n  // 如果第一项是数组且长度 > 2，或者第一项的第一个元素也是数组/对象，则认为是嵌套数组\n  const firstItem = points[0];\n  \n  if (Array.isArray(firstItem)) {\n    // 如果第一项是 [number, number]，则这可能是一个一维坐标点数组 (LatLngPoint[])\n    // 除非所有元素都是数组且至少有一个子数组长度不等于2，或者我们明确知道这是嵌套的\n    // 为了支持 Polygon 的嵌套格式，我们需要递归处理\n    \n    // 启发式判断：如果第一项是数组且它的第一个元素也是数组或对象，那么它一定是嵌套的\n    if (Array.isArray(firstItem[0]) || (typeof firstItem[0] === 'object' && firstItem[0] !== null && 'latitude' in firstItem[0])) {\n      return (points as LatLngPoint[][]).map(ring => ring.map(normalizeLatLng));\n    }\n    \n    // 另一种情况：用户传入的是 [[lng, lat], [lng, lat]]，这既可以看作 LatLngPoint[]，\n    // 也可以看作 LatLngPoint[][] (只有一个外轮廓)。\n    // 在 Polygon 组件中，我们希望统一处理。\n    // 如果是 Polygon 传入的，我们希望保留嵌套结构。\n    // 但 normalizeLatLngList 是通用的。\n    \n    // 改进逻辑：如果 data[0] 是一个点，我们把它当作一维数组处理。\n    // 如果 data[0] 不是一个点（即它是点的集合），我们当作二维处理。\n    if (isPoint(firstItem)) {\n      return (points as LatLngPoint[]).map(normalizeLatLng);\n    } else {\n      return (points as LatLngPoint[][]).map(ring => ring.map(normalizeLatLng));\n    }\n  }\n\n  return (points as LatLngPoint[]).map(normalizeLatLng);\n}\n\n/**\n * 判断一个对象是否为坐标点 (LatLngPoint)\n */\nfunction isPoint(item: unknown): item is LatLngPoint {\n  if (!item || typeof item !== 'object') return false;\n  // { latitude, longitude } 格式\n  if ('latitude' in item && 'longitude' in (item as Record<string, unknown>)) return true;\n  // [longitude, latitude] 格式\n  if (Array.isArray(item) && item.length >= 2 && typeof item[0] === 'number' && typeof item[1] === 'number') return true;\n  return false;\n}\n"]}
+{"version":3,"file":"GeoUtils.js","sourceRoot":"","sources":["../../src/utils/GeoUtils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 地理位置工具类\n */\nimport type { LatLng, LatLngPoint } from '../types/common.types';\n\ntype LatLngLike = {\n  latitude?: unknown;\n  longitude?: unknown;\n};\n\n/**\n * 将坐标点归一化为对象格式\n * 支持 [longitude, latitude] 数组或 { latitude, longitude } 对象\n * 注意：数组格式遵循 GeoJSON 标准，即 [经度, 纬度]\n * \n * @param point 坐标点\n * @returns { latitude, longitude } 对象\n  */\nexport function normalizeLatLng(point: LatLngPoint): LatLng {\n  if (Array.isArray(point)) {\n    const longitude = Number(point[0]);\n    const latitude = Number(point[1]);\n\n    // 智能纠错：如果纬度超出范围 [-90, 90] 且交换后在范围内，则认为是用户传反了\n    if (Math.abs(latitude) > 90 && Math.abs(longitude) <= 90) {\n      console.warn(\n        `[expo-gaode-map] 检测到坐标数组格式可能为 [latitude, longitude] (${point})，已自动纠正为 [longitude, latitude]。建议显式使用 [经度, 纬度] 格式以遵循 GeoJSON 标准。`\n      );\n      return {\n        latitude: longitude,\n        longitude: latitude\n      };\n    }\n\n    return {\n      longitude,\n      latitude,\n    };\n  }\n  // 对象格式：强制转换为数字，防止传入 string 类型导致原生层 Crash\n  if (point && typeof point === 'object') {\n    const p = point as LatLngLike;\n    return {\n      latitude: Number(p.latitude),\n      longitude: Number(p.longitude),\n    };\n  }\n  \n  return point as LatLng;\n}\n\n/**\n * 将坐标点数组归一化为对象数组\n * 支持一维数组 [p1, p2, ...] 或二维嵌套数组 [[p1, p2, ...], [p3, p4, ...]]\n * \n * @param points 坐标点数组或嵌套数组\n * @returns 归一化后的坐标数组\n */\nexport function normalizeLatLngList(points: LatLngPoint[]): LatLng[];\nexport function normalizeLatLngList(points: LatLngPoint[][]): LatLng[][];\nexport function normalizeLatLngList(points: LatLngPoint[] | LatLngPoint[][]): LatLng[] | LatLng[][];\nexport function normalizeLatLngList(\n  points: LatLngPoint[] | LatLngPoint[][]\n): LatLng[] | LatLng[][] {\n  if (!points || points.length === 0) return [];\n\n  // 检查是否为嵌套数组 (检查第一项是否也是数组或对象，且不符合 LatLngPoint 的基本判断)\n  // 如果第一项是数组且长度 > 2，或者第一项的第一个元素也是数组/对象，则认为是嵌套数组\n  const firstItem = points[0];\n  \n  if (Array.isArray(firstItem)) {\n    // 如果第一项是 [number, number]，则这可能是一个一维坐标点数组 (LatLngPoint[])\n    // 除非所有元素都是数组且至少有一个子数组长度不等于2，或者我们明确知道这是嵌套的\n    // 为了支持 Polygon 的嵌套格式，我们需要递归处理\n    \n    // 启发式判断：如果第一项是数组且它的第一个元素也是数组或对象，那么它一定是嵌套的\n    if (Array.isArray(firstItem[0]) || (typeof firstItem[0] === 'object' && firstItem[0] !== null && 'latitude' in firstItem[0])) {\n      return (points as LatLngPoint[][]).map(ring => ring.map(normalizeLatLng));\n    }\n    \n    // 另一种情况：用户传入的是 [[lng, lat], [lng, lat]]，这既可以看作 LatLngPoint[]，\n    // 也可以看作 LatLngPoint[][] (只有一个外轮廓)。\n    // 在 Polygon 组件中，我们希望统一处理。\n    // 如果是 Polygon 传入的，我们希望保留嵌套结构。\n    // 但 normalizeLatLngList 是通用的。\n    \n    // 改进逻辑：如果 data[0] 是一个点，我们把它当作一维数组处理。\n    // 如果 data[0] 不是一个点（即它是点的集合），我们当作二维处理。\n    if (isPoint(firstItem)) {\n      return (points as LatLngPoint[]).map(normalizeLatLng);\n    } else {\n      return (points as LatLngPoint[][]).map(ring => ring.map(normalizeLatLng));\n    }\n  }\n\n  return (points as LatLngPoint[]).map(normalizeLatLng);\n}\n\n/**\n * 判断一个对象是否为坐标点 (LatLngPoint)\n */\nfunction isPoint(item: unknown): item is LatLngPoint {\n  if (!item || typeof item !== 'object') return false;\n  // { latitude, longitude } 格式\n  if ('latitude' in item && 'longitude' in (item as Record<string, unknown>)) return true;\n  // [longitude, latitude] 格式\n  if (Array.isArray(item) && item.length >= 2 && typeof item[0] === 'number' && typeof item[1] === 'number') return true;\n  return false;\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"RouteUtils.d.ts","sourceRoot":"","sources":["../../src/utils/RouteUtils.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAU,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EACjB,WAAW,EACZ,MAAM,+BAA+B,CAAC;AA+EvC;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,GAAG,SAAS,CAAM,GACjE,MAAM,CAQR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EAAE,EACrB,OAAO,GAAE,IAAI,CACX,uBAAuB,EACvB,eAAe,GAAG,WAAW,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,SAAS,GAAG,SAAS,CAC1F,GACL,WAAW,GAAG,IAAI,CAqCpB;AAkCD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CA0B1E;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,sBAAsB,EAC3B,MAAM,EAAE,WAAW,EAAE,EACrB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,IAAI,CAAC,CAyCf;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,YAAY,GAAG,IAAI,CAgB5E"}
+{"version":3,"file":"RouteUtils.d.ts","sourceRoot":"","sources":["../../src/utils/RouteUtils.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAU,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,EACjB,WAAW,EACZ,MAAM,+BAA+B,CAAC;AA+EvC;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,GAAG,SAAS,CAAM,GACjE,MAAM,CAQR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EAAE,EACrB,OAAO,GAAE,IAAI,CACX,uBAAuB,EACvB,eAAe,GAAG,WAAW,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,SAAS,GAAG,SAAS,CAC1F,GACL,WAAW,GAAG,IAAI,CAqCpB;AAkCD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CA0B1E;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,sBAAsB,EAC3B,MAAM,EAAE,WAAW,EAAE,EACrB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,IAAI,CAAC,CA4Cf;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,YAAY,GAAG,IAAI,CAgB5E"}

package/build/utils/RouteUtils.js

@@ -6,7 +6,7 @@
  * 这些逻辑用于在 JS 层统一处理路线回放、区域遮罩和路径自适应视野等场景。
  */
 import ExpoGaodeMapModule from '../ExpoGaodeMapModule';
-import { normalizeLatLng, normalizeLatLngList } from './GeoUtils';
+import { normalizeLatLngList } from './GeoUtils';
 const MIN_ZOOM = 3; // 最小缩放级别
 const MAX_ZOOM = 20; // 最大缩放级别
 const DEFAULT_SINGLE_POINT_ZOOM = 16; // 默认单点缩放级别
@@ -213,7 +213,10 @@ export async function fitCameraToCoordinates(map, points, options = {}) {
     }
     const currentCamera = await map.getCameraPosition().catch(() => ({}));
     if (normalized.length === 1) {
-        const single = normalizeLatLng(normalized[0]);
+        const single = normalized[0];
+        if (!single) {
+            return;
+        }
         await map.moveCamera({
             target: single,
             zoom: options.singlePointZoom ?? currentCamera.zoom ?? DEFAULT_SINGLE_POINT_ZOOM,

package/build/utils/RouteUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"RouteUtils.js","sourceRoot":"","sources":["../../src/utils/RouteUtils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,kBAAkB,MAAM,uBAAuB,CAAC;AAQvD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAElE,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,SAAS;AAC7B,MAAM,QAAQ,GAAG,EAAE,CAAC,CAAC,SAAS;AAC9B,MAAM,yBAAyB,GAAG,EAAE,CAAC,CAAC,WAAW;AACjD,MAAM,sBAAsB,GAAG,GAAG,CAAC,CAAC,SAAS;AAC7C,MAAM,yBAAyB,GAAG,GAAG,CAAC,CAAC,aAAa;AACpD,MAAM,0BAA0B,GAAG,GAAG,CAAC,CAAC,aAAa;AACrD,MAAM,kBAAkB,GAAG,EAAE,CAAC,CAAC,YAAY;AAE3C;;;;;;;;;;;GAWG;AACH,SAAS,wBAAwB,CAC/B,aAAqB,EACrB,eAAuB,EACvB,gBAAwB;IAExB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;QAC1D,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,YAAY,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACjD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,gBAAgB,CAAC,GAAG,YAAY,CAAC,CAAC;AACjF,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,gBAAgB,CACvB,MAAgB,EAChB,OAGC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,yBAAyB,CAAC;IAC7E,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,0BAA0B,CAAC;IAChF,MAAM,iBAAiB,GAAG,wBAAwB,CAChD,OAAO,CAAC,aAAa,IAAI,sBAAsB,EAC/C,eAAe,EACf,gBAAgB,CACjB,CAAC;IACF,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAExG,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,gBAAgB,CAAC,MAAM,EAAE;YACjD,eAAe;YACf,gBAAgB;YAChB,SAAS;YACT,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,aAAqB,EACrB,cAAsB,EACtB,UAAgE,EAAE;IAElE,4BAA4B;IAC5B,2CAA2C;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,QAAQ,CAAC;IAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,QAAQ,CAAC;IAC5C,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAqB,EACrB,UAGI,EAAE;IAEN,gCAAgC;IAChC,MAAM,UAAU,GAAG,mBAAmB,CAAC,MAAM,CAAa,CAAC;IAC3D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAE9D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC;IACrC,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,sBAAsB,CAAC;IACtE,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,aAAa,EAAE,MAAM,CAAC,CAAC;IACxE,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,aAAa,EAAE,MAAM,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,gBAAgB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACzD,MAAM,YAAY,GAAG,iBAAiB,CAAC,aAAa,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;IAE/E,OAAO;QACL,MAAM,EAAE;YACN,QAAQ,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC;YAC7B,SAAS,EAAE,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC;SAC7B;QACD,MAAM,EAAE;YACN,KAAK;YACL,KAAK;YACL,IAAI;YACJ,IAAI;SACL;QACD,IAAI,EAAE;YACJ,aAAa;YACb,cAAc;SACf;QACD,eAAe,EAAE,UAAU,IAAI,YAAY;KAC5C,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,iBAAiB,CAAC,QAAgB;IACzC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QACrB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,QAAQ;SACZ,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;SAChC,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACf,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACtF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9D,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO;YACL,QAAQ;YACR,SAAS;SACV,CAAC;IACJ,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,mCAAmC;IACnC,wBAAwB;IACxB,MAAM,KAAK,GAAG,QAAQ;SACnB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;SACtC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAErC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM;QAC7B,CAAC,CAAC;YACE,SAAS,EAAE;gBACT,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAC/D,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;aAClE;YACD,SAAS,EAAE;gBACT,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAC/D,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;aAClE;SACF;QACH,CAAC,CAAC,IAAI,CAAC;IAET,OAAO;QACL,KAAK;QACL,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,GAA2B,EAC3B,MAAqB,EACrB,UAAmC,EAAE;IAErC,UAAU;IACV,iBAAiB;IACjB,oBAAoB;IACpB,yBAAyB;IACzB,MAAM,UAAU,GAAG,mBAAmB,CAAC,MAAM,CAAa,CAAC;IAC3D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;IACT,CAAC;IAED,MAAM,aAAa,GACjB,MAAM,GAAG,CAAC,iBAAiB,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAElD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,MAAM,GAAG,CAAC,UAAU,CAClB;YACE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,OAAO,CAAC,eAAe,IAAI,aAAa,CAAC,IAAI,IAAI,yBAAyB;YAChF,OAAO,EAAE,OAAO,CAAC,eAAe,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO;YACvG,IAAI,EAAE,OAAO,CAAC,YAAY,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI;SACzF,EACD,OAAO,CAAC,QAAQ,IAAI,CAAC,CACtB,CAAC;QACF,OAAO;IACT,CAAC;IAED,MAAM,WAAW,GAAG,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACxD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO;IACT,CAAC;IAED,MAAM,GAAG,CAAC,UAAU,CAClB;QACE,MAAM,EAAE,WAAW,CAAC,MAAM;QAC1B,IAAI,EAAE,WAAW,CAAC,eAAe;QACjC,OAAO,EAAE,OAAO,CAAC,eAAe,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO;QACvG,IAAI,EAAE,OAAO,CAAC,YAAY,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI;KACzF,EACD,OAAO,CAAC,QAAQ,IAAI,CAAC,CACtB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAqB;IACrD,MAAM,WAAW,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,SAAS,EAAE;YACT,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK;YAClC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,IAAI;SACnC;QACD,SAAS,EAAE;YACT,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK;YAClC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,IAAI;SACnC;KACF,CAAC;AACJ,CAAC","sourcesContent":["/**\n * 路线与区域展示相关的工具函数。\n *\n * 本文件主要负责路径坐标的边界计算、推荐缩放级别估算、\n * 高德 polyline / 多环边界字符串解析，以及将地图相机移动到合适的展示范围。\n * 这些逻辑用于在 JS 层统一处理路线回放、区域遮罩和路径自适应视野等场景。\n */\nimport ExpoGaodeMapModule from '../ExpoGaodeMapModule';\nimport type { LatLng, LatLngBounds, LatLngPoint } from '../types/common.types';\nimport type {\n  FitToCoordinatesOptions,\n  FitToCoordinatesTarget,\n  MultiRingPolyline,\n  RouteBounds,\n} from '../types/route-playback.types';\nimport { normalizeLatLng, normalizeLatLngList } from './GeoUtils';\n\nconst MIN_ZOOM = 3; // 最小缩放级别\nconst MAX_ZOOM = 20; // 最大缩放级别\nconst DEFAULT_SINGLE_POINT_ZOOM = 16; // 默认单点缩放级别\nconst DEFAULT_PADDING_FACTOR = 1.2; // 默认缓冲因子\nconst DEFAULT_VIEWPORT_WIDTH_PX = 390; // 默认视口宽度（像素）\nconst DEFAULT_VIEWPORT_HEIGHT_PX = 844; // 默认视口高度（像素）\nconst DEFAULT_PADDING_PX = 48; // 默认缓冲值（像素）\n\n/**\n * 将缩放缓冲因子换算成地图四周需要预留的像素 padding。\n *\n * paddingFactor 表示“视野比实际路径范围放大多少倍”：\n * - 1 表示不额外留白；\n * - 1.2 表示路径只占视口中间约 83%，四周留出约 8.3% 的空白。\n *\n * @param paddingFactor 缓冲因子，必须大于 1 才会产生 padding。\n * @param viewportWidthPx 视口宽度，单位像素。\n * @param viewportHeightPx 视口高度，单位像素。\n * @returns 以较短边计算得到的单边 padding，单位像素。\n */\nfunction paddingFactorToPaddingPx(\n  paddingFactor: number,\n  viewportWidthPx: number,\n  viewportHeightPx: number\n): number {\n  if (!Number.isFinite(paddingFactor) || paddingFactor <= 1) {\n    return 0;\n  }\n  const paddingRatio = (1 - 1 / paddingFactor) / 2;\n  return Math.max(0, Math.min(viewportWidthPx, viewportHeightPx) * paddingRatio);\n}\n\n/**\n * 优先调用原生模块计算适配一组坐标的推荐缩放级别。\n *\n * 原生侧通常能结合地图 SDK 的投影与缩放规则给出更接近真实显示效果的 zoom。\n * 如果原生模块不可用或计算失败，返回 null，由上层使用纯 TS 估算逻辑兜底。\n *\n * @param points 路径点列表，每个点包含经纬度。\n * @param options 选项对象，包含缓冲因子、视口宽度、视口高度、最小缩放级别、最大缩放级别。\n * @defaultOptions 默认选项值。\n * @returns 推荐缩放级别，可能为 null。\n */\nfunction calculateFitZoom(\n  points: LatLng[],\n  options: Pick<\n    FitToCoordinatesOptions,\n    'paddingFactor' | 'paddingPx' | 'viewportWidthPx' | 'viewportHeightPx' | 'minZoom' | 'maxZoom'\n  >\n): number | null {\n  if (points.length === 0) {\n    return null;\n  }\n\n  const viewportWidthPx = options.viewportWidthPx ?? DEFAULT_VIEWPORT_WIDTH_PX;\n  const viewportHeightPx = options.viewportHeightPx ?? DEFAULT_VIEWPORT_HEIGHT_PX;\n  const paddingFromFactor = paddingFactorToPaddingPx(\n    options.paddingFactor ?? DEFAULT_PADDING_FACTOR,\n    viewportWidthPx,\n    viewportHeightPx\n  );\n  const paddingPx = options.paddingPx ?? (paddingFromFactor > 0 ? paddingFromFactor : DEFAULT_PADDING_PX);\n\n  try {\n    return ExpoGaodeMapModule.calculateFitZoom(points, {\n      viewportWidthPx,\n      viewportHeightPx,\n      paddingPx,\n      minZoom: options.minZoom,\n      maxZoom: options.maxZoom,\n    });\n  } catch {\n    return null;\n  }\n}\n\n/**\n * 估算路径的推荐缩放级别\n * @param {number} latitudeDelta - 纬度跨度（度）\n * @param {number} longitudeDelta - 经度跨度（度）\n * @param {FitToCoordinatesOptions} options - 选项对象，包含最小缩放级别、最大缩放级别\n * @defaultOptions 默认选项值\n * @returns {number} - 推荐缩放级别\n */\nexport function estimateZoomLevel(\n  latitudeDelta: number,\n  longitudeDelta: number,\n  options: Pick<FitToCoordinatesOptions, 'minZoom' | 'maxZoom'> = {}\n): number {\n  // 使用经纬度跨度估算一个“足够看全路径”的缩放级别。\n  // 这是高层 TS 兜底逻辑，不依赖具体原生 SDK 的 fitBounds 能力。\n  const span = Math.max(latitudeDelta, longitudeDelta, 0.0001);\n  const rawZoom = Math.log2(360 / span);\n  const minZoom = options.minZoom ?? MIN_ZOOM;\n  const maxZoom = options.maxZoom ?? MAX_ZOOM;\n  return Math.max(minZoom, Math.min(maxZoom, Number(rawZoom.toFixed(2))));\n}\n\n/**\n * 根据路径点计算地图展示所需的中心点、外接矩形、经纬度跨度和推荐缩放级别。\n *\n * 该函数会先统一坐标格式，再根据所有点的最南/北/东/西位置生成边界。\n * recommendedZoom 优先使用原生计算结果，失败时退回到经纬度跨度估算。\n * \n * @param points 路径点列表，每个点包含经纬度。\n * @param options 选项对象，包含缓冲因子、视口宽度、视口高度、最小缩放级别、最大缩放级别。\n * @defaultOptions 默认选项值。\n * @returns 推荐缩放级别，可能为 null。\n */\nexport function getRouteBounds(\n  points: LatLngPoint[],\n  options: Pick<\n    FitToCoordinatesOptions,\n    'paddingFactor' | 'paddingPx' | 'viewportWidthPx' | 'viewportHeightPx' | 'minZoom' | 'maxZoom'\n  > = {}\n): RouteBounds | null {\n  // 统一将路径点转换为对象坐标，再计算中心点、边界和推荐缩放。\n  const normalized = normalizeLatLngList(points) as LatLng[];\n  if (normalized.length === 0) {\n    return null;\n  }\n\n  const latitudes = normalized.map((point) => point.latitude);\n  const longitudes = normalized.map((point) => point.longitude);\n\n  const north = Math.max(...latitudes);\n  const south = Math.min(...latitudes);\n  const east = Math.max(...longitudes);\n  const west = Math.min(...longitudes);\n  const paddingFactor = options.paddingFactor ?? DEFAULT_PADDING_FACTOR;\n  const latitudeDelta = Math.max((north - south) * paddingFactor, 0.0001);\n  const longitudeDelta = Math.max((east - west) * paddingFactor, 0.0001);\n  const nativeZoom = calculateFitZoom(normalized, options);\n  const fallbackZoom = estimateZoomLevel(latitudeDelta, longitudeDelta, options);\n\n  return {\n    center: {\n      latitude: (north + south) / 2,\n      longitude: (east + west) / 2,\n    },\n    bounds: {\n      north,\n      south,\n      east,\n      west,\n    },\n    span: {\n      latitudeDelta,\n      longitudeDelta,\n    },\n    recommendedZoom: nativeZoom ?? fallbackZoom,\n  };\n}\n\n/**\n * 解析单个高德 polyline 环。\n *\n * 高德返回的 polyline 字符串通常为 `longitude,latitude;longitude,latitude`。\n * 这里会忽略空片段和非法坐标，避免单个异常点导致整个边界解析失败。\n * \n * @param polyline 高德 polyline 字符串。\n * @returns 解析后的 LatLng 点数组。\n */\nfunction parsePolylineRing(polyline: string): LatLng[] {\n  if (!polyline.trim()) {\n    return [];\n  }\n\n  return polyline\n    .split(';')\n    .map((segment) => segment.trim())\n    .filter(Boolean)\n    .map((segment) => {\n      const [longitude, latitude] = segment.split(',').map((value) => Number(value.trim()));\n      if (!Number.isFinite(longitude) || !Number.isFinite(latitude)) {\n        return null;\n      }\n\n      return {\n        latitude,\n        longitude,\n      };\n    })\n    .filter((point): point is LatLng => point !== null);\n}\n\n/**\n * 解析高德多环 polyline，并计算整体坐标边界。\n *\n * 常用于 AOI、行政区或多边形边界等场景。高德以 `|` 分隔多个环，\n * 每个环内部再以 `;` 分隔坐标点。\n * \n * @param polyline 高德 polyline 字符串。\n * @returns 解析后的 LatLng 点数组数组。\n */\nexport function parseMultiRingPolyline(polyline: string): MultiRingPolyline {\n  // 高德 AOI / 多边形边界常见格式为 ring1|ring2，\n  // 这里按“外环/内环”统一拆成二维坐标数组。\n  const rings = polyline\n    .split('|')\n    .map((ring) => parsePolylineRing(ring))\n    .filter((ring) => ring.length > 0);\n\n  const flattened = rings.flat();\n  const bounds = flattened.length\n    ? {\n        southwest: {\n          latitude: Math.min(...flattened.map((point) => point.latitude)),\n          longitude: Math.min(...flattened.map((point) => point.longitude)),\n        },\n        northeast: {\n          latitude: Math.max(...flattened.map((point) => point.latitude)),\n          longitude: Math.max(...flattened.map((point) => point.longitude)),\n        },\n      }\n    : null;\n\n  return {\n    rings,\n    bounds,\n  };\n}\n\n/**\n * 将地图相机移动到能够完整展示指定坐标集合的位置。\n *\n * 单点场景直接定位到该点；多点场景会先计算路径边界，再移动到边界中心并应用推荐缩放。\n * 默认会沿用当前相机的 bearing 和 tilt，除非调用方显式关闭 preserveBearing / preserveTilt。\n * \n * @param map 高德地图实例。\n * @param points 路径点列表，每个点包含经纬度。\n * @param options 选项对象，包含移动时间、缓冲因子、视口宽度、视口高度、最小缩放级别、最大缩放级别。\n * @defaultOptions 默认选项值。\n */\nexport async function fitCameraToCoordinates(\n  map: FitToCoordinatesTarget,\n  points: LatLngPoint[],\n  options: FitToCoordinatesOptions = {}\n): Promise<void> {\n  // 高层相机适配：\n  // 1. 单点时直接移动到该点；\n  // 2. 多点时计算中心点与推荐缩放；\n  // 3. 尽量保留当前朝向和俯仰，避免突兀跳变。\n  const normalized = normalizeLatLngList(points) as LatLng[];\n  if (normalized.length === 0) {\n    return;\n  }\n\n  const currentCamera: Awaited<ReturnType<FitToCoordinatesTarget['getCameraPosition']>> =\n    await map.getCameraPosition().catch(() => ({}));\n\n  if (normalized.length === 1) {\n    const single = normalizeLatLng(normalized[0]);\n    await map.moveCamera(\n      {\n        target: single,\n        zoom: options.singlePointZoom ?? currentCamera.zoom ?? DEFAULT_SINGLE_POINT_ZOOM,\n        bearing: options.preserveBearing === false ? options.bearing : currentCamera.bearing ?? options.bearing,\n        tilt: options.preserveTilt === false ? options.tilt : currentCamera.tilt ?? options.tilt,\n      },\n      options.duration ?? 0\n    );\n    return;\n  }\n\n  const routeBounds = getRouteBounds(normalized, options);\n  if (!routeBounds) {\n    return;\n  }\n\n  await map.moveCamera(\n    {\n      target: routeBounds.center,\n      zoom: routeBounds.recommendedZoom,\n      bearing: options.preserveBearing === false ? options.bearing : currentCamera.bearing ?? options.bearing,\n      tilt: options.preserveTilt === false ? options.tilt : currentCamera.tilt ?? options.tilt,\n    },\n    options.duration ?? 0\n  );\n}\n\n/**\n * 将路径点转换为高德地图通用的西南/东北矩形边界。\n * \n * @param points 路径点列表，每个点包含经纬度。\n * @returns 高德地图通用的西南/东北矩形边界。\n */\nexport function buildLatLngBounds(points: LatLngPoint[]): LatLngBounds | null {\n  const routeBounds = getRouteBounds(points);\n  if (!routeBounds) {\n    return null;\n  }\n\n  return {\n    southwest: {\n      latitude: routeBounds.bounds.south,\n      longitude: routeBounds.bounds.west,\n    },\n    northeast: {\n      latitude: routeBounds.bounds.north,\n      longitude: routeBounds.bounds.east,\n    },\n  };\n}\n"]}
+{"version":3,"file":"RouteUtils.js","sourceRoot":"","sources":["../../src/utils/RouteUtils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 路线与区域展示相关的工具函数。\n *\n * 本文件主要负责路径坐标的边界计算、推荐缩放级别估算、\n * 高德 polyline / 多环边界字符串解析，以及将地图相机移动到合适的展示范围。\n * 这些逻辑用于在 JS 层统一处理路线回放、区域遮罩和路径自适应视野等场景。\n */\nimport ExpoGaodeMapModule from '../ExpoGaodeMapModule';\nimport type { LatLng, LatLngBounds, LatLngPoint } from '../types/common.types';\nimport type {\n  FitToCoordinatesOptions,\n  FitToCoordinatesTarget,\n  MultiRingPolyline,\n  RouteBounds,\n} from '../types/route-playback.types';\nimport { normalizeLatLngList } from './GeoUtils';\n\nconst MIN_ZOOM = 3; // 最小缩放级别\nconst MAX_ZOOM = 20; // 最大缩放级别\nconst DEFAULT_SINGLE_POINT_ZOOM = 16; // 默认单点缩放级别\nconst DEFAULT_PADDING_FACTOR = 1.2; // 默认缓冲因子\nconst DEFAULT_VIEWPORT_WIDTH_PX = 390; // 默认视口宽度（像素）\nconst DEFAULT_VIEWPORT_HEIGHT_PX = 844; // 默认视口高度（像素）\nconst DEFAULT_PADDING_PX = 48; // 默认缓冲值（像素）\n\n/**\n * 将缩放缓冲因子换算成地图四周需要预留的像素 padding。\n *\n * paddingFactor 表示“视野比实际路径范围放大多少倍”：\n * - 1 表示不额外留白；\n * - 1.2 表示路径只占视口中间约 83%，四周留出约 8.3% 的空白。\n *\n * @param paddingFactor 缓冲因子，必须大于 1 才会产生 padding。\n * @param viewportWidthPx 视口宽度，单位像素。\n * @param viewportHeightPx 视口高度，单位像素。\n * @returns 以较短边计算得到的单边 padding，单位像素。\n */\nfunction paddingFactorToPaddingPx(\n  paddingFactor: number,\n  viewportWidthPx: number,\n  viewportHeightPx: number\n): number {\n  if (!Number.isFinite(paddingFactor) || paddingFactor <= 1) {\n    return 0;\n  }\n  const paddingRatio = (1 - 1 / paddingFactor) / 2;\n  return Math.max(0, Math.min(viewportWidthPx, viewportHeightPx) * paddingRatio);\n}\n\n/**\n * 优先调用原生模块计算适配一组坐标的推荐缩放级别。\n *\n * 原生侧通常能结合地图 SDK 的投影与缩放规则给出更接近真实显示效果的 zoom。\n * 如果原生模块不可用或计算失败，返回 null，由上层使用纯 TS 估算逻辑兜底。\n *\n * @param points 路径点列表，每个点包含经纬度。\n * @param options 选项对象，包含缓冲因子、视口宽度、视口高度、最小缩放级别、最大缩放级别。\n * @defaultOptions 默认选项值。\n * @returns 推荐缩放级别，可能为 null。\n */\nfunction calculateFitZoom(\n  points: LatLng[],\n  options: Pick<\n    FitToCoordinatesOptions,\n    'paddingFactor' | 'paddingPx' | 'viewportWidthPx' | 'viewportHeightPx' | 'minZoom' | 'maxZoom'\n  >\n): number | null {\n  if (points.length === 0) {\n    return null;\n  }\n\n  const viewportWidthPx = options.viewportWidthPx ?? DEFAULT_VIEWPORT_WIDTH_PX;\n  const viewportHeightPx = options.viewportHeightPx ?? DEFAULT_VIEWPORT_HEIGHT_PX;\n  const paddingFromFactor = paddingFactorToPaddingPx(\n    options.paddingFactor ?? DEFAULT_PADDING_FACTOR,\n    viewportWidthPx,\n    viewportHeightPx\n  );\n  const paddingPx = options.paddingPx ?? (paddingFromFactor > 0 ? paddingFromFactor : DEFAULT_PADDING_PX);\n\n  try {\n    return ExpoGaodeMapModule.calculateFitZoom(points, {\n      viewportWidthPx,\n      viewportHeightPx,\n      paddingPx,\n      minZoom: options.minZoom,\n      maxZoom: options.maxZoom,\n    });\n  } catch {\n    return null;\n  }\n}\n\n/**\n * 估算路径的推荐缩放级别\n * @param {number} latitudeDelta - 纬度跨度（度）\n * @param {number} longitudeDelta - 经度跨度（度）\n * @param {FitToCoordinatesOptions} options - 选项对象，包含最小缩放级别、最大缩放级别\n * @defaultOptions 默认选项值\n * @returns {number} - 推荐缩放级别\n */\nexport function estimateZoomLevel(\n  latitudeDelta: number,\n  longitudeDelta: number,\n  options: Pick<FitToCoordinatesOptions, 'minZoom' | 'maxZoom'> = {}\n): number {\n  // 使用经纬度跨度估算一个“足够看全路径”的缩放级别。\n  // 这是高层 TS 兜底逻辑，不依赖具体原生 SDK 的 fitBounds 能力。\n  const span = Math.max(latitudeDelta, longitudeDelta, 0.0001);\n  const rawZoom = Math.log2(360 / span);\n  const minZoom = options.minZoom ?? MIN_ZOOM;\n  const maxZoom = options.maxZoom ?? MAX_ZOOM;\n  return Math.max(minZoom, Math.min(maxZoom, Number(rawZoom.toFixed(2))));\n}\n\n/**\n * 根据路径点计算地图展示所需的中心点、外接矩形、经纬度跨度和推荐缩放级别。\n *\n * 该函数会先统一坐标格式，再根据所有点的最南/北/东/西位置生成边界。\n * recommendedZoom 优先使用原生计算结果，失败时退回到经纬度跨度估算。\n * \n * @param points 路径点列表，每个点包含经纬度。\n * @param options 选项对象，包含缓冲因子、视口宽度、视口高度、最小缩放级别、最大缩放级别。\n * @defaultOptions 默认选项值。\n * @returns 推荐缩放级别，可能为 null。\n */\nexport function getRouteBounds(\n  points: LatLngPoint[],\n  options: Pick<\n    FitToCoordinatesOptions,\n    'paddingFactor' | 'paddingPx' | 'viewportWidthPx' | 'viewportHeightPx' | 'minZoom' | 'maxZoom'\n  > = {}\n): RouteBounds | null {\n  // 统一将路径点转换为对象坐标，再计算中心点、边界和推荐缩放。\n  const normalized = normalizeLatLngList(points) as LatLng[];\n  if (normalized.length === 0) {\n    return null;\n  }\n\n  const latitudes = normalized.map((point) => point.latitude);\n  const longitudes = normalized.map((point) => point.longitude);\n\n  const north = Math.max(...latitudes);\n  const south = Math.min(...latitudes);\n  const east = Math.max(...longitudes);\n  const west = Math.min(...longitudes);\n  const paddingFactor = options.paddingFactor ?? DEFAULT_PADDING_FACTOR;\n  const latitudeDelta = Math.max((north - south) * paddingFactor, 0.0001);\n  const longitudeDelta = Math.max((east - west) * paddingFactor, 0.0001);\n  const nativeZoom = calculateFitZoom(normalized, options);\n  const fallbackZoom = estimateZoomLevel(latitudeDelta, longitudeDelta, options);\n\n  return {\n    center: {\n      latitude: (north + south) / 2,\n      longitude: (east + west) / 2,\n    },\n    bounds: {\n      north,\n      south,\n      east,\n      west,\n    },\n    span: {\n      latitudeDelta,\n      longitudeDelta,\n    },\n    recommendedZoom: nativeZoom ?? fallbackZoom,\n  };\n}\n\n/**\n * 解析单个高德 polyline 环。\n *\n * 高德返回的 polyline 字符串通常为 `longitude,latitude;longitude,latitude`。\n * 这里会忽略空片段和非法坐标，避免单个异常点导致整个边界解析失败。\n * \n * @param polyline 高德 polyline 字符串。\n * @returns 解析后的 LatLng 点数组。\n */\nfunction parsePolylineRing(polyline: string): LatLng[] {\n  if (!polyline.trim()) {\n    return [];\n  }\n\n  return polyline\n    .split(';')\n    .map((segment) => segment.trim())\n    .filter(Boolean)\n    .map((segment) => {\n      const [longitude, latitude] = segment.split(',').map((value) => Number(value.trim()));\n      if (!Number.isFinite(longitude) || !Number.isFinite(latitude)) {\n        return null;\n      }\n\n      return {\n        latitude,\n        longitude,\n      };\n    })\n    .filter((point): point is LatLng => point !== null);\n}\n\n/**\n * 解析高德多环 polyline，并计算整体坐标边界。\n *\n * 常用于 AOI、行政区或多边形边界等场景。高德以 `|` 分隔多个环，\n * 每个环内部再以 `;` 分隔坐标点。\n * \n * @param polyline 高德 polyline 字符串。\n * @returns 解析后的 LatLng 点数组数组。\n */\nexport function parseMultiRingPolyline(polyline: string): MultiRingPolyline {\n  // 高德 AOI / 多边形边界常见格式为 ring1|ring2，\n  // 这里按“外环/内环”统一拆成二维坐标数组。\n  const rings = polyline\n    .split('|')\n    .map((ring) => parsePolylineRing(ring))\n    .filter((ring) => ring.length > 0);\n\n  const flattened = rings.flat();\n  const bounds = flattened.length\n    ? {\n        southwest: {\n          latitude: Math.min(...flattened.map((point) => point.latitude)),\n          longitude: Math.min(...flattened.map((point) => point.longitude)),\n        },\n        northeast: {\n          latitude: Math.max(...flattened.map((point) => point.latitude)),\n          longitude: Math.max(...flattened.map((point) => point.longitude)),\n        },\n      }\n    : null;\n\n  return {\n    rings,\n    bounds,\n  };\n}\n\n/**\n * 将地图相机移动到能够完整展示指定坐标集合的位置。\n *\n * 单点场景直接定位到该点；多点场景会先计算路径边界，再移动到边界中心并应用推荐缩放。\n * 默认会沿用当前相机的 bearing 和 tilt，除非调用方显式关闭 preserveBearing / preserveTilt。\n * \n * @param map 高德地图实例。\n * @param points 路径点列表，每个点包含经纬度。\n * @param options 选项对象，包含移动时间、缓冲因子、视口宽度、视口高度、最小缩放级别、最大缩放级别。\n * @defaultOptions 默认选项值。\n */\nexport async function fitCameraToCoordinates(\n  map: FitToCoordinatesTarget,\n  points: LatLngPoint[],\n  options: FitToCoordinatesOptions = {}\n): Promise<void> {\n  // 高层相机适配：\n  // 1. 单点时直接移动到该点；\n  // 2. 多点时计算中心点与推荐缩放；\n  // 3. 尽量保留当前朝向和俯仰，避免突兀跳变。\n  const normalized = normalizeLatLngList(points) as LatLng[];\n  if (normalized.length === 0) {\n    return;\n  }\n\n  const currentCamera: Awaited<ReturnType<FitToCoordinatesTarget['getCameraPosition']>> =\n    await map.getCameraPosition().catch(() => ({}));\n\n  if (normalized.length === 1) {\n    const single = normalized[0];\n    if (!single) {\n      return;\n    }\n    await map.moveCamera(\n      {\n        target: single,\n        zoom: options.singlePointZoom ?? currentCamera.zoom ?? DEFAULT_SINGLE_POINT_ZOOM,\n        bearing: options.preserveBearing === false ? options.bearing : currentCamera.bearing ?? options.bearing,\n        tilt: options.preserveTilt === false ? options.tilt : currentCamera.tilt ?? options.tilt,\n      },\n      options.duration ?? 0\n    );\n    return;\n  }\n\n  const routeBounds = getRouteBounds(normalized, options);\n  if (!routeBounds) {\n    return;\n  }\n\n  await map.moveCamera(\n    {\n      target: routeBounds.center,\n      zoom: routeBounds.recommendedZoom,\n      bearing: options.preserveBearing === false ? options.bearing : currentCamera.bearing ?? options.bearing,\n      tilt: options.preserveTilt === false ? options.tilt : currentCamera.tilt ?? options.tilt,\n    },\n    options.duration ?? 0\n  );\n}\n\n/**\n * 将路径点转换为高德地图通用的西南/东北矩形边界。\n * \n * @param points 路径点列表，每个点包含经纬度。\n * @returns 高德地图通用的西南/东北矩形边界。\n */\nexport function buildLatLngBounds(points: LatLngPoint[]): LatLngBounds | null {\n  const routeBounds = getRouteBounds(points);\n  if (!routeBounds) {\n    return null;\n  }\n\n  return {\n    southwest: {\n      latitude: routeBounds.bounds.south,\n      longitude: routeBounds.bounds.west,\n    },\n    northeast: {\n      latitude: routeBounds.bounds.north,\n      longitude: routeBounds.bounds.east,\n    },\n  };\n}\n"]}