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

package/build/types/naviview.types.d.ts

@@ -0,0 +1,269 @@
+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;
+}
+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;
+    /**
+     * 是否显示路线
+     * @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;
+}

package/build/types/naviview.types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/types/route.types.d.ts

@@ -0,0 +1,282 @@
+import type { Coordinates } from './coordinates.types';
+/**
+ * 路径规划类型
+ */
+export declare enum RouteType {
+    /** 驾车路径规划 */
+    DRIVE = "drive",
+    /** 步行路径规划 */
+    WALK = "walk",
+    /** 骑行路径规划 */
+    RIDE = "ride",
+    /** 货车路径规划 */
+    TRUCK = "truck"
+}
+/**
+ * 驾车路径规划策略
+ */
+export declare enum DriveStrategy {
+    /** 速度优先（时间最短） */
+    FASTEST = 0,
+    /** 费用优先（不走收费路段的最快路线） */
+    FEE_FIRST = 1,
+    /** 距离优先（距离最短） */
+    SHORTEST = 2,
+    /** 不走快速路（不走快速路的最快路线） */
+    NO_EXPRESSWAYS = 3,
+    /** 结合实时交通（躲避拥堵） */
+    AVOID_CONGESTION = 4,
+    /** 不走高速 */
+    NO_HIGHWAY = 5,
+    /** 不走高速且避免收费 */
+    NO_HIGHWAY_AVOID_CONGESTION = 6,
+    /** 躲避收费和拥堵 */
+    AVOID_COST_CONGESTION = 7,
+    /** 不走高速且躲避收费和拥堵 */
+    NO_HIGHWAY_AVOID_COST_CONGESTION = 8,
+    /** 躲避拥堵和收费 */
+    AVOID_CONGESTION_COST = 9
+}
+/**
+ * 步行路径规划策略
+ */
+export declare enum WalkStrategy {
+    /** 推荐路线 */
+    DEFAULT = 0
+}
+/**
+ * 骑行路径规划策略
+ */
+export declare enum RideStrategy {
+    /** 推荐路线 */
+    DEFAULT = 0,
+    /** 速度优先 */
+    FASTEST = 1,
+    /** 距离优先 */
+    SHORTEST = 2
+}
+/**
+ * 货车路径规划大小
+ */
+export declare enum TruckSize {
+    /** 微型货车 */
+    MINI = 1,
+    /** 轻型货车 */
+    LIGHT = 2,
+    /** 中型货车 */
+    MEDIUM = 3,
+    /** 重型货车 */
+    HEAVY = 4
+}
+/**
+ * 步行/骑行 Travel 策略（对齐原生：1000 单路线 / 1001 多路线）
+ */
+export declare enum TravelStrategy {
+    SINGLE = 1000,
+    MULTIPLE = 1001
+}
+/**
+ * 基础路径规划选项
+ */
+export interface BaseRouteOptions {
+    /** 起点坐标 */
+    from: Coordinates;
+    /** 终点坐标 */
+    to: Coordinates;
+    /** 途经点列表（可选） */
+    waypoints?: Coordinates[];
+}
+/**
+ * 驾车路径规划选项
+ */
+export interface DriveRouteOptions extends BaseRouteOptions {
+    type: RouteType.DRIVE;
+    /** 驾车策略，默认速度优先 */
+    strategy?: DriveStrategy;
+    /** 车牌号（用于限行策略，可选） */
+    carNumber?: string;
+    /** 避让区域（可选） */
+    avoidPolygons?: Coordinates[][];
+    /** 避让道路（道路名称，可选） */
+    avoidRoad?: string;
+}
+/**
+ * 步行路径规划选项
+ */
+export interface WalkRouteOptions extends BaseRouteOptions {
+    type: RouteType.WALK;
+    /** 步行策略 */
+    strategy?: WalkStrategy;
+    /** 出行策略（单路线/多路线），对齐原生 TravelStrategy：1000/1001 */
+    travelStrategy?: TravelStrategy;
+    /** 是否返回多路线（等价于 travelStrategy=TravelStrategy.MULTIPLE） */
+    multiple?: boolean;
+}
+/**
+ * 骑行路径规划选项
+ */
+export interface RideRouteOptions extends BaseRouteOptions {
+    type: RouteType.RIDE;
+    /** 骑行策略 */
+    strategy?: RideStrategy;
+    /** 出行策略（单路线/多路线），对齐原生 TravelStrategy：1000/1001 */
+    travelStrategy?: TravelStrategy;
+    /** 是否返回多路线（等价于 travelStrategy=TravelStrategy.MULTIPLE） */
+    multiple?: boolean;
+}
+/**
+ * 骑行电动车路径规划选项
+ */
+export interface EBikeRouteOptions extends BaseRouteOptions {
+    /** 出行策略（单路线/多路线），对齐原生 TravelStrategy：1000/1001 */
+    travelStrategy?: TravelStrategy;
+    /** 是否返回多路线（等价于 travelStrategy=TravelStrategy.MULTIPLE） */
+    multiple?: boolean;
+    /** 强制使用 POI 算路（若提供 name 或 poiId 时会自动使用） */
+    usePoi?: boolean;
+}
+/**
+ * 货车路径规划选项
+ */
+export interface TruckRouteOptions extends BaseRouteOptions {
+    type: RouteType.TRUCK;
+    /** 货车大小 */
+    size: TruckSize;
+    /** 货车高度（米） */
+    height?: number;
+    /** 货车宽度（米） */
+    width?: number;
+    /** 货车载重（吨） */
+    load?: number;
+    /** 货车重量（吨） */
+    weight?: number;
+    /** 货车轴数 */
+    axis?: number;
+}
+/**
+ * 路径步骤动作类型
+ */
+export declare enum StepAction {
+    /** 直行 */
+    STRAIGHT = 0,
+    /** 左转 */
+    LEFT = 1,
+    /** 右转 */
+    RIGHT = 2,
+    /** 左前方转弯 */
+    LEFT_FRONT = 3,
+    /** 右前方转弯 */
+    RIGHT_FRONT = 4,
+    /** 左后方转弯 */
+    LEFT_BACK = 5,
+    /** 右后方转弯 */
+    RIGHT_BACK = 6,
+    /** 左转掉头 */
+    LEFT_U_TURN = 7,
+    /** 到达目的地 */
+    ARRIVE = 8,
+    /** 进入环岛 */
+    ENTER_ROUNDABOUT = 9,
+    /** 驶出环岛 */
+    EXIT_ROUNDABOUT = 10
+}
+/**
+ * 道路类型
+ */
+export declare enum RoadType {
+    /** 高速公路 */
+    HIGHWAY = 0,
+    /** 国道 */
+    NATIONAL_ROAD = 1,
+    /** 省道 */
+    PROVINCIAL_ROAD = 2,
+    /** 县道 */
+    COUNTY_ROAD = 3,
+    /** 乡镇道路 */
+    TOWNSHIP_ROAD = 4,
+    /** 城市主干道 */
+    MAIN_ROAD = 5,
+    /** 城市次干道 */
+    SECONDARY_ROAD = 6,
+    /** 城市普通道路 */
+    NORMAL_ROAD = 7,
+    /** 其他道路 */
+    OTHER = 8
+}
+/**
+ * 路径步骤信息
+ */
+export interface RouteStep {
+    /** 步骤说明 */
+    instruction: string;
+    /** 方向说明 */
+    orientation?: string;
+    /** 道路名称 */
+    road?: string;
+    /** 距离（米） */
+    distance: number;
+    /** 预计时间（秒） */
+    duration: number;
+    /** 路径坐标点 */
+    polyline: Coordinates[];
+    /** 动作类型 */
+    action?: StepAction;
+    /** 辅助动作（可选） */
+    assistantAction?: string;
+    /** 收费距离（米） */
+    tollDistance?: number;
+    /** 收费金额（元） */
+    tollCost?: number;
+    /** 道路类型 */
+    roadType?: RoadType;
+}
+/**
+ * 路径规划结果
+ */
+export interface RouteResult {
+    /** 路线ID */
+    id: number;
+    /** 起点坐标 */
+    start: Coordinates;
+    /** 终点坐标 */
+    end: Coordinates;
+    /** 总距离（米） */
+    distance: number;
+    /** 预计时间（秒） */
+    duration: number;
+    /** 路径步骤 */
+    segments?: RouteStep[];
+    /** 路径坐标点（所有步骤的完整路径） */
+    polyline?: Coordinates[];
+    /** 收费距离（米），驾车时有效 */
+    tollDistance?: number;
+    /** 收费金额（元），驾车时有效 */
+    tollCost?: number;
+    /** 红绿灯数量，驾车时有效 */
+    trafficLightCount?: number;
+    /** 限行状态码，驾车时有效 */
+    restrictionCode?: number;
+    /** 限行状态说明，驾车时有效 */
+    restrictionInfo?: string;
+    /** 策略值 */
+    strategy?: number;
+}
+/**
+ * 驾车路径规划结果（包含多条路线）
+ */
+export interface DriveRouteResult {
+    /** 路径数量 */
+    count: number;
+    /** 主路线索引 */
+    mainPathIndex: number;
+    /** 路线ID列表 */
+    routeIds?: number[];
+    /** 路径列表，按策略返回1-3条路线 */
+    routes: RouteResult[];
+    /** 出租车费用（元） */
+    taxiCost?: number;
+}
+/**
+ * 路径规划选项联合类型
+ */
+export type RouteOptions = DriveRouteOptions | WalkRouteOptions | RideRouteOptions | EBikeRouteOptions | TruckRouteOptions;

