expo-gaode-map-navigation 1.0.1-next.0

package/src/types/independent.types.ts

@@ -0,0 +1,288 @@
+import type { RouteResult } from './route.types';
+
+/**
+ * 独立路径规划返回结构（不会影响当前导航状态）
+ *
+ * - routes: 可直接用于路线预览（与普通算路的 RouteResult 结构一致）
+ * - mainPathIndex: 主路线索引（调用 startNaviWithPath 前可选路）
+ */
+export interface IndependentRouteResult {
+  independent: true;
+  token: number;
+  count: number;
+  mainPathIndex: number;
+  routeIds: number[];
+  routes: RouteResult[];
+}
+
+/**
+ * 独立驾车路径规划参数
+ *
+ * 说明：
+ * - strategy 仍使用 DriveStrategy 即可；也可改用布尔组合标志（下方四个），原生会在未传 strategy 时走 strategyConvert
+ * - restriction：是否考虑限行（与 carNumber 搭配）
+ */
+export interface IndependentDriveRouteOptions {
+  /** 起点坐标 */
+  from: {
+    latitude: number;
+    longitude: number;
+    name?: string;
+    poiId?: string;
+  };
+  /** 终点坐标 */
+  to: {
+    latitude: number;
+    longitude: number;
+    name?: string;
+    poiId?: string;
+  };
+  /** 途经点列表 */
+  waypoints?: Array<{
+    latitude: number;
+    longitude: number;
+    name?: string;
+    poiId?: string;
+  }>;
+  /** 驾车策略 */
+  strategy?: number;
+  /** 避免拥堵 */
+  avoidCongestion?: boolean;
+  /** 避免高速 */
+  avoidHighway?: boolean;
+  /** 避免收费 */
+  avoidCost?: boolean;
+  /** 优先高速 */
+  prioritiseHighway?: boolean;
+  /** 车牌号 */
+  carNumber?: string;
+  /** 是否考虑限行 */
+  restriction?: boolean;
+}
+
+/**
+ * 独立货车路径规划参数
+ *
+ * 说明：
+ * - 默认 carType=1，支持 carNumber / restriction；可在原生侧扩展轴数/长宽高/载重等
+ * - 同样支持布尔组合标志以计算策略
+ */
+export interface IndependentTruckRouteOptions {
+  /** 起点坐标 */
+  from: {
+    latitude: number;
+    longitude: number;
+    name?: string;
+    poiId?: string;
+  };
+  /** 终点坐标 */
+  to: {
+    latitude: number;
+    longitude: number;
+    name?: string;
+    poiId?: string;
+  };
+  /** 途经点列表 */
+  waypoints?: Array<{
+    latitude: number;
+    longitude: number;
+    name?: string;
+    poiId?: string;
+  }>;
+  /** 驾车策略 */
+  strategy?: number;
+  /** 避免拥堵 */
+  avoidCongestion?: boolean;
+  /** 避免高速 */
+  avoidHighway?: boolean;
+  /** 避免收费 */
+  avoidCost?: boolean;
+  /** 优先高速 */
+  prioritiseHighway?: boolean;
+  /** 车牌号 */
+  carNumber?: string;
+  /** 是否考虑限行 */
+  restriction?: boolean;
+}
+
+/**
+ * 摩托车路径规划参数
+ *
+ * 说明：
+ * - 与驾车算路一致，但需在原生侧设置 AMapCarInfo.carType=11，并可传 motorcycleCC（排量）
+ * - carNumber 可用于限行策略参考
+ */
+export interface MotorcycleRouteOptions {
+  /** 起点坐标 */
+  from: {
+    latitude: number;
+    longitude: number;
+  };
+  /** 终点坐标 */
+  to: {
+    latitude: number;
+    longitude: number;
+  };
+  /** 途经点列表 */
+  waypoints?: Array<{
+    latitude: number;
+    longitude: number;
+  }>;
+  /** 驾车策略 */
+  strategy?: number;
+  /** 避免拥堵 */
+  avoidCongestion?: boolean;
+  /** 避免高速 */
+  avoidHighway?: boolean;
+  /** 避免收费 */
+  avoidCost?: boolean;
+  /** 优先高速 */
+  prioritiseHighway?: boolean;
+  /** 车牌号（可选） */
+  carNumber?: string;
+  /** 摩托车排量（单位：cc，可选） */
+  motorcycleCC?: number;
+}
+
+/**
+ * 独立摩托车路径规划参数
+ *
+ * 说明：
+ * - 与独立驾车一致，但需在原生侧设置 carType=11，并可传 motorcycleCC
+ */
+export interface IndependentMotorcycleRouteOptions {
+  /** 起点坐标 */
+  from: {
+    latitude: number;
+    longitude: number;
+    name?: string;
+    poiId?: string;
+  };
+  /** 终点坐标 */
+  to: {
+    latitude: number;
+    longitude: number;
+    name?: string;
+    poiId?: string;
+  };
+  /** 途经点列表 */
+  waypoints?: Array<{
+    latitude: number;
+    longitude: number;
+    name?: string;
+    poiId?: string;
+  }>;
+  /** 驾车策略 */
+  strategy?: number;
+  /** 避免拥堵 */
+  avoidCongestion?: boolean;
+  /** 避免高速 */
+  avoidHighway?: boolean;
+  /** 避免收费 */
+  avoidCost?: boolean;
+  /** 优先高速 */
+  prioritiseHighway?: boolean;
+  /** 车牌号（可选） */
+  carNumber?: string;
+  /** 摩托车排量（单位：cc，可选） */
+  motorcycleCC?: number;
+}
+
+/**
+ * 独立步行路径规划参数
+ *
+ * 说明：
+ * - 通过 travelStrategy 指定 SINGLE/MULTIPLE；或使用 multiple=true 开启多路线
+ */
+export interface IndependentWalkRouteOptions {
+  /** 起点坐标 */
+  from: {
+    latitude: number;
+    longitude: number;
+    name?: string;
+    poiId?: string;
+  };
+  /** 终点坐标 */
+  to: {
+    latitude: number;
+    longitude: number;
+    name?: string;
+    poiId?: string;
+  };
+  /** 途经点列表 */
+  waypoints?: Array<{
+    latitude: number;
+    longitude: number;
+    name?: string;
+    poiId?: string;
+  }>;
+  /** 出行策略（单路线/多路线），对齐原生 TravelStrategy：1000/1001 */
+  travelStrategy?: number;
+  /** 是否返回多路线（等价于 travelStrategy=TravelStrategy.MULTIPLE） */
+  multiple?: boolean;
+}
+
+/**
+ * 独立骑行路径规划参数
+ *
+ * 说明：
+ * - 通过 travelStrategy 指定 SINGLE/MULTIPLE；或使用 multiple=true 开启多路线
+ */
+export interface IndependentRideRouteOptions {
+  /** 起点坐标 */
+  from: {
+    latitude: number;
+    longitude: number;
+    name?: string;
+    poiId?: string;
+  };
+  /** 终点坐标 */
+  to: {
+    latitude: number;
+    longitude: number;
+    name?: string;
+    poiId?: string;
+  };
+  /** 途经点列表 */
+  waypoints?: Array<{
+    latitude: number;
+    longitude: number;
+    name?: string;
+    poiId?: string;
+  }>;
+  /** 出行策略（单路线/多路线），对齐原生 TravelStrategy：1000/1001 */
+  travelStrategy?: number;
+  /** 是否返回多路线（等价于 travelStrategy=TravelStrategy.MULTIPLE） */
+  multiple?: boolean;
+}
+
+/**
+ * 选择独立路径组中的主路线参数
+ * - token: 独立算路返回的 token
+ * - routeId/routeIndex: 选路（优先使用 routeId；未提供则保持当前主路线）
+ */
+export interface SelectIndependentRouteOptions {
+  token: number;
+  routeId?: number;
+  routeIndex?: number;
+}
+
+/**
+ * 使用独立路径组启动导航参数
+ * - token: 独立算路返回的 token
+ * - naviType: 0=GPS; 1=EMULATOR（默认 0）
+ * - routeId/routeIndex: 启动前可选路
+ */
+export interface StartNaviWithIndependentPathOptions {
+  token: number;
+  naviType?: number;
+  routeId?: number;
+  routeIndex?: number;
+}
+
+/**
+ * 清理独立路径组
+ */
+export interface ClearIndependentRouteOptions {
+  token: number;
+}

