简体中文
简体中文
App端地图模块封装了市场上主流的三方地图SDK，提供JS API统一调用Android、iOS原生地图功能。
| 项目类型 | API |
|---|---|
| uni-app | uni.getLocation(OBJECT)、uni.chooseLocation(OBJECT)、uni.openLocation(OBJECT)、uni.createMapContext(mapId,this)、map组件 |
| 5+App/Wap2App | plus.maps.* |
使用地图功能需在项目manifest.json的“App模块配置”中勾选“Maps(地图)”，并根据项目实际情况勾选使用的三方地图SDK：
提示：App模块配置需提交云端打包后才能生效，真机运行调试时请使用自定义基座
注意
- 使用高德地图、百度地图需要商业授权，详情参考 商业授权相关说明
- uni-app项目中仅nvue页面支持使用原生SDK
- uni-app项目暂时不支持使用百度地图
# 高德地图
# 申请高德地图Key
使用前需到高德开放平台创建应用并申请Key
- 登录 高德开放平台，进入“控制台”，如果没有注册账号请先根据页面提示注册账号
- 打开 “应用管理” -> “我的应用”页面，点击“创建新应用”，根据页面提示填写内容创建应用
- 在应用下点击“添加”为应用添加Key，根据需要分别为Android平台、iOS平台申请Key
# 配置使用高德地图
打开项目的manifest.json文件，在“App模块配置”项的“Maps(地图)”下，勾选“高德地图”：
# 参数说明
- 高德用户名 高德开放平台注册账号的用户名，获取方式参考“高德开放平台用户名”章节
- appkey_android 高德开放平台申请的Android平台Key
- appkey_ios 高德开放平台申请的iOS平台Key
注意
- HBuilderX标准基座默认使用高德地图SDK，可以直接真机运行测试，此时配置的应用包名、签名信息不生效，正式发布前请提交云端打包或使用自定义调试基座测试
- 本地离线打包参考Android平台高德地图模块配置、iOS平台高德地图模块配置
# 高德开放平台用户名
登录 高德开放平台，进入“控制台”，在“账号信息”的“基本信息”中可获取“用户名”：
# 百度地图
# 申请百度地图Key
使用前需到百度开放平台创建应用并申请Key
- 登录 百度开放平台，进入“控制台”，如果没有注册账号请先根据页面提示注册账号
- 打开 “应用管理” -> “我的应用”页面，点击“创建应用”，根据页面提示填写内容创建应用获取Key
# 配置使用百度地图
打开项目的manifest.json文件，在“App模块配置”项的“Maps(地图)”下，勾选“百度地图”：
# 参数说明
- appkey_android 百度地图开放平台申请的Android平台Key
- appkey_ios 百度地图开放平台申请的iOS平台Key
注意
- HBuilderX标准基座没有包含百度地图，请配置后使用自定义调试基座测试
- 本地离线打包参考Android平台百度地图模块配置、iOS平台百度地图模块配置
# Google地图（谷歌地图/google map）
HBuilderX3.4.0+版本新增支持
# 申请Google地图Key
使用前需到Google地图开放平台创建应用并申请APIKey
- 登录 Google地图开放平台，如果没有注册账号请先根据页面提示注册账号
- 根据页面提示新建项目，也可以选择已经存在的项目
- 打开“凭证”页面，点击 “创建凭证” -> “API密钥”获取APIKey，由于Google地图需要收费，为了保证安全建议配置限制密钥
- Android平台 在“应用限制”下勾选“Android应用”，并添加绑定“软件包名称”、“SHA-1证书指纹”；在“API限制”下建议勾选“不限制密钥”
- iOS平台 在“应用限制”下勾选“iOS应用”，并添加绑定“软件包ID”；在“API限制”下建议勾选“不限制密钥”
# 配置使用Google地图
打开项目的manifest.json文件，在“App模块配置”项的“Maps(地图)”下，勾选“Google地图”：
# 参数说明
- APIKey_android Google地图开放平台申请的Android平台APIKey
- APIKey_ios Google地图开放平台申请的iOS平台APIKey
注意
- Google地图在Android、iOS平台SDK不支持POI搜索，无法直接使用uni.chooseLocation(OBJECT)，可以申请Web Server APIKey在业务服务器端进行POI搜索，在App端自己实现chooseLocation相关功能
- HBuilderX标准基座没有包含Google地图，请配置后使用自定义调试基座测试