package/build/types/route.types.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RoadType = exports.StepAction = exports.TravelStrategy = exports.TruckSize = exports.RideStrategy = exports.WalkStrategy = exports.DriveStrategy = exports.RouteType = void 0;
+/**
+ * 路径规划类型
+ */
+var RouteType;
+(function (RouteType) {
+    /** 驾车路径规划 */
+    RouteType["DRIVE"] = "drive";
+    /** 步行路径规划 */
+    RouteType["WALK"] = "walk";
+    /** 骑行路径规划 */
+    RouteType["RIDE"] = "ride";
+    /** 货车路径规划 */
+    RouteType["TRUCK"] = "truck";
+})(RouteType || (exports.RouteType = RouteType = {}));
+/**
+ * 驾车路径规划策略
+ */
+var DriveStrategy;
+(function (DriveStrategy) {
+    /** 速度优先（时间最短） */
+    DriveStrategy[DriveStrategy["FASTEST"] = 0] = "FASTEST";
+    /** 费用优先（不走收费路段的最快路线） */
+    DriveStrategy[DriveStrategy["FEE_FIRST"] = 1] = "FEE_FIRST";
+    /** 距离优先（距离最短） */
+    DriveStrategy[DriveStrategy["SHORTEST"] = 2] = "SHORTEST";
+    /** 不走快速路（不走快速路的最快路线） */
+    DriveStrategy[DriveStrategy["NO_EXPRESSWAYS"] = 3] = "NO_EXPRESSWAYS";
+    /** 结合实时交通（躲避拥堵） */
+    DriveStrategy[DriveStrategy["AVOID_CONGESTION"] = 4] = "AVOID_CONGESTION";
+    /** 不走高速 */
+    DriveStrategy[DriveStrategy["NO_HIGHWAY"] = 5] = "NO_HIGHWAY";
+    /** 不走高速且避免收费 */
+    DriveStrategy[DriveStrategy["NO_HIGHWAY_AVOID_CONGESTION"] = 6] = "NO_HIGHWAY_AVOID_CONGESTION";
+    /** 躲避收费和拥堵 */
+    DriveStrategy[DriveStrategy["AVOID_COST_CONGESTION"] = 7] = "AVOID_COST_CONGESTION";
+    /** 不走高速且躲避收费和拥堵 */
+    DriveStrategy[DriveStrategy["NO_HIGHWAY_AVOID_COST_CONGESTION"] = 8] = "NO_HIGHWAY_AVOID_COST_CONGESTION";
+    /** 躲避拥堵和收费 */
+    DriveStrategy[DriveStrategy["AVOID_CONGESTION_COST"] = 9] = "AVOID_CONGESTION_COST";
+})(DriveStrategy || (exports.DriveStrategy = DriveStrategy = {}));
+/**
+ * 步行路径规划策略
+ */
+var WalkStrategy;
+(function (WalkStrategy) {
+    /** 推荐路线 */
+    WalkStrategy[WalkStrategy["DEFAULT"] = 0] = "DEFAULT";
+})(WalkStrategy || (exports.WalkStrategy = WalkStrategy = {}));
+/**
+ * 骑行路径规划策略
+ */
+var RideStrategy;
+(function (RideStrategy) {
+    /** 推荐路线 */
+    RideStrategy[RideStrategy["DEFAULT"] = 0] = "DEFAULT";
+    /** 速度优先 */
+    RideStrategy[RideStrategy["FASTEST"] = 1] = "FASTEST";
+    /** 距离优先 */
+    RideStrategy[RideStrategy["SHORTEST"] = 2] = "SHORTEST";
+})(RideStrategy || (exports.RideStrategy = RideStrategy = {}));
+/**
+ * 货车路径规划大小
+ */
+var TruckSize;
+(function (TruckSize) {
+    /** 微型货车 */
+    TruckSize[TruckSize["MINI"] = 1] = "MINI";
+    /** 轻型货车 */
+    TruckSize[TruckSize["LIGHT"] = 2] = "LIGHT";
+    /** 中型货车 */
+    TruckSize[TruckSize["MEDIUM"] = 3] = "MEDIUM";
+    /** 重型货车 */
+    TruckSize[TruckSize["HEAVY"] = 4] = "HEAVY";
+})(TruckSize || (exports.TruckSize = TruckSize = {}));
+/**
+ * 步行/骑行 Travel 策略（对齐原生：1000 单路线 / 1001 多路线）
+ */
+var TravelStrategy;
+(function (TravelStrategy) {
+    TravelStrategy[TravelStrategy["SINGLE"] = 1000] = "SINGLE";
+    TravelStrategy[TravelStrategy["MULTIPLE"] = 1001] = "MULTIPLE";
+})(TravelStrategy || (exports.TravelStrategy = TravelStrategy = {}));
+/**
+ * 路径步骤动作类型
+ */
+var StepAction;
+(function (StepAction) {
+    /** 直行 */
+    StepAction[StepAction["STRAIGHT"] = 0] = "STRAIGHT";
+    /** 左转 */
+    StepAction[StepAction["LEFT"] = 1] = "LEFT";
+    /** 右转 */
+    StepAction[StepAction["RIGHT"] = 2] = "RIGHT";
+    /** 左前方转弯 */
+    StepAction[StepAction["LEFT_FRONT"] = 3] = "LEFT_FRONT";
+    /** 右前方转弯 */
+    StepAction[StepAction["RIGHT_FRONT"] = 4] = "RIGHT_FRONT";
+    /** 左后方转弯 */
+    StepAction[StepAction["LEFT_BACK"] = 5] = "LEFT_BACK";
+    /** 右后方转弯 */
+    StepAction[StepAction["RIGHT_BACK"] = 6] = "RIGHT_BACK";
+    /** 左转掉头 */
+    StepAction[StepAction["LEFT_U_TURN"] = 7] = "LEFT_U_TURN";
+    /** 到达目的地 */
+    StepAction[StepAction["ARRIVE"] = 8] = "ARRIVE";
+    /** 进入环岛 */
+    StepAction[StepAction["ENTER_ROUNDABOUT"] = 9] = "ENTER_ROUNDABOUT";
+    /** 驶出环岛 */
+    StepAction[StepAction["EXIT_ROUNDABOUT"] = 10] = "EXIT_ROUNDABOUT";
+})(StepAction || (exports.StepAction = StepAction = {}));
+/**
+ * 道路类型
+ */
+var RoadType;
+(function (RoadType) {
+    /** 高速公路 */
+    RoadType[RoadType["HIGHWAY"] = 0] = "HIGHWAY";
+    /** 国道 */
+    RoadType[RoadType["NATIONAL_ROAD"] = 1] = "NATIONAL_ROAD";
+    /** 省道 */
+    RoadType[RoadType["PROVINCIAL_ROAD"] = 2] = "PROVINCIAL_ROAD";
+    /** 县道 */
+    RoadType[RoadType["COUNTY_ROAD"] = 3] = "COUNTY_ROAD";
+    /** 乡镇道路 */
+    RoadType[RoadType["TOWNSHIP_ROAD"] = 4] = "TOWNSHIP_ROAD";
+    /** 城市主干道 */
+    RoadType[RoadType["MAIN_ROAD"] = 5] = "MAIN_ROAD";
+    /** 城市次干道 */
+    RoadType[RoadType["SECONDARY_ROAD"] = 6] = "SECONDARY_ROAD";
+    /** 城市普通道路 */
+    RoadType[RoadType["NORMAL_ROAD"] = 7] = "NORMAL_ROAD";
+    /** 其他道路 */
+    RoadType[RoadType["OTHER"] = 8] = "OTHER";
+})(RoadType || (exports.RoadType = RoadType = {}));