package/src/types/index.ts

@@ -0,0 +1,5 @@
+// 导出所有类型定义
+export * from './coordinates.types';
+export * from './route.types';
+export * from './independent.types';
+export * from './naviview.types';

package/src/types/naviview.types.ts

@@ -0,0 +1,330 @@
+import { ViewProps, NativeSyntheticEvent } from "react-native";
+
+// 导航信息更新事件
+export interface NaviInfoUpdateEvent {
+  pathRetainDistance: number;
+  pathRetainTime: number;
+  currentRoadName: string;
+  nextRoadName: string;
+  currentSpeed: number;
+  iconType: number;
+  iconDirection: number;
+}
+
+// 导航开始事件
+export interface NaviStartEvent {
+  type?: number;
+  loaded?: boolean;
+}
+
+// 导航结束事件
+export interface NaviEndEvent {
+  reason: string;
+}
+
+// 到达目的地事件
+export interface NaviArriveEvent {
+  arrived: boolean;
+}
+
+// 路径规划成功事件
+export interface CalculateRouteSuccessEvent {
+  routeIds?: number[];
+  success?: boolean;
+}
+
+// 路径规划失败事件
+export interface CalculateRouteFailureEvent {
+  error?: string;
+  errorCode?: number;
+}
+
+// 重新规划路径事件
+export interface ReCalculateEvent {
+  reason: string;
+}
+
+// 语音播报事件
+export interface PlayVoiceEvent {
+  text: string;
+  type?: number;
+}
+
+// GPS信号弱事件
+export interface GpsSignalWeakEvent {
+  isWeak: boolean;
+}
+
+// 路线重算事件
+export interface RouteRecalculateEvent {
+  reason: string;
+}
+
+/**
+ * 导航视图属性
+ */
+export interface NaviViewProps extends ViewProps {
+  /**
+   * 导航类型
+   * - 0: GPS 导航
+   * - 1: 模拟导航
+   */
+  naviType?: number;
+  
+  /**
+   * 是否启用语音播报
+   * @default true
+   */
+  enableVoice?: boolean;
+  
+  /**
+   * 是否显示摄像头
+   * @default true
+   */
+  showCamera?: boolean;
+  
+  /**
+   * 是否自动锁车（非锁车模式7秒后自动切换为锁车模式）
+   * @default true
+   */
+  autoLockCar?: boolean;
+  
+  /**
+   * 是否开启自动缩放（锁车模式下自动缩放地图以预见下一导航动作）
+   * @default true
+   */
+  autoChangeZoom?: boolean;
+  
+  /**
+   * 是否显示交通路况
+   * @default true
+   */
+  trafficLayerEnabled?: boolean;
+  
+  /**
+   * 是否显示路口放大图
+   * @default true
+   */
+  realCrossDisplay?: boolean;
+  
+  /**
+   * 导航视角模式
+   * - 0: 车头朝上 (carNorth)
+   * - 1: 正北朝上 (mapNorth)
+   * @default 0
+   */
+  naviMode?: number;
+  
+  /**
+   * 导航显示模式
+   * - 1: 锁车态 (carPositionLocked) - 自车图标锁定在屏幕固定位置
+   * - 2: 全览态 (overview) - 整条路线显示在可见区域内
+   * - 3: 普通态 (normal) - 地图不动，自车图标移动
+   * @default 1
+   */
+  showMode?: number;
+  
+  /**
+   * 是否开启夜间模式
+   * @default false
+   */
+  isNightMode?: boolean;
+  
+  /**
+   * 是否显示自车和罗盘
+   * @platform android
+   * @default true
+   * @since 6.2.0
+   */
+  carOverlayVisible?: boolean;
+  
+  /**
+   * 是否显示交通信号灯
+   * @platform android
+   * @default true
+   * @since 7.4.0
+   */
+  trafficLightsVisible?: boolean;
+  
+  /**
+   * 路线标记点可见性配置
+   * @platform android
+   * @since 9.0.0
+   */
+  routeMarkerVisible?: {
+    /** 是否显示起终途点 @default true */
+    showStartEndVia?: boolean;
+    /** 是否显示步行轮渡扎点 @default true */
+    showFootFerry?: boolean;
+    /** 是否显示禁行限行封路icon @default true */
+    showForbidden?: boolean;
+    /** 是否显示路线起点icon @default true @since 9.0.0 */
+    showRouteStartIcon?: boolean;
+    /** 是否显示路线终点icon @default true @since 9.0.0 */
+    showRouteEndIcon?: boolean;
+  };
+  
+  /**
+   * 是否显示路线转向箭头
+   * @platform android
+   * @default true
+   * @since 6.3.0
+   */
+  naviArrowVisible?: boolean;
+  
+  /**
+   * 是否显示拥堵气泡
+   * @platform android
+   * @default true
+   * @since 10.0.5
+   */
+  showDriveCongestion?: boolean;
+  
+  /**
+   * 是否显示红绿灯倒计时气泡
+   * @platform android
+   * @default true
+   * @since 10.0.5
+   */
+  showTrafficLightView?: boolean;
+  
+  // ========== iOS 特有属性 ==========
+  
+  /**
+   * 是否显示路线
+   * @platform ios
+   * @default true
+   */
+  showRoute?: boolean;
+  
+  /**
+   * 是否显示转向箭头
+   * @platform ios
+   * @default true
+   */
+  showTurnArrow?: boolean;
+  
+  /**
+   * 是否显示路况光柱
+   * @platform ios
+   * @default true
+   */
+  showTrafficBar?: boolean;
+  
+  /**
+   * 是否显示全览按钮
+   * @platform ios
+   * @default true
+   */
+  showBrowseRouteButton?: boolean;
+  
+  /**
+   * 是否显示更多按钮
+   * @platform ios
+   * @default true
+   */
+  showMoreButton?: boolean;
+  
+  /**
+   * 是否显示实时交通按钮
+   * @platform ios
+   * @default true
+   */
+  showTrafficButton?: boolean;
+  
+  /**
+   * 是否显示界面元素（设为false可完全自定义界面）
+   * @platform ios
+   * @default true
+   */
+  showUIElements?: boolean;
+  
+  /**
+   * 走过的路线是否置灰
+   * @platform ios
+   * @default false
+   */
+  showGreyAfterPass?: boolean;
+  
+  /**
+   * 是否显示牵引线（起点到终点的飞线）
+   * @platform ios
+   * @default true
+   */
+  showVectorline?: boolean;
+  
+  /**
+   * 是否显示红绿灯图标
+   * @platform ios
+   * @default true
+   */
+  showTrafficLights?: boolean;
+  
+  /**
+   * 地图样式类型
+   * - 0: 白天模式 (day)
+   * - 1: 黑夜模式 (night)
+   * - 2: 根据日出日落自动切换 (dayNightAuto)
+   * - 3: 自定义地图样式 (custom)
+   * @platform ios
+   * @default 0
+   */
+  mapViewModeType?: number;
+  
+  /**
+   * 路线polyline的宽度，设置0恢复默认宽度
+   * @platform ios
+   */
+  lineWidth?: number;
+  
+  /**
+   * 导航信息更新回调
+   */
+  onNaviInfoUpdate?: (event: NativeSyntheticEvent<NaviInfoUpdateEvent>) => void;
+  
+  /**
+   * 导航开始回调
+   */
+  onNaviStart?: (event: NativeSyntheticEvent<NaviStartEvent>) => void;
+  
+  /**
+   * 导航结束回调
+   */
+  onNaviEnd?: (event: NativeSyntheticEvent<NaviEndEvent>) => void;
+  
+  /**
+   * 到达目的地回调
+   */
+  onArrive?: (event: NativeSyntheticEvent<NaviArriveEvent>) => void;
+  
+  /**
+   * 路径规划成功回调
+   */
+  onCalculateRouteSuccess?: (event: NativeSyntheticEvent<CalculateRouteSuccessEvent>) => void;
+  
+  /**
+   * 路径规划失败回调
+   */
+  onCalculateRouteFailure?: (event: NativeSyntheticEvent<CalculateRouteFailureEvent>) => void;
+  
+  /**
+   * 重新规划路径回调
+   */
+  onReCalculate?: (event: NativeSyntheticEvent<ReCalculateEvent>) => void;
+  
+  /**
+   * 语音播报回调
+   */
+  onPlayVoice?: (event: NativeSyntheticEvent<PlayVoiceEvent>) => void;
+  
+  /**
+   * GPS信号弱回调
+   */
+  onGpsSignalWeak?: (event: NativeSyntheticEvent<GpsSignalWeakEvent>) => void;
+  
+  /**
+   * 路线重算回调
+   */
+  onRouteRecalculate?: (event: NativeSyntheticEvent<RouteRecalculateEvent>) => void;
+}
+