expo-gaode-map-navigation 2.0.13 → 2.0.14

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

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

package/build/web-route-following.d.ts

@@ -0,0 +1,3 @@
+import type { FollowWebPlannedRouteOptions, FollowWebPlannedRouteResult } from './types';
+export declare function followWebPlannedRoute(options: FollowWebPlannedRouteOptions): Promise<FollowWebPlannedRouteResult>;
+//# sourceMappingURL=web-route-following.d.ts.map

package/build/web-route-following.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-route-following.d.ts","sourceRoot":"","sources":["../src/web-route-following.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,4BAA4B,EAC5B,2BAA2B,EAI5B,MAAM,SAAS,CAAC;AAuJjB,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,2BAA2B,CAAC,CA8HtC"}

package/build/web-route-following.js

@@ -0,0 +1,178 @@
+import ExpoGaodeMapNavigationModule from './ExpoGaodeMapNavigationModule';
+import { buildAnchorWaypointsFromWebRoute, calculatePathLengthSafe, dedupeAdjacentPoints, getDistanceToPathSafe, normalizeWebRoutePolyline, samplePolyline } from './route-geometry';
+function extractRoutePolyline(route) {
+    if (Array.isArray(route.polyline) && route.polyline.length > 0) {
+        return route.polyline;
+    }
+    const segments = Array.isArray(route.segments) ? route.segments : [];
+    if (segments.length > 0) {
+        return dedupeAdjacentPoints(segments.flatMap((segment) => segment.polyline ?? []));
+    }
+    const steps = Array.isArray(route.steps) ? route.steps : [];
+    if (steps.length > 0) {
+        return dedupeAdjacentPoints(steps.flatMap((step) => step.polyline ?? []));
+    }
+    return [];
+}
+function resolveIndependentRouteId(result, route, routeIndex) {
+    if (typeof route.id === 'number') {
+        return route.id;
+    }
+    if (typeof route.routeId === 'number') {
+        return route.routeId;
+    }
+    return result.routeIds?.[routeIndex];
+}
+function scoreIndependentRouteAgainstWebPolyline(result, route, routeIndex, webPolyline, anchorWaypoints, thresholdMeters) {
+    // 评分思路很简单：看原生独立路线与 Web 折线有多接近，
+    // 再把平均偏差、最大偏差、漏掉的锚点一起折成一个排序分数。
+    const nativePolyline = extractRoutePolyline(route);
+    if (nativePolyline.length === 0 || webPolyline.length === 0) {
+        return null;
+    }
+    const sampledNativePoints = samplePolyline(nativePolyline);
+    const pointDistances = sampledNativePoints.map((point) => getDistanceToPathSafe(webPolyline, point));
+    const averageDeviationMeters = pointDistances.reduce((total, distance) => total + distance, 0) / pointDistances.length;
+    const maxDeviationMeters = Math.max(...pointDistances);
+    const missedAnchorCount = anchorWaypoints.reduce((count, point) => (getDistanceToPathSafe(nativePolyline, point) > thresholdMeters ? count + 1 : count), 0);
+    return {
+        routeId: resolveIndependentRouteId(result, route, routeIndex),
+        routeIndex,
+        averageDeviationMeters,
+        maxDeviationMeters,
+        missedAnchorCount,
+        score: averageDeviationMeters +
+            maxDeviationMeters * 0.35 +
+            missedAnchorCount * thresholdMeters * 0.5,
+    };
+}
+function evaluateIndependentResultAgainstWebRoute(independentResult, webPolyline, anchorWaypoints, maxDeviationMeters) {
+    // 先给每条原生候选路线打分，再把最接近的一条拿出来判断是 matched / approximate / preview_only。
+    const candidateMatches = independentResult.routes
+        .map((route, routeIndex) => scoreIndependentRouteAgainstWebPolyline(independentResult, route, routeIndex, webPolyline, anchorWaypoints, maxDeviationMeters))
+        .filter((candidate) => candidate !== null)
+        .sort((routeA, routeB) => routeA.score - routeB.score);
+    const bestMatch = candidateMatches[0];
+    const selectedRoute = bestMatch
+        ? independentResult.routes[bestMatch.routeIndex]
+        : undefined;
+    const nativePolyline = selectedRoute ? extractRoutePolyline(selectedRoute) : [];
+    let mode = 'preview_only';
+    let reason = '未找到足够接近 Web 规划线的原生路线';
+    if (bestMatch) {
+        if (bestMatch.averageDeviationMeters <= maxDeviationMeters / 2 &&
+            bestMatch.maxDeviationMeters <= maxDeviationMeters &&
+            bestMatch.missedAnchorCount === 0) {
+            mode = 'matched';
+            reason = '原生路线与 Web 规划线高度接近，可直接按近似结果导航';
+        }
+        else if (bestMatch.averageDeviationMeters <= maxDeviationMeters &&
+            bestMatch.maxDeviationMeters <= maxDeviationMeters * 2) {
+            mode = 'approximate';
+            reason = '原生路线与 Web 规划线接近，但仍存在可见偏差';
+        }
+    }
+    return {
+        candidateMatches,
+        bestMatch,
+        selectedRoute,
+        nativePolyline,
+        mode,
+        reason,
+    };
+}
+async function runIndependentDriveRoute(options) {
+    return ExpoGaodeMapNavigationModule.independentDriveRoute(options);
+}
+export async function followWebPlannedRoute(options) {
+    const { from, to, webRoute, strategy, carNumber, restriction, maxDeviationMeters = 120, startNavigation = false, naviType = 0, } = options;
+    const webPolyline = normalizeWebRoutePolyline(webRoute);
+    if (webPolyline.length < 2) {
+        throw new Error('webRoute.polyline 至少需要 2 个点');
+    }
+    // 第一步：从 Web 线路提取少量锚点，让原生独立算路先尽量往这条线靠。
+    const anchorWaypoints = buildAnchorWaypointsFromWebRoute(options);
+    const anchoredIndependentResult = await runIndependentDriveRoute({
+        from,
+        to,
+        strategy,
+        carNumber,
+        restriction,
+        waypoints: anchorWaypoints,
+    });
+    let independentResult = anchoredIndependentResult;
+    let evaluation = evaluateIndependentResultAgainstWebRoute(anchoredIndependentResult, webPolyline, anchorWaypoints, maxDeviationMeters);
+    let navigationUsesAnchorWaypoints = anchorWaypoints.length > 0;
+    // 如果锚点路线已经足够接近，再尝试去掉锚点重算一次。
+    // 这样可以避免“为了贴线而被锚点拖偏”的情况。
+    if (evaluation.bestMatch && evaluation.mode !== 'preview_only' && anchorWaypoints.length > 0) {
+        try {
+            const directIndependentResult = await runIndependentDriveRoute({
+                from,
+                to,
+                strategy,
+                carNumber,
+                restriction,
+            });
+            const directEvaluation = evaluateIndependentResultAgainstWebRoute(directIndependentResult, webPolyline, [], maxDeviationMeters);
+            const anchoredBest = evaluation.bestMatch;
+            const directBest = directEvaluation.bestMatch;
+            const canSwitchToDirectNavigation = Boolean(directBest) &&
+                directEvaluation.mode !== 'preview_only' &&
+                directBest.averageDeviationMeters <= Math.max(anchoredBest.averageDeviationMeters + 45, anchoredBest.averageDeviationMeters * 1.45) &&
+                directBest.maxDeviationMeters <= Math.max(anchoredBest.maxDeviationMeters + 90, anchoredBest.maxDeviationMeters * 1.45);
+            if (canSwitchToDirectNavigation) {
+                // 直连结果更自然，就切到直连结果，并清掉刚才的锚点算路缓存。
+                ExpoGaodeMapNavigationModule.clearIndependentRoute({
+                    token: anchoredIndependentResult.token,
+                }).catch(() => { });
+                independentResult = directIndependentResult;
+                evaluation = directEvaluation;
+                navigationUsesAnchorWaypoints = false;
+                evaluation.reason =
+                    directEvaluation.mode === 'matched'
+                        ? '已切换为无途经点导航结果，且与 Web 规划线高度接近'
+                        : '已切换为无途经点导航结果，但与 Web 规划线仍存在轻微偏差';
+            }
+            else {
+                // 直连结果不如锚点方案，就保留锚点方案作为最终导航依据。
+                ExpoGaodeMapNavigationModule.clearIndependentRoute({
+                    token: directIndependentResult.token,
+                }).catch(() => { });
+                evaluation.reason = `${evaluation.reason}；最终导航仍需依赖锚点途经点逼近 Web 线路`;
+            }
+        }
+        catch {
+            evaluation.reason = `${evaluation.reason}；无途经点重算失败，最终导航仍需依赖锚点途经点`;
+        }
+    }
+    let navigationStarted = false;
+    if (startNavigation && evaluation.bestMatch && evaluation.mode !== 'preview_only') {
+        // 只有当评估结果足够接近时才真正启动导航，避免把偏差过大的结果直接交给导航 SDK。
+        navigationStarted = await ExpoGaodeMapNavigationModule.startNaviWithIndependentPath({
+            token: independentResult.token,
+            naviType,
+            routeId: evaluation.bestMatch.routeId,
+            routeIndex: evaluation.bestMatch.routeId == null ? evaluation.bestMatch.routeIndex : undefined,
+        });
+    }
+    return {
+        mode: evaluation.mode,
+        token: independentResult.token,
+        anchorWaypoints,
+        webDistance: calculatePathLengthSafe(webPolyline),
+        nativeDistance: evaluation.nativePolyline.length > 1
+            ? calculatePathLengthSafe(evaluation.nativePolyline)
+            : undefined,
+        selectedRouteId: evaluation.bestMatch?.routeId,
+        selectedRouteIndex: evaluation.bestMatch?.routeIndex,
+        averageDeviationMeters: evaluation.bestMatch?.averageDeviationMeters,
+        maxDeviationMeters: evaluation.bestMatch?.maxDeviationMeters,
+        navigationStarted,
+        navigationUsesAnchorWaypoints,
+        independentResult,
+        candidateMatches: evaluation.candidateMatches,
+        reason: evaluation.reason,
+    };
+}
+//# sourceMappingURL=web-route-following.js.map

