🗺️
完整的地图功能
支持多种地图类型、手势控制、相机操作等完整功能
expo-gaode-map高德地图 React Native 组件
基于 Expo Modules 开发的完整高德地图解决方案
Skip to content
快速开始
安装
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
基础使用
tsx
import { MapView, ExpoGaodeMapModule } from 'expo-gaode-map';
// 初始化 SDK（使用 Config Plugin 时可传空对象）
ExpoGaodeMapModule.initSDK({
webKey: 'your-web-api-key', // 仅在使用 Web API 服务时需要
});
// 使用地图
<MapView
style={{ flex: 1 }}
initialCameraPosition={{
target: { latitude: 39.9, longitude: 116.4 },
zoom: 10,
}}
myLocationEnabled={true}
/>重要提示
- 使用 Config Plugin 时，原生 Key 会自动配置，
initSDK可传空对象（更安全） webKey仅在使用expo-gaode-map-web-api包时需要
核心功能模块
📦 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: 现代化的开发体验，类型安全
- ✅ 功能完整: 覆盖地图、导航、搜索等主要功能
- ✅ 模块化设计: 按需安装，避免不必要的包体积
- ✅ 文档完善: 详细的中英文档和丰富的示例
- ✅ 积极维护: 持续更新和社区支持
- ✅ 开源免费: MIT 协议，可商用
社区
- 📝 GitHub Issues
- 💬 Discussions
- 💬 QQ 群: 952241387
致谢
本项目参考了 react-native-amap3d 的优秀设计。