Expo Gaode Map Navigation
描述
expo-gaode-map-navigation 是高德导航 SDK 的 React Native 封装。它提供了完整的导航解决方案，包括嵌入式导航 UI (NaviView)、多模式路径规划 API 以及高级的独立算路功能。
使用场景
- 应用内导航：直接在 App 内部显示导航界面，无需跳转第三方 App。
- 路径规划：计算两点间的距离、耗时、路线详情（支持驾车、步行、骑行）。
- 特殊车辆导航：支持货车（限高/限重）、摩托车、电动车导航。
- 行前选路：在开始导航前预览多条路线方案并进行选择。
开发指令
1. 基础集成 (NaviView)
- 使用
<ExpoGaodeMapNaviView>组件嵌入导航界面。 - 通过
ref调用startNavigation和stopNavigation。 - 必须设置
style(通常是flex: 1)。 - 如果同时使用本包导出的
MapView/ExpoGaodeMapModule/ 定位能力，必须先完成隐私确认。
2. 路径规划 (Routing)
- 驾车:
calculateDriveRoute - 步行:
calculateWalkRoute - 骑行:
calculateRideRoute - 货车:
calculateTruckRoute(需设置TruckSize,height,load等)
3. 高级功能 (Advanced)
- 独立算路: 使用
independentDriveRoute+selectIndependentRoute实现行前路线预览与选择。 - UI 定制: 使用
showMode,naviMode,showTrafficBar等属性深度定制导航界面。
快速模式
✅ 场景 1：嵌入式导航 UI
import { useRef } from 'react';
import {
ExpoGaodeMapNaviView,
type ExpoGaodeMapNaviViewRef,
} from 'expo-gaode-map-navigation';
// 必须使用 ref 来控制导航开始/结束
const naviRef = useRef<ExpoGaodeMapNaviViewRef>(null);
<ExpoGaodeMapNaviView
ref={naviRef}
style={{ flex: 1 }}
naviType={0} // 0: GPS, 1: 模拟
showTrafficButton={true}
onArrive={() => console.log('到达目的地')}
/>
// 发起导航
naviRef.current?.startNavigation(null, { latitude: 39.9, longitude: 116.4 }, 0);
✅ 场景 2：驾车路径规划
import { calculateDriveRoute, DriveStrategy } from 'expo-gaode-map-navigation';
const result = await calculateDriveRoute({
from: { latitude: 39.9, longitude: 116.4 },
to: { latitude: 39.95, longitude: 116.45 },
strategy: DriveStrategy.AVOID_CONGESTION
});
console.log(`距离: ${result.routes[0].distance}米`);
🛡️ 类型安全最佳实践
本库提供了完整的 TypeScript 定义，请参考 类型定义文档 了解详情。
核心原则：
- 请勿使用
any，始终导入并使用正确的类型（如DriveRouteOptions,NaviInfo,DriveStrategy等）。 - 优先使用原生计算：涉及到路径相关的计算（如距离、时间、吸附、抽稀等），优先使用当前包导出的
ExpoGaodeMapModule原生几何方法。严禁为了几何计算再额外安装expo-gaode-map，否则会产生 SDK 冲突。
升级提示
- 新版本中，本包内置的地图/定位能力也遵循和核心包一致的隐私前置约束。
- 如果老项目升级后直接渲染
MapView或调用定位 API，会先收到PRIVACY_NOT_AGREED。 - 建议流程：首次启动先弹隐私协议 -> 用户同意 -> 设置隐私状态 -> 再进入地图/导航页面。