expo-gaode-map-navigation 2.0.17 → 2.0.19

package/build/web-api-fallback.js.map

@@ -1 +1 @@
-{"version":3,"file":"web-api-fallback.js","sourceRoot":"","sources":["../src/web-api-fallback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,KAAK,UAAU,kBAAkB,CAAC,OAA4B;IAC5D,IAAI,CAAC;QACH,8DAA8D;QAC9D,MAAM,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;QACjD,IAAI,OAAO,MAAM,EAAE,WAAW,KAAK,UAAU,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,GAAG,OAAO,2EAA2E,CACtF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAAC,QAA6C;IAC3E,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ;SACxB,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACf,OAAO;SACJ,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;SACtD,IAAI,CAAC,GAAG,CAAC,CACb;SACA,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,OAAO,UAAU,IAAI,SAAS,CAAC;AACjC,CAAC;AAED,SAAS,wBAAwB,CAC/B,QAAwB;IAExB,+BAA+B;IAC/B,gCAAgC;IAChC,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,aAAa,CAAC,OAAO;YACxB,OAAO,EAAE,CAAC;QACZ,KAAK,aAAa,CAAC,SAAS;YAC1B,OAAO,CAAC,CAAC;QACX,KAAK,aAAa,CAAC,QAAQ;YACzB,OAAO,CAAC,CAAC;QACX,KAAK,aAAa,CAAC,cAAc;YAC/B,OAAO,EAAE,CAAC;QACZ,KAAK,aAAa,CAAC,gBAAgB;YACjC,OAAO,EAAE,CAAC;QACZ,KAAK,aAAa,CAAC,UAAU;YAC3B,OAAO,EAAE,CAAC;QACZ,KAAK,aAAa,CAAC,2BAA2B;YAC5C,OAAO,EAAE,CAAC;QACZ,KAAK,aAAa,CAAC,qBAAqB,CAAC;QACzC,KAAK,aAAa,CAAC,qBAAqB;YACtC,OAAO,EAAE,CAAC;QACZ,KAAK,aAAa,CAAC,gCAAgC;YACjD,OAAO,EAAE,CAAC;QACZ;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,SAAS,2BAA2B,CAClC,OAA0B,EAC1B,MAAW;IAEX,+CAA+C;IAC/C,gDAAgD;IAChD,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAS,EAAE,KAAa,EAAE,EAAE;QACpD,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,CAAC;YACvD,WAAW,EAAE,IAAI,EAAE,WAAW,IAAI,EAAE;YACpC,WAAW,EAAE,IAAI,EAAE,WAAW;YAC9B,IAAI,EAAE,IAAI,EAAE,SAAS;YACrB,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,aAAa,IAAI,CAAC,CAAC;YAC1C,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,IAAI,CAAC,CAAC;YAC3C,QAAQ,EAAE,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC;YACvC,eAAe,EAAE,IAAI,EAAE,gBAAgB;YACvC,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS;YACrF,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;SAClE,CAAC,CAAC,CAAC;QAEJ,MAAM,eAAe,GAAG,IAAI,EAAE,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAEzF,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,OAAO,CAAC,IAAI;YACnB,GAAG,EAAE,OAAO,CAAC,EAAE;YACf,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,IAAI,CAAC,CAAC;YACrC,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,IAAI,IAAI,EAAE,QAAQ,IAAI,CAAC,CAAC;YAC7D,QAAQ;YACR,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,OAA4B,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;YAC9E,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS;YACrF,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;YACjE,iBAAiB,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS;YAC5F,eAAe;YACf,eAAe,EACb,eAAe,KAAK,CAAC;gBACnB,CAAC,CAAC,WAAW;gBACb,CAAC,CAAC,eAAe,KAAK,CAAC;oBACrB,CAAC,CAAC,QAAQ;oBACV,CAAC,CAAC,SAAS;YACjB,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC;QAC7C,aAAa,EAAE,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAkB,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,MAAM;QACN,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;KAChF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,OAA0B;IACtE,qCAAqC;IACrC,mBAAmB;IACnB,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mCAAmC,CACvD,OAA0B;IAE1B,sCAAsC;IACtC,kCAAkC;IAClC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,OAAO,CACpC,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,EACpD,GAAG,OAAO,CAAC,EAAE,CAAC,SAAS,IAAI,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,EAChD;QACE,QAAQ,EAAE,wBAAwB,CAAC,OAAO,CAAC,QAAQ,CAAC;QACpD,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,GAAG,CAC/B,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,QAAQ,EAAE,CAClD;QACD,aAAa,EAAE,sBAAsB,CAAC,OAAO,CAAC,aAAa,CAAC;QAC5D,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,SAAS;QACjD,KAAK,EAAE,OAAO,CAAC,SAAS;QACxB,WAAW,EAAE,oBAAoB;KAClC,CACF,CAAC;IAEF,OAAO,2BAA2B,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,2BAA2B,CAClC,OAA4B,EAC5B,MAAW;IAEX,gBAAgB;IAChB,2DAA2D;IAC3D,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAY,EAAE,KAAa,EAAE,EAAE;QACjF,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,OAAY,EAAE,EAAE,CAAC;YACnE,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;YACvF,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;YACtF,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;SAC3F,CAAC,CAAC;QAEH,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,OAAO,CAAC,IAAI;YACnB,GAAG,EAAE,OAAO,CAAC,EAAE;YACf,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,IAAI,CAAC,CAAC;YACxC,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,IAAI,CAAC,CAAC;YAC9C,QAAQ,EAAE,EAAE;YACZ,QAAQ;YACR,YAAY,EAAE,CAAC;YACf,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,IAAI,CAAC,CAAC;YACjD,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM;QACpB,aAAa,EAAE,CAAC;QAChB,MAAM;KACP,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,OAA4B;IAE5B,4CAA4C;IAC5C,8CAA8C;IAC9C,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC5E,MAAM,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,OAAO,CACpC,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,EACpD,GAAG,OAAO,CAAC,EAAE,CAAC,SAAS,IAAI,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,EAChD,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,KAAK,EACb;QACE,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,eAAe,CAAC,WAAW;QACzD,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,WAAW,EAAE,eAAe;KAC7B,CACF,CAAC;IAEF,OAAO,2BAA2B,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC","sourcesContent":["import { DriveStrategy } from './types';\nimport type { DriveRouteOptions, DriveRouteResult, RouteResult, TransitRouteOptions } from './types';\nimport { parsePolyline } from './route-geometry';\n\nasync function loadWebApiFallback(feature: '公交路径规划' | '规避路线预览') {\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const webApi = require('expo-gaode-map-web-api');\n    if (typeof webApi?.GaodeWebAPI !== 'function') {\n      throw new Error('expo-gaode-map-web-api 未导出 GaodeWebAPI');\n    }\n    return webApi;\n  } catch {\n    throw new Error(\n      `${feature}依赖 expo-gaode-map-web-api。请安装该包，并在 ExpoGaodeMapModule.initSDK 中提供 webKey。`\n    );\n  }\n}\n\nfunction normalizeAvoidPolygons(polygons?: DriveRouteOptions['avoidPolygons']): string | undefined {\n  if (!polygons?.length) {\n    return undefined;\n  }\n\n  const normalized = polygons\n    .map((polygon) =>\n      polygon\n        .map((point) => `${point.longitude},${point.latitude}`)\n        .join(';')\n    )\n    .filter(Boolean)\n    .join('|');\n\n  return normalized || undefined;\n}\n\nfunction normalizeDrivingStrategy(\n  strategy?: DriveStrategy\n): number | undefined {\n  // 导航 SDK 与 Web API 的策略枚举不完全一致。\n  // 这里做“尽量等价”的映射，主要用于带规避参数时的路线预览。\n  switch (strategy) {\n    case DriveStrategy.FASTEST:\n      return 38;\n    case DriveStrategy.FEE_FIRST:\n      return 1;\n    case DriveStrategy.SHORTEST:\n      return 2;\n    case DriveStrategy.NO_EXPRESSWAYS:\n      return 37;\n    case DriveStrategy.AVOID_CONGESTION:\n      return 33;\n    case DriveStrategy.NO_HIGHWAY:\n      return 35;\n    case DriveStrategy.NO_HIGHWAY_AVOID_CONGESTION:\n      return 40;\n    case DriveStrategy.AVOID_COST_CONGESTION:\n    case DriveStrategy.AVOID_CONGESTION_COST:\n      return 41;\n    case DriveStrategy.NO_HIGHWAY_AVOID_COST_CONGESTION:\n      return 43;\n    default:\n      return undefined;\n  }\n}\n\nfunction normalizeDrivingRouteResult(\n  options: DriveRouteOptions,\n  result: any\n): DriveRouteResult {\n  // 把 Web API 的原始字段翻译成导航包已经对外稳定的 RouteResult 结构。\n  // 这样上层代码不需要知道 Web API 的字段名，也不用为 fallback 单独写分支。\n  const paths = result?.route?.paths ?? [];\n  const routes = paths.map((path: any, index: number) => {\n    const segments = (path?.steps ?? []).map((step: any) => ({\n      instruction: step?.instruction ?? '',\n      orientation: step?.orientation,\n      road: step?.road_name,\n      distance: Number(step?.step_distance ?? 0),\n      duration: Number(step?.cost?.duration ?? 0),\n      polyline: parsePolyline(step?.polyline),\n      assistantAction: step?.assistant_action,\n      tollDistance: step?.cost?.toll_distance ? Number(step.cost.toll_distance) : undefined,\n      tollCost: step?.cost?.tolls ? Number(step.cost.tolls) : undefined,\n    }));\n\n    const restrictionCode = path?.restriction != null ? Number(path.restriction) : undefined;\n\n    return {\n      id: index,\n      start: options.from,\n      end: options.to,\n      distance: Number(path?.distance ?? 0),\n      duration: Number(path?.cost?.duration ?? path?.duration ?? 0),\n      segments,\n      polyline: segments.flatMap((segment: { polyline: any[] }) => segment.polyline),\n      tollDistance: path?.cost?.toll_distance ? Number(path.cost.toll_distance) : undefined,\n      tollCost: path?.cost?.tolls ? Number(path.cost.tolls) : undefined,\n      trafficLightCount: path?.cost?.traffic_lights ? Number(path.cost.traffic_lights) : undefined,\n      restrictionCode,\n      restrictionInfo:\n        restrictionCode === 0\n          ? '限行已规避或未限行'\n          : restrictionCode === 1\n            ? '限行无法规避'\n            : undefined,\n      strategy: options.strategy,\n    };\n  });\n\n  return {\n    count: Number(result?.count ?? routes.length),\n    mainPathIndex: 0,\n    routeIds: routes.map((route: RouteResult) => route.id),\n    routes,\n    taxiCost: result?.route?.taxi_cost ? Number(result.route.taxi_cost) : undefined,\n  };\n}\n\nexport function shouldUseAvoidPreviewFallback(options: DriveRouteOptions): boolean {\n  // 只有出现“规避道路 / 规避区域”时才需要走 Web API 预览。\n  // 普通驾车算路仍然优先走原生能力。\n  return Boolean(options.avoidRoad?.trim() || options.avoidPolygons?.length);\n}\n\nexport async function calculateDriveRouteWithAvoidPreview(\n  options: DriveRouteOptions\n): Promise<DriveRouteResult> {\n  // Web API 只负责“预览规避后的路线”，不是替代原生导航 SDK。\n  // 失败时让调用方回退到原生实现，避免把可用路径规划直接变成报错。\n  const { GaodeWebAPI } = await loadWebApiFallback('规避路线预览');\n  const api = new GaodeWebAPI();\n  const result = await api.route.driving(\n    `${options.from.longitude},${options.from.latitude}`,\n    `${options.to.longitude},${options.to.latitude}`,\n    {\n      strategy: normalizeDrivingStrategy(options.strategy),\n      waypoints: options.waypoints?.map(\n        (point) => `${point.longitude},${point.latitude}`\n      ),\n      avoidpolygons: normalizeAvoidPolygons(options.avoidPolygons),\n      avoidroad: options.avoidRoad?.trim() || undefined,\n      plate: options.carNumber,\n      show_fields: 'cost,navi,polyline',\n    }\n  );\n\n  return normalizeDrivingRouteResult(options, result);\n}\n\nfunction normalizeTransitRouteResult(\n  options: TransitRouteOptions,\n  result: any\n): DriveRouteResult {\n  // 导航包内部仍保持独立实现；\n  // 这里只是在“公交无法由导航 SDK 直算”时，把 Web API 结果映射成现有 RouteResult 形状。\n  const routes = (result?.route?.transits ?? []).map((transit: any, index: number) => {\n    const polyline = (transit?.segments ?? []).flatMap((segment: any) => [\n      ...(segment.walking?.steps?.flatMap((step: any) => parsePolyline(step.polyline)) ?? []),\n      ...(segment.bus?.buslines?.flatMap((line: any) => parsePolyline(line.polyline)) ?? []),\n      ...(segment.railway?.buslines?.flatMap((line: any) => parsePolyline(line.polyline)) ?? []),\n    ]);\n\n    return {\n      id: index,\n      start: options.from,\n      end: options.to,\n      distance: Number(transit?.distance ?? 0),\n      duration: Number(transit?.cost?.duration ?? 0),\n      segments: [],\n      polyline,\n      tollDistance: 0,\n      tollCost: Number(transit?.cost?.transit_fee ?? 0),\n      strategy: options.strategy,\n    };\n  });\n\n  return {\n    count: routes.length,\n    mainPathIndex: 0,\n    routes,\n  };\n}\n\nexport async function calculateTransitRouteWithWebApi(\n  options: TransitRouteOptions\n): Promise<DriveRouteResult> {\n  // 公交换乘在当前 SDK 能力下统一回退到 Web API，再映射成同一份路线结构。\n  // 运行时按需加载，避免把 navigation 包和 web-api 包在构建期强绑定。\n  const { GaodeWebAPI, TransitStrategy } = await loadWebApiFallback('公交路径规划');\n  const api = new GaodeWebAPI();\n  const result = await api.route.transit(\n    `${options.from.longitude},${options.from.latitude}`,\n    `${options.to.longitude},${options.to.latitude}`,\n    options.city1,\n    options.city2,\n    {\n      strategy: options.strategy ?? TransitStrategy.RECOMMENDED,\n      AlternativeRoute: options.alternativeRoute,\n      show_fields: 'cost,polyline',\n    }\n  );\n\n  return normalizeTransitRouteResult(options, result);\n}\n"]}
+{"version":3,"file":"web-api-fallback.js","sourceRoot":"","sources":["../src/web-api-fallback.ts"],"names":[],"mappings":"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","sourcesContent":["import { DriveStrategy } from './types';\nimport type { DriveRouteOptions, DriveRouteResult, RouteResult, TransitRouteOptions } from './types';\nimport { parsePolyline } from './route-geometry';\n\nasync function loadWebApiFallback(feature: '公交路径规划' | '规避路线预览') {\n  try {\n    const webApi = require('expo-gaode-map-web-api');\n    if (typeof webApi?.GaodeWebAPI !== 'function') {\n      throw new Error('expo-gaode-map-web-api 未导出 GaodeWebAPI');\n    }\n    return webApi;\n  } catch {\n    throw new Error(\n      `${feature}依赖 expo-gaode-map-web-api。请安装该包，并在 ExpoGaodeMapModule.initSDK 中提供 webKey。`\n    );\n  }\n}\n\nfunction normalizeAvoidPolygons(polygons?: DriveRouteOptions['avoidPolygons']): string | undefined {\n  if (!polygons?.length) {\n    return undefined;\n  }\n\n  const normalized = polygons\n    .map((polygon) =>\n      polygon\n        .map((point) => `${point.longitude},${point.latitude}`)\n        .join(';')\n    )\n    .filter(Boolean)\n    .join('|');\n\n  return normalized || undefined;\n}\n\nfunction normalizeDrivingStrategy(\n  strategy?: DriveStrategy\n): number | undefined {\n  // 导航 SDK 与 Web API 的策略枚举不完全一致。\n  // 这里做“尽量等价”的映射，主要用于带规避参数时的路线预览。\n  switch (strategy) {\n    case DriveStrategy.FASTEST:\n      return 38;\n    case DriveStrategy.FEE_FIRST:\n      return 1;\n    case DriveStrategy.SHORTEST:\n      return 2;\n    case DriveStrategy.NO_EXPRESSWAYS:\n      return 37;\n    case DriveStrategy.AVOID_CONGESTION:\n      return 33;\n    case DriveStrategy.NO_HIGHWAY:\n      return 35;\n    case DriveStrategy.NO_HIGHWAY_AVOID_CONGESTION:\n      return 40;\n    case DriveStrategy.AVOID_COST_CONGESTION:\n    case DriveStrategy.AVOID_CONGESTION_COST:\n      return 41;\n    case DriveStrategy.NO_HIGHWAY_AVOID_COST_CONGESTION:\n      return 43;\n    default:\n      return undefined;\n  }\n}\n\nfunction normalizeDrivingRouteResult(\n  options: DriveRouteOptions,\n  result: any\n): DriveRouteResult {\n  // 把 Web API 的原始字段翻译成导航包已经对外稳定的 RouteResult 结构。\n  // 这样上层代码不需要知道 Web API 的字段名，也不用为 fallback 单独写分支。\n  const paths = result?.route?.paths ?? [];\n  const routes = paths.map((path: any, index: number) => {\n    const segments = (path?.steps ?? []).map((step: any) => ({\n      instruction: step?.instruction ?? '',\n      orientation: step?.orientation,\n      road: step?.road_name,\n      distance: Number(step?.step_distance ?? 0),\n      duration: Number(step?.cost?.duration ?? 0),\n      polyline: parsePolyline(step?.polyline),\n      assistantAction: step?.assistant_action,\n      tollDistance: step?.cost?.toll_distance ? Number(step.cost.toll_distance) : undefined,\n      tollCost: step?.cost?.tolls ? Number(step.cost.tolls) : undefined,\n    }));\n\n    const restrictionCode = path?.restriction != null ? Number(path.restriction) : undefined;\n\n    return {\n      id: index,\n      start: options.from,\n      end: options.to,\n      distance: Number(path?.distance ?? 0),\n      duration: Number(path?.cost?.duration ?? path?.duration ?? 0),\n      segments,\n      polyline: segments.flatMap((segment: { polyline: any[] }) => segment.polyline),\n      tollDistance: path?.cost?.toll_distance ? Number(path.cost.toll_distance) : undefined,\n      tollCost: path?.cost?.tolls ? Number(path.cost.tolls) : undefined,\n      trafficLightCount: path?.cost?.traffic_lights ? Number(path.cost.traffic_lights) : undefined,\n      restrictionCode,\n      restrictionInfo:\n        restrictionCode === 0\n          ? '限行已规避或未限行'\n          : restrictionCode === 1\n            ? '限行无法规避'\n            : undefined,\n      strategy: options.strategy,\n    };\n  });\n\n  return {\n    count: Number(result?.count ?? routes.length),\n    mainPathIndex: 0,\n    routeIds: routes.map((route: RouteResult) => route.id),\n    routes,\n    taxiCost: result?.route?.taxi_cost ? Number(result.route.taxi_cost) : undefined,\n  };\n}\n\nexport function shouldUseAvoidPreviewFallback(options: DriveRouteOptions): boolean {\n  // 只有出现“规避道路 / 规避区域”时才需要走 Web API 预览。\n  // 普通驾车算路仍然优先走原生能力。\n  return Boolean(options.avoidRoad?.trim() || options.avoidPolygons?.length);\n}\n\nexport async function calculateDriveRouteWithAvoidPreview(\n  options: DriveRouteOptions\n): Promise<DriveRouteResult> {\n  // Web API 只负责“预览规避后的路线”，不是替代原生导航 SDK。\n  // 失败时让调用方回退到原生实现，避免把可用路径规划直接变成报错。\n  const { GaodeWebAPI } = await loadWebApiFallback('规避路线预览');\n  const api = new GaodeWebAPI();\n  const result = await api.route.driving(\n    `${options.from.longitude},${options.from.latitude}`,\n    `${options.to.longitude},${options.to.latitude}`,\n    {\n      strategy: normalizeDrivingStrategy(options.strategy),\n      waypoints: options.waypoints?.map(\n        (point) => `${point.longitude},${point.latitude}`\n      ),\n      avoidpolygons: normalizeAvoidPolygons(options.avoidPolygons),\n      avoidroad: options.avoidRoad?.trim() || undefined,\n      plate: options.carNumber,\n      show_fields: 'cost,navi,polyline',\n    }\n  );\n\n  return normalizeDrivingRouteResult(options, result);\n}\n\nfunction normalizeTransitRouteResult(\n  options: TransitRouteOptions,\n  result: any\n): DriveRouteResult {\n  // 导航包内部仍保持独立实现；\n  // 这里只是在“公交无法由导航 SDK 直算”时，把 Web API 结果映射成现有 RouteResult 形状。\n  const routes = (result?.route?.transits ?? []).map((transit: any, index: number) => {\n    const polyline = (transit?.segments ?? []).flatMap((segment: any) => [\n      ...(segment.walking?.steps?.flatMap((step: any) => parsePolyline(step.polyline)) ?? []),\n      ...(segment.bus?.buslines?.flatMap((line: any) => parsePolyline(line.polyline)) ?? []),\n      ...(segment.railway?.buslines?.flatMap((line: any) => parsePolyline(line.polyline)) ?? []),\n    ]);\n\n    return {\n      id: index,\n      start: options.from,\n      end: options.to,\n      distance: Number(transit?.distance ?? 0),\n      duration: Number(transit?.cost?.duration ?? 0),\n      segments: [],\n      polyline,\n      tollDistance: 0,\n      tollCost: Number(transit?.cost?.transit_fee ?? 0),\n      strategy: options.strategy,\n    };\n  });\n\n  return {\n    count: routes.length,\n    mainPathIndex: 0,\n    routes,\n  };\n}\n\nexport async function calculateTransitRouteWithWebApi(\n  options: TransitRouteOptions\n): Promise<DriveRouteResult> {\n  // 公交换乘在当前 SDK 能力下统一回退到 Web API，再映射成同一份路线结构。\n  // 运行时按需加载，避免把 navigation 包和 web-api 包在构建期强绑定。\n  const { GaodeWebAPI, TransitStrategy } = await loadWebApiFallback('公交路径规划');\n  const api = new GaodeWebAPI();\n  const result = await api.route.transit(\n    `${options.from.longitude},${options.from.latitude}`,\n    `${options.to.longitude},${options.to.latitude}`,\n    options.city1,\n    options.city2,\n    {\n      strategy: options.strategy ?? TransitStrategy.RECOMMENDED,\n      AlternativeRoute: options.alternativeRoute,\n      show_fields: 'cost,polyline',\n    }\n  );\n\n  return normalizeTransitRouteResult(options, result);\n}\n"]}

package/ios/map/ExpoGaodeMapView.swift

@@ -96,6 +96,8 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate, UIGestureRecognizerDelegate
     private var uiManager: UIManager!
     /// 地图是否已加载完成
     private var isMapLoaded = false
+    /// 定位 annotation 首次出现后是否已补应用定位样式
+    private var hasAppliedUserLocationStyleAfterLocationUpdate = false
     /// 初始相机是否已应用（仅应用一次，避免与运行时相机控制冲突）
     private var hasAppliedInitialCameraPosition = false
     /// 是否正在处理 annotation 选择事件
@@ -481,6 +483,7 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate, UIGestureRecognizerDelegate
         uiManager.setRotateEnabled(isRotateEnabled)
         uiManager.setTiltEnabled(isTiltEnabled)
         uiManager.setShowsUserLocation(showsUserLocation, followUser: followUserLocation)
+        applyUserLocationStyle()
         mapView.distanceFilter = distanceFilter
         mapView.headingFilter = headingFilter
     }
