🗺️
完整的地图功能
支持多种地图类型、手势控制、相机操作等完整功能
expo-gaode-map高德地图 React Native 组件
基于 Expo Modules 开发的完整高德地图解决方案
Skip to content
快速开始
版本兼容性说明
请根据您的 Expo SDK 版本选择合适的包版本：
| Expo SDK 版本 | 推荐包版本 | 安装命令 | 说明 |
|---|---|---|---|
| SDK 54+ | Latest | npm install expo-gaode-map | ✅ 功能最全 ✅ 使用高德 iOS SDK v10.1.600+ |
| SDK 53 及以下 | V1 | npm install expo-gaode-map@v1 | ⚠️ 不支持加载世界向量地图 ✅ 使用高德 iOS SDK v10.0.1000 (注：旧版 Expo 使用新版高德 SDK 会导致 iOS 闪退) |
提示：除了世界地图功能外，V1 和 Latest 版本的 API 接口完全一致，可放心切换。
安装
bash
# 核心包（地图+定位）
npm install expo-gaode-map
# 导航包（包含地图+导航）🆕
npm install expo-gaode-map-navigation
# Web API 服务 🆕
npm install expo-gaode-map-web-api
# 原生搜索（可选）
npm install expo-gaode-map-search包选择建议
- 只需要地图和定位 →
expo-gaode-map - 需要导航功能 →
expo-gaode-map-navigation（已包含地图） - 需要跨平台 Web 服务 →
expo-gaode-map-web-api - 需要原生搜索 →
expo-gaode-map-search
重要提示
- 使用 Config Plugin 时，原生 Key 会自动配置 安卓的
AndroidManifest.xml和 ios 的Info.plist - 建议使用真机测试，模拟器可能不支持地图功能，会出现黑屏或闪退等异常情况
核心功能模块
📦 expo-gaode-map
核心地图包，提供基础地图显示、定位、覆盖物等功能。
🚗 expo-gaode-map-navigation 🆕
导航功能包，提供完整的路径规划和导航能力：
- 路径规划: 驾车、步行、骑行、货车、摩托车、电动车
- 导航视图: 官方导航界面，实时路况、语音播报
- 独立规划: 不影响当前导航状态的路径计算
🌐 expo-gaode-map-web-api 🆕
Web API 服务包，纯 JavaScript 实现，跨平台一致：
- 地理编码: 地址与坐标相互转换
- 路径规划: 支持驾车、步行、骑行、公交等
- POI 搜索: 关键字搜索、周边搜索、多边形搜索
- 输入提示: 实时搜索建议
🔍 expo-gaode-map-search
原生搜索包，性能更优的 POI 搜索实现（可选）。
为什么选择 expo-gaode-map？
- ✅ 基于 Expo Modules: 现代化的开发体验，类型安全
- ✅ 功能完整: 覆盖地图、导航、搜索等主要功能
- ✅ 模块化设计: 按需安装，避免不必要的包体积
- ✅ 文档完善: 详细的中英文档和丰富的示例
- ✅ 积极维护: 持续更新和社区支持
- ✅ 新老架构支持: 完美兼容 React Native 新架构（Fabric & TurboModules）
- ✅ 场景丰富: 可以实现多种地图场景，如打车、外卖、导航等
- ✅ 开源免费: MIT 协议，可商用
社区
- 📝 GitHub Issues
- 💬 Discussions
- 💬 QQ 群: 952241387
致谢
本项目参考了 react-native-amap3d 的优秀设计。