package/build/web-route-following.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-route-following.js","sourceRoot":"","sources":["../src/web-route-following.ts"],"names":[],"mappings":"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","sourcesContent":["import ExpoGaodeMapNavigationModule from './ExpoGaodeMapNavigationModule';\nimport { buildAnchorWaypointsFromWebRoute, calculatePathLengthSafe, dedupeAdjacentPoints, getDistanceToPathSafe, normalizeWebRoutePolyline, samplePolyline } from './route-geometry';\nimport type {\n  FollowWebPlannedRouteCandidate,\n  FollowWebPlannedRouteOptions,\n  FollowWebPlannedRouteResult,\n  IndependentRouteResult,\n  NaviPoint,\n  RouteResult,\n} from './types';\n\ntype RouteLike = RouteResult & {\n  routeId?: number;\n  steps?: Array<{ polyline?: NaviPoint[] }>;\n};\n\nfunction extractRoutePolyline(route: RouteLike): NaviPoint[] {\n  if (Array.isArray(route.polyline) && route.polyline.length > 0) {\n    return route.polyline;\n  }\n\n  const segments = Array.isArray(route.segments) ? route.segments : [];\n  if (segments.length > 0) {\n    return dedupeAdjacentPoints(\n      segments.flatMap((segment) => segment.polyline ?? [])\n    );\n  }\n\n  const steps = Array.isArray(route.steps) ? route.steps : [];\n  if (steps.length > 0) {\n    return dedupeAdjacentPoints(\n      steps.flatMap((step) => step.polyline ?? [])\n    );\n  }\n\n  return [];\n}\n\nfunction resolveIndependentRouteId(\n  result: IndependentRouteResult,\n  route: RouteLike,\n  routeIndex: number\n): number | undefined {\n  if (typeof route.id === 'number') {\n    return route.id;\n  }\n  if (typeof route.routeId === 'number') {\n    return route.routeId;\n  }\n  return result.routeIds?.[routeIndex];\n}\n\nfunction scoreIndependentRouteAgainstWebPolyline(\n  result: IndependentRouteResult,\n  route: RouteLike,\n  routeIndex: number,\n  webPolyline: NaviPoint[],\n  anchorWaypoints: NaviPoint[],\n  thresholdMeters: number\n): FollowWebPlannedRouteCandidate | null {\n  // 评分思路很简单：看原生独立路线与 Web 折线有多接近，\n  // 再把平均偏差、最大偏差、漏掉的锚点一起折成一个排序分数。\n  const nativePolyline = extractRoutePolyline(route);\n  if (nativePolyline.length === 0 || webPolyline.length === 0) {\n    return null;\n  }\n\n  const sampledNativePoints = samplePolyline(nativePolyline);\n  const pointDistances = sampledNativePoints.map((point) =>\n    getDistanceToPathSafe(webPolyline, point)\n  );\n  const averageDeviationMeters =\n    pointDistances.reduce((total, distance) => total + distance, 0) / pointDistances.length;\n  const maxDeviationMeters = Math.max(...pointDistances);\n\n  const missedAnchorCount = anchorWaypoints.reduce((count, point) => (\n    getDistanceToPathSafe(nativePolyline, point) > thresholdMeters ? count + 1 : count\n  ), 0);\n\n  return {\n    routeId: resolveIndependentRouteId(result, route, routeIndex),\n    routeIndex,\n    averageDeviationMeters,\n    maxDeviationMeters,\n    missedAnchorCount,\n    score:\n      averageDeviationMeters +\n      maxDeviationMeters * 0.35 +\n      missedAnchorCount * thresholdMeters * 0.5,\n  };\n}\n\nfunction evaluateIndependentResultAgainstWebRoute(\n  independentResult: IndependentRouteResult,\n  webPolyline: NaviPoint[],\n  anchorWaypoints: NaviPoint[],\n  maxDeviationMeters: number\n) {\n  // 先给每条原生候选路线打分，再把最接近的一条拿出来判断是 matched / approximate / preview_only。\n  const candidateMatches = independentResult.routes\n    .map((route, routeIndex) =>\n      scoreIndependentRouteAgainstWebPolyline(\n        independentResult,\n        route as RouteLike,\n        routeIndex,\n        webPolyline,\n        anchorWaypoints,\n        maxDeviationMeters\n      )\n    )\n    .filter((candidate): candidate is FollowWebPlannedRouteCandidate => candidate !== null)\n    .sort((routeA, routeB) => routeA.score - routeB.score);\n\n  const bestMatch = candidateMatches[0];\n  const selectedRoute = bestMatch\n    ? independentResult.routes[bestMatch.routeIndex] as RouteLike\n    : undefined;\n  const nativePolyline = selectedRoute ? extractRoutePolyline(selectedRoute) : [];\n\n  let mode: FollowWebPlannedRouteResult['mode'] = 'preview_only';\n  let reason = '未找到足够接近 Web 规划线的原生路线';\n\n  if (bestMatch) {\n    if (\n      bestMatch.averageDeviationMeters <= maxDeviationMeters / 2 &&\n      bestMatch.maxDeviationMeters <= maxDeviationMeters &&\n      bestMatch.missedAnchorCount === 0\n    ) {\n      mode = 'matched';\n      reason = '原生路线与 Web 规划线高度接近，可直接按近似结果导航';\n    } else if (\n      bestMatch.averageDeviationMeters <= maxDeviationMeters &&\n      bestMatch.maxDeviationMeters <= maxDeviationMeters * 2\n    ) {\n      mode = 'approximate';\n      reason = '原生路线与 Web 规划线接近，但仍存在可见偏差';\n    }\n  }\n\n  return {\n    candidateMatches,\n    bestMatch,\n    selectedRoute,\n    nativePolyline,\n    mode,\n    reason,\n  };\n}\n\nasync function runIndependentDriveRoute(options: {\n  from: FollowWebPlannedRouteOptions['from'];\n  to: FollowWebPlannedRouteOptions['to'];\n  strategy?: FollowWebPlannedRouteOptions['strategy'];\n  carNumber?: FollowWebPlannedRouteOptions['carNumber'];\n  restriction?: FollowWebPlannedRouteOptions['restriction'];\n  waypoints?: NaviPoint[];\n}): Promise<IndependentRouteResult> {\n  return ExpoGaodeMapNavigationModule.independentDriveRoute(options);\n}\n\nexport async function followWebPlannedRoute(\n  options: FollowWebPlannedRouteOptions\n): Promise<FollowWebPlannedRouteResult> {\n  const {\n    from,\n    to,\n    webRoute,\n    strategy,\n    carNumber,\n    restriction,\n    maxDeviationMeters = 120,\n    startNavigation = false,\n    naviType = 0,\n  } = options;\n\n  const webPolyline = normalizeWebRoutePolyline(webRoute);\n  if (webPolyline.length < 2) {\n    throw new Error('webRoute.polyline 至少需要 2 个点');\n  }\n\n  // 第一步：从 Web 线路提取少量锚点，让原生独立算路先尽量往这条线靠。\n  const anchorWaypoints = buildAnchorWaypointsFromWebRoute(options);\n  const anchoredIndependentResult = await runIndependentDriveRoute({\n    from,\n    to,\n    strategy,\n    carNumber,\n    restriction,\n    waypoints: anchorWaypoints,\n  });\n\n  let independentResult = anchoredIndependentResult;\n  let evaluation = evaluateIndependentResultAgainstWebRoute(\n    anchoredIndependentResult,\n    webPolyline,\n    anchorWaypoints,\n    maxDeviationMeters\n  );\n  let navigationUsesAnchorWaypoints = anchorWaypoints.length > 0;\n\n  // 如果锚点路线已经足够接近，再尝试去掉锚点重算一次。\n  // 这样可以避免“为了贴线而被锚点拖偏”的情况。\n  if (evaluation.bestMatch && evaluation.mode !== 'preview_only' && anchorWaypoints.length > 0) {\n    try {\n      const directIndependentResult = await runIndependentDriveRoute({\n        from,\n        to,\n        strategy,\n        carNumber,\n        restriction,\n      });\n\n      const directEvaluation = evaluateIndependentResultAgainstWebRoute(\n        directIndependentResult,\n        webPolyline,\n        [],\n        maxDeviationMeters\n      );\n      const anchoredBest = evaluation.bestMatch;\n      const directBest = directEvaluation.bestMatch;\n\n      const canSwitchToDirectNavigation =\n        Boolean(directBest) &&\n        directEvaluation.mode !== 'preview_only' &&\n        directBest!.averageDeviationMeters <= Math.max(\n          anchoredBest.averageDeviationMeters + 45,\n          anchoredBest.averageDeviationMeters * 1.45\n        ) &&\n        directBest!.maxDeviationMeters <= Math.max(\n          anchoredBest.maxDeviationMeters + 90,\n          anchoredBest.maxDeviationMeters * 1.45\n        );\n\n      if (canSwitchToDirectNavigation) {\n        // 直连结果更自然，就切到直连结果，并清掉刚才的锚点算路缓存。\n        ExpoGaodeMapNavigationModule.clearIndependentRoute({\n          token: anchoredIndependentResult.token,\n        }).catch(() => {});\n        independentResult = directIndependentResult;\n        evaluation = directEvaluation;\n        navigationUsesAnchorWaypoints = false;\n        evaluation.reason =\n          directEvaluation.mode === 'matched'\n            ? '已切换为无途经点导航结果，且与 Web 规划线高度接近'\n            : '已切换为无途经点导航结果，但与 Web 规划线仍存在轻微偏差';\n      } else {\n        // 直连结果不如锚点方案，就保留锚点方案作为最终导航依据。\n        ExpoGaodeMapNavigationModule.clearIndependentRoute({\n          token: directIndependentResult.token,\n        }).catch(() => {});\n        evaluation.reason = `${evaluation.reason}；最终导航仍需依赖锚点途经点逼近 Web 线路`;\n      }\n    } catch {\n      evaluation.reason = `${evaluation.reason}；无途经点重算失败，最终导航仍需依赖锚点途经点`;\n    }\n  }\n\n  let navigationStarted = false;\n  if (startNavigation && evaluation.bestMatch && evaluation.mode !== 'preview_only') {\n    // 只有当评估结果足够接近时才真正启动导航，避免把偏差过大的结果直接交给导航 SDK。\n    navigationStarted = await ExpoGaodeMapNavigationModule.startNaviWithIndependentPath({\n      token: independentResult.token,\n      naviType,\n      routeId: evaluation.bestMatch.routeId,\n      routeIndex:\n        evaluation.bestMatch.routeId == null ? evaluation.bestMatch.routeIndex : undefined,\n    });\n  }\n\n  return {\n    mode: evaluation.mode,\n    token: independentResult.token,\n    anchorWaypoints,\n    webDistance: calculatePathLengthSafe(webPolyline),\n    nativeDistance:\n      evaluation.nativePolyline.length > 1\n        ? calculatePathLengthSafe(evaluation.nativePolyline)\n        : undefined,\n    selectedRouteId: evaluation.bestMatch?.routeId,\n    selectedRouteIndex: evaluation.bestMatch?.routeIndex,\n    averageDeviationMeters: evaluation.bestMatch?.averageDeviationMeters,\n    maxDeviationMeters: evaluation.bestMatch?.maxDeviationMeters,\n    navigationStarted,\n    navigationUsesAnchorWaypoints,\n    independentResult,\n    candidateMatches: evaluation.candidateMatches,\n    reason: evaluation.reason,\n  };\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-gaode-map-navigation",
-  "version": "2.0.13",
+  "version": "2.0.14",
   "description": "React Native AMap (Gaode Map) navigation module for Expo: route planning and turn-by-turn navigation, includes full map features.",
   "author": "TomWq <582752848@qq.com> (https://github.com/TomWq)",
   "repository": {
@@ -15,7 +15,7 @@
     "build:plugin": "tsc --project plugin/tsconfig.json",
     "clean": "expo-module clean",
     "lint": "expo-module lint",
-    "test": "expo-module test",
+    "test": "npx jest --no-watchman --config jest.config.js --runInBand",
     "prepare": "expo-module prepare && yarn build:plugin",
     "postinstall": "node scripts/check-expo-modules.js",
     "prepublishOnly": "echo 'Skipping proofread check' && exit 0",