@@ -511,6 +514,7 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate, UIGestureRecognizerDelegate
         uiManager.setRotateEnabled(isRotateEnabled)
         uiManager.setTiltEnabled(isTiltEnabled)
         uiManager.setShowsUserLocation(showsUserLocation, followUser: followUserLocation)
+        applyUserLocationStyle()
         uiManager.setShowsTraffic(showsTraffic)
         uiManager.setShowsBuildings(showsBuildings)
         uiManager.setShowsIndoorMap(showsIndoorMap)
@@ -683,6 +687,9 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate, UIGestureRecognizerDelegate
     func setFollowUserLocation(_ follow: Bool) {
         followUserLocation = follow
         uiManager?.setShowsUserLocation(showsUserLocation, followUser: follow)
+        if showsUserLocation {
+            applyUserLocationStyle()
+        }
     }
     
     func setShowsUserLocation(_ show: Bool) {
@@ -695,6 +702,7 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate, UIGestureRecognizerDelegate
     
     func setUserLocationRepresentation(_ config: [String: Any]) {
         userLocationRepresentation = config
+        hasAppliedUserLocationStyleAfterLocationUpdate = false
         if showsUserLocation {
             uiManager?.setUserLocationRepresentation(config)
         }
@@ -704,7 +712,7 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate, UIGestureRecognizerDelegate
      * 应用用户位置样式
      */
     private func applyUserLocationStyle() {
-        guard let config = userLocationRepresentation else { return }
+        guard showsUserLocation, let config = userLocationRepresentation else { return }
         uiManager?.setUserLocationRepresentation(config)
     }
     
@@ -974,6 +982,7 @@ class ExpoGaodeMapView: ExpoView, MAMapViewDelegate, UIGestureRecognizerDelegate
         super.addSubview(resolvedMapView)
         isMapLoaded = false
         hasAppliedInitialCameraPosition = false
+        hasAppliedUserLocationStyleAfterLocationUpdate = false
 
         cameraManager = CameraManager(mapView: resolvedMapView)
         uiManager = UIManager(mapView: resolvedMapView)
@@ -1042,9 +1051,37 @@ extension ExpoGaodeMapView {
         if let styleData = customMapStyleData {
             uiManager.setCustomMapStyle(styleData)
         }
+
+        applyUserLocationStyle()
         
         onLoad(["loaded": true])
     }
+
+    /**
+     * 定位更新回调
+     */
+    public func mapView(_ mapView: MAMapView, didUpdate userLocation: MAUserLocation, updatingLocation: Bool) {
+        guard updatingLocation, let location = userLocation.location else { return }
+
+        if !hasAppliedUserLocationStyleAfterLocationUpdate {
+            applyUserLocationStyle()
+            hasAppliedUserLocationStyleAfterLocationUpdate = true
+        }
+
+        let latitude = location.coordinate.latitude
+        let longitude = location.coordinate.longitude
+        guard latitude >= -90 && latitude <= 90,
+              longitude >= -180 && longitude <= 180 else {
+            return
+        }
+
+        onLocation([
+            "latitude": latitude,
+            "longitude": longitude,
+            "accuracy": location.horizontalAccuracy,
+            "timestamp": Date().timeIntervalSince1970 * 1000
+        ])
+    }
     
     /**
      * 地图区域即将改变时触发 - 应用节流优化
@@ -1367,13 +1404,118 @@ extension ExpoGaodeMapView {
         handleGaodePoiTouch(pois)
     }
     
+    private func getUserLocationAnnotationView(for mapView: MAMapView, annotation: MAAnnotation) -> MAAnnotationView? {
+        guard let config = userLocationRepresentation,
+              let imagePath = config["image"] as? String,
+              !imagePath.isEmpty else {
+            return nil
+        }
+
+        let reuseId = "ExpoGaodeMapUserLocationStyleReuseIdentifier"
+        let annotationView: MAAnnotationView
+        if let reusableView = mapView.dequeueReusableAnnotationView(withIdentifier: reuseId) {
+            annotationView = reusableView
+        } else {
+            annotationView = MAAnnotationView(annotation: annotation, reuseIdentifier: reuseId)
+        }
+        annotationView.annotation = annotation
+        annotationView.canShowCallout = false
+
+        let imageWidth = config["imageWidth"] as? Double
+        let imageHeight = config["imageHeight"] as? Double
+        let cacheKey = userLocationImageCacheKey(imagePath: imagePath, imageWidth: imageWidth, imageHeight: imageHeight)
+        annotationView.accessibilityIdentifier = cacheKey
+
+        if let cached = IconBitmapCache.shared.image(forKey: cacheKey) {
+            annotationView.image = cached
+            return annotationView
+        }
+
+        annotationView.image = nil
+        loadUserLocationImage(imagePath: imagePath, imageWidth: imageWidth, imageHeight: imageHeight, cacheKey: cacheKey) { [weak annotationView] image in
+            guard let annotationView = annotationView,
+                  annotationView.accessibilityIdentifier == cacheKey else {
+                return
+            }
+            annotationView.image = image
+        }
+
+        return annotationView
+    }
+
+    private func userLocationImageCacheKey(imagePath: String, imageWidth: Double?, imageHeight: Double?) -> String {
+        let widthPart = imageWidth.map { String(Int($0.rounded())) } ?? "auto"
+        let heightPart = imageHeight.map { String(Int($0.rounded())) } ?? "auto"
+        return "userLocation|\(imagePath)|\(widthPart)x\(heightPart)"
+    }
+
+    private func loadUserLocationImage(
+        imagePath: String,
+        imageWidth: Double?,
+        imageHeight: Double?,
+        cacheKey: String,
+        completion: @escaping (UIImage?) -> Void
+    ) {
+        let finish: (UIImage?) -> Void = { image in
+            if let image = image {
+                IconBitmapCache.shared.setImage(image, forKey: cacheKey)
+            }
+            DispatchQueue.main.async {
+                completion(image)
+            }
+        }
+
+        if imagePath.hasPrefix("http://") || imagePath.hasPrefix("https://") {
+            DispatchQueue.global(qos: .userInitiated).async { [weak self] in
+                guard let self = self,
+                      let url = URL(string: imagePath),
+                      let data = try? Data(contentsOf: url),
+                      let image = UIImage(data: data) else {
+                    finish(nil)
+                    return
+                }
+                finish(self.resizeUserLocationImage(image, imageWidth: imageWidth, imageHeight: imageHeight))
+            }
+            return
+        }
+
+        let image: UIImage?
+        if imagePath.hasPrefix("file://") {
+            let path = String(imagePath.dropFirst(7))
+            image = UIImage(contentsOfFile: path)
+        } else {
+            image = UIImage(named: imagePath)
+        }
+
+        guard let image = image else {
+            finish(nil)
+            return
+        }
+        finish(resizeUserLocationImage(image, imageWidth: imageWidth, imageHeight: imageHeight))
+    }
+
+    private func resizeUserLocationImage(_ image: UIImage, imageWidth: Double?, imageHeight: Double?) -> UIImage {
+        guard let imageWidth = imageWidth,
+              let imageHeight = imageHeight,
+              imageWidth > 0,
+              imageHeight > 0 else {
+            return image
+        }
+
+        let targetSize = CGSize(width: imageWidth, height: imageHeight)
+        let renderer = UIGraphicsImageRenderer(size: targetSize)
+        return renderer.image { _ in
+            image.draw(in: CGRect(origin: .zero, size: targetSize))
+        }
+    }
+
     /**
      * 创建标注视图
-     * 定位蓝点返回 nil 使用系统默认样式
+     * 定位蓝点默认返回 nil 使用系统样式；传入 image 时按官方建议自定义定位 annotationView。
      */
     public func mapView(_ mapView: MAMapView, viewFor annotation: MAAnnotation) -> MAAnnotationView? {
         if annotation.isKind(of: MAUserLocation.self) {
-            return nil
+            return getUserLocationAnnotationView(for: mapView, annotation: annotation)
         }
         
         // 🔑 支持 MAAnimatedAnnotation（平滑移动）

package/ios/map/cpp/ClusterEngine.cpp

@@ -1,4 +1,5 @@
 #include "ClusterEngine.hpp"
+#include "GeometryEngine.hpp"
 #include "QuadTree.hpp"
 #include <cmath>
 #include <algorithm>
@@ -11,19 +12,8 @@ static inline double cluster_toRadians(double degrees) {
     return degrees * 0.017453292519943295;
 }
 
-static double haversineMeters(const ClusterPoint& a, const ClusterPoint& b) {
-    const double lat1 = cluster_toRadians(a.lat);
-    const double lat2 = cluster_toRadians(b.lat);
-    const double dLat = lat2 - lat1;
-    const double dLon = cluster_toRadians(b.lon - a.lon);
-
-    const double sinHalfLat = std::sin(dLat * 0.5);
-    const double sinHalfLon = std::sin(dLon * 0.5);
-
-    const double h = sinHalfLat * sinHalfLat + std::cos(lat1) * std::cos(lat2) * sinHalfLon * sinHalfLon;
-    const double c = 2.0 * std::atan2(std::sqrt(h), std::sqrt(1.0 - h));
-
-    return 6371000.0 * c;
+static double clusterDistanceMeters(const ClusterPoint& a, const ClusterPoint& b) {
+    return calculateDistance(a.lat, a.lon, b.lat, b.lon);
 }
 
 std::vector<ClusterOutput> clusterPoints(const std::vector<ClusterPoint>& points, double radiusMeters) {
@@ -95,7 +85,7 @@ std::vector<ClusterOutput> clusterPoints(const std::vector<ClusterPoint>& points
             if (globalVisited[neighbor.index]) continue;
             
             // Precise check
-            if (haversineMeters(p, neighbor) <= radiusMeters) {
+            if (clusterDistanceMeters(p, neighbor) <= radiusMeters) {
                 cluster.indices.push_back(neighbor.index);
                 globalVisited[neighbor.index] = true;
             }

package/ios/map/cpp/ClusterEngine.hpp

@@ -1,20 +1,9 @@
 #pragma once
 
-#include <vector>
+#include "ClusterTypes.hpp"
 
 namespace gaodemap {
 
-struct ClusterPoint {
-    double lat;
-    double lon;
-    int index;
-};
-
-struct ClusterOutput {
-    int centerIndex;
-    std::vector<int> indices;
-};
-
 std::vector<ClusterOutput> clusterPoints(const std::vector<ClusterPoint>& points, double radiusMeters);
 
 }

package/ios/map/cpp/ClusterTypes.hpp

@@ -0,0 +1,18 @@
+#pragma once
+
+#include <vector>
+
+namespace gaodemap {
+
+struct ClusterPoint {
+    double lat;
+    double lon;
+    int index;
+};
+
+struct ClusterOutput {
+    int centerIndex;
+    std::vector<int> indices;
+};
+
+}

package/ios/map/cpp/ColorParser.cpp

@@ -1,5 +1,6 @@
 #include "ColorParser.hpp"
 #include <algorithm>
+#include <cctype>
 #include <sstream>
 #include <vector>
 #include <map>
@@ -109,13 +110,29 @@ static const std::map<std::string, uint32_t> NAMED_COLORS = {
     {"transparent", 0x00000000}
 };
 
+static bool isSpace(unsigned char ch) {
+    return std::isspace(ch) != 0;
+}
+
+static char toLower(unsigned char ch) {
+    return static_cast<char>(std::tolower(ch));
+}
+
+static bool isHexDigit(unsigned char ch) {
+    return std::isxdigit(ch) != 0;
+}
+
 uint32_t parseColor(const std::string& colorString) {
     std::string str = colorString;
     // Remove whitespace
-    str.erase(std::remove_if(str.begin(), str.end(), ::isspace), str.end());
+    str.erase(std::remove_if(str.begin(), str.end(), [](unsigned char ch) {
+        return isSpace(ch);
+    }), str.end());
     // Lowercase for named colors check
     std::string lowerStr = str;
-    std::transform(lowerStr.begin(), lowerStr.end(), lowerStr.begin(), ::tolower);
+    std::transform(lowerStr.begin(), lowerStr.end(), lowerStr.begin(), [](unsigned char ch) {
+        return toLower(ch);
+    });
 
     if (NAMED_COLORS.count(lowerStr)) {
         return NAMED_COLORS.at(lowerStr);
@@ -125,7 +142,9 @@ uint32_t parseColor(const std::string& colorString) {
         return parseRgba(str); // pass original str with potential spaces if needed, but we removed them
     }
 
-    if (lowerStr.find("#") == 0 || std::all_of(lowerStr.begin(), lowerStr.end(), ::isxdigit)) {
+    if (lowerStr.find("#") == 0 || std::all_of(lowerStr.begin(), lowerStr.end(), [](unsigned char ch) {
+        return isHexDigit(ch);
+    })) {
         return parseHex(str);
     }
 

package/ios/map/cpp/GeometryEngine.cpp

@@ -44,7 +44,7 @@ static inline double mercatorY01(double lat) {
     return y;
 }
 
-static double wrappedSpan01(std::vector<double> xs) {
+static double wrappedSpan01(std::vector<double>& xs) {
     if (xs.size() <= 1) {
         return 0.0;
     }

package/ios/map/cpp/QuadTree.hpp

@@ -2,7 +2,7 @@
 
 #include <vector>
 #include <memory>
-#include "ClusterEngine.hpp"
+#include "ClusterTypes.hpp"
 
 namespace gaodemap {
 

package/ios/map/managers/UIManager.swift

@@ -172,6 +172,9 @@ class UIManager: NSObject, MAMapViewDelegate {
         // 是否显示方向指示
         if let showsHeadingIndicator = config["showsHeadingIndicator"] as? Bool {
             representation.showsHeadingIndicator = showsHeadingIndicator
+            if showsHeadingIndicator {
+                mapView.userTrackingMode = .followWithHeading
+            }
         }
         
         // 精度圈填充颜色

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "expo-gaode-map-navigation",
-  "version": "2.0.17",
-  "description": "React Native AMap (Gaode Map) navigation module for Expo: route planning and turn-by-turn navigation, includes full map features.",
+  "version": "2.0.19",
+  "description": "Expo Modules AMap (Gaode Map) navigation for Expo/React Native: Config Plugin, route planning, turn-by-turn navigation, map features, and react-native-amap3d migration guidance.",
   "author": "TomWq <582752848@qq.com> (https://github.com/TomWq)",
   "repository": {
     "type": "git",
@@ -14,7 +14,7 @@
     "build": "expo-module build && yarn build:plugin",
     "build:plugin": "tsc --project plugin/tsconfig.json",
     "clean": "expo-module clean",
-    "lint": "expo-module lint",
+    "lint": "eslint \"src/**/*.{ts,tsx}\"",
     "test": "npx jest --no-watchman --config jest.config.js --runInBand",
     "prepare": "expo-module prepare && yarn build:plugin",
     "postinstall": "node scripts/check-expo-modules.js",
@@ -25,11 +25,14 @@
   },
   "devDependencies": {
     "@expo/vector-icons": "^15.0.3",
-    "@types/react": "~19.1.0",
-    "expo": "^55.0.8",
-    "expo-module-scripts": "^55.0.2",
-    "react-native": "0.83.2",
-    "typescript": "^5.9.3"
+    "@types/node": "^22.18.0",
+    "@types/react": "~19.2.10",
+    "eslint": "^9.25.1",
+    "expo": "^57.0.1",
+    "expo-font": "~57.0.0",
+    "expo-module-scripts": "^56.0.3",
+    "react-native": "0.86.0",
+    "typescript": "^6.0.3"
   },
   "peerDependencies": {
     "@expo/vector-icons": "*",
@@ -65,8 +68,13 @@
     "expo-gaode-map-navigation",
     "expo-amap",
     "react-native-amap",
+    "react-native-amap3d",
+    "react-native-amap3d-alternative",
     "react-native-gaode-map",
     "rn-amap-navigation",
+    "expo-gaode",
+    "eas-build",
+    "fabric",
     "amap",
     "gaode-map",
     "navigation",

package/plugin/build/withGaodeMap.js

@@ -155,12 +155,13 @@ const withGaodeMapAndroidManifest = (config, props) => {
             if (!mainApplication['activity']) {
                 mainApplication['activity'] = [];
             }
+            const activities = mainApplication['activity'];
             const naviActivityName = 'com.amap.api.navi.AmapRouteActivity';
             const naviConfigChanges = 'orientation|keyboardHidden|screenSize|navigation';
             const naviTheme = '@android:style/Theme.NoTitleBar';
-            const activityIndex = mainApplication['activity'].findIndex((item) => item.$?.['android:name'] === naviActivityName);
+            const activityIndex = activities.findIndex((item) => item.$?.['android:name'] === naviActivityName);
             if (activityIndex === -1) {
-                mainApplication['activity'].push({
+                activities.push({
                     $: {
                         'android:name': naviActivityName,
                         'android:theme': naviTheme,
@@ -169,13 +170,15 @@ const withGaodeMapAndroidManifest = (config, props) => {
                 });
             }
             else {
-                const existing = mainApplication['activity'][activityIndex];
-                existing.$ = {
-                    ...(existing.$ || {}),
-                    'android:name': naviActivityName,
-                    'android:theme': existing.$?.['android:theme'] || naviTheme,
-                    'android:configChanges': existing.$?.['android:configChanges'] || naviConfigChanges,
-                };
+                const existing = activities[activityIndex];
+                if (existing) {
+                    existing.$ = {
+                        ...(existing.$ || {}),
+                        'android:name': naviActivityName,
+                        'android:theme': existing.$?.['android:theme'] || naviTheme,
+                        'android:configChanges': existing.$?.['android:configChanges'] || naviConfigChanges,
+                    };
+                }
             }
         }
         // 添加 API Key 到 application 标签
@@ -183,10 +186,11 @@ const withGaodeMapAndroidManifest = (config, props) => {
             if (!mainApplication['meta-data']) {
                 mainApplication['meta-data'] = [];
             }
+            const metaData = mainApplication['meta-data'];
             // 检查是否已存在
-            const hasApiKey = mainApplication['meta-data'].some((item) => item.$?.['android:name'] === 'com.amap.api.v2.apikey');
+            const hasApiKey = metaData.some((item) => item.$?.['android:name'] === 'com.amap.api.v2.apikey');
             if (!hasApiKey) {
-                mainApplication['meta-data'].push({
+                metaData.push({
                     $: {
                         'android:name': 'com.amap.api.v2.apikey',
                         'android:value': props.androidKey,
@@ -195,9 +199,10 @@ const withGaodeMapAndroidManifest = (config, props) => {
             }
             else {
                 // 更新现有的 API Key
-                const apiKeyIndex = mainApplication['meta-data'].findIndex((item) => item.$?.['android:name'] === 'com.amap.api.v2.apikey');
-                if (apiKeyIndex !== -1) {
-                    mainApplication['meta-data'][apiKeyIndex].$ = {
+                const apiKeyIndex = metaData.findIndex((item) => item.$?.['android:name'] === 'com.amap.api.v2.apikey');
+                const apiKeyMetaData = metaData[apiKeyIndex];
+                if (apiKeyMetaData) {
+                    apiKeyMetaData.$ = {
                         'android:name': 'com.amap.api.v2.apikey',
                         'android:value': props.androidKey,
                     };

package/shared/cpp/ClusterEngine.cpp

@@ -1,4 +1,5 @@
 #include "ClusterEngine.hpp"
+#include "GeometryEngine.hpp"
 #include "QuadTree.hpp"
 #include <cmath>
 #include <algorithm>
@@ -11,19 +12,8 @@ static inline double cluster_toRadians(double degrees) {
     return degrees * 0.017453292519943295;
 }
 
-static double haversineMeters(const ClusterPoint& a, const ClusterPoint& b) {
-    const double lat1 = cluster_toRadians(a.lat);
-    const double lat2 = cluster_toRadians(b.lat);
-    const double dLat = lat2 - lat1;
-    const double dLon = cluster_toRadians(b.lon - a.lon);
-
-    const double sinHalfLat = std::sin(dLat * 0.5);
-    const double sinHalfLon = std::sin(dLon * 0.5);
-
-    const double h = sinHalfLat * sinHalfLat + std::cos(lat1) * std::cos(lat2) * sinHalfLon * sinHalfLon;
-    const double c = 2.0 * std::atan2(std::sqrt(h), std::sqrt(1.0 - h));
-
-    return 6371000.0 * c;
+static double clusterDistanceMeters(const ClusterPoint& a, const ClusterPoint& b) {
+    return calculateDistance(a.lat, a.lon, b.lat, b.lon);
 }
 
 std::vector<ClusterOutput> clusterPoints(const std::vector<ClusterPoint>& points, double radiusMeters) {
@@ -95,7 +85,7 @@ std::vector<ClusterOutput> clusterPoints(const std::vector<ClusterPoint>& points
             if (globalVisited[neighbor.index]) continue;
             
             // Precise check
-            if (haversineMeters(p, neighbor) <= radiusMeters) {
+            if (clusterDistanceMeters(p, neighbor) <= radiusMeters) {
                 cluster.indices.push_back(neighbor.index);
                 globalVisited[neighbor.index] = true;
             }

package/shared/cpp/ClusterEngine.hpp

@@ -1,20 +1,9 @@
 #pragma once
 
-#include <vector>
+#include "ClusterTypes.hpp"
 
 namespace gaodemap {
 
-struct ClusterPoint {
-    double lat;
-    double lon;
-    int index;
-};
-
-struct ClusterOutput {
-    int centerIndex;
-    std::vector<int> indices;
-};
-
 std::vector<ClusterOutput> clusterPoints(const std::vector<ClusterPoint>& points, double radiusMeters);
 
 }

package/shared/cpp/ClusterTypes.hpp

@@ -0,0 +1,18 @@
+#pragma once
+
+#include <vector>
+
+namespace gaodemap {
+
+struct ClusterPoint {
+    double lat;
+    double lon;
+    int index;
+};
+
+struct ClusterOutput {
+    int centerIndex;
+    std::vector<int> indices;
+};
+
+}