更新记录

1.3.0（2026-09-15） 下载此版本

  1. iOS拉齐与内置腾讯map组件的功能, 兼容 VDOM、Vapor 模式；
  2. iOS 平台新增折线、多边形、圆、控件和视野包含点功能，支持 polyline、polygons、circles、controls、include-points 属性。
  3. iOS 平台新增地图交互配置，支持 enable-zoom、enable-scroll、enable-rotate、rotate、skew、enable-overlooking、show-compass、enable-3D 属性。
  4. iOS 平台新增地图显示控制，支持 enable-poi、enable-building、enable-indoorMap 属性。
  5. iOS 平台新增 @markertap、@controltap、@regionchange、@updated、@tap、@anchorpointtap、@poitap 事件。
  6. iOS 平台新增 uni.createAmapContext(mapId, component) 上下文 API，支持 getCenterLocation、moveToLocation、translateMarker、includePoints、getRegion、getScale、addMarkers、removeMarkers、moveAlong、addGroundOverlay、updateGroundOverlay、removeGroundOverlay 方法。

1.2.0（2026-08-19） 下载此版本

  1. Android 平台支持Vapor模式；

1.1.0（2026-08-11） 下载此版本

  1. 支持iOS平台蒸汽、非蒸汽模式；
  2. 对齐 Android 平台 1.0.0 版本功能；
查看更多

平台兼容性

uni-app(4.31)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android Android插件版本 iOS iOS插件版本 鸿蒙
× × × × × × 5.0 1.0.0 13 1.1.0 ×
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
× × × × × × × × × - × ×

uni-app x(4.31)

Chrome Safari Android Android插件版本 iOS iOS插件版本 鸿蒙 微信小程序
× × 5.0 1.0.0 13 1.1.0 × ×

其他

多语言 暗黑模式 宽屏模式 蒸汽模式
× × × √

uni-map-amap

当前版本：1.3.0

uni-map-amap 是基于高德地图原生 SDK 实现的 uni-app x 地图组件。 自 1.1.0 起支持iOS，iOS 功能与 Android之前保持一致。 自 1.2.0 起Android支持Vapor模式。 自 1.3.0 起iOS全面拉齐与内置map组件的功能差异，兼容VDOM、Vapor模式

平台支持

平台 支持版本
Android Android 5.0（API 21）及以上
iOS iOS 13.0 及以上

高德地图 API Key 配置

Android 和 iOS 使用不同类型的 Key，需要分别在高德开放平台创建并配置。

1. 申请 API Key

  1. 访问高德开放平台并登录开发者账号。
  2. 进入控制台，创建新应用或选择已有应用。
  3. Android 端创建 Android Key，并填写应用包名和 SHA1。
  4. iOS 端创建 iOS Key，并填写应用 Bundle Identifier。

2. Android 配置

在 uni_modules/uni-map-amap/utssdk/app-android/AndroidManifest.xml 的 <application> 标签内配置 Android Key：

<meta-data
    android:name="com.amap.api.v2.apikey"
    android:value="your_android_api_key" />

将 your_android_api_key 替换为高德开放平台生成的 Android Key。

插件已在 AndroidManifest.xml 中声明地图和定位所需权限。使用定位功能时，应用还需要在运行时向用户申请定位权限。

3. iOS 配置

在 uni_modules/uni-map-amap/utssdk/app-ios/Info.plist 中配置 iOS Key：

<key>AMapAPIKey</key>
<string>your_ios_api_key</string>

将 your_ios_api_key 替换为高德开放平台生成的 iOS Key，并确保申请 Key 时填写的 Bundle Identifier 与当前应用一致。

使用定位功能时，还需要在同一文件中配置定位用途说明：

<key>NSLocationWhenInUseUsageDescription</key>
<string>我们需要获取您的位置信息以提供定位服务</string>

插件已配置 iOS 原生依赖 AMap3DMap 11.2.000

与内置 map 组件的功能差异

内置 map 组件由腾讯地图提供，在 App 平台 Android / iOS / Harmony 能力对齐。本插件基于高德地图实现，支持 Android 与 iOS，暂不支持 Harmony，差异如下。

属性差异

属性 腾讯地图 本插件高德 Android 本插件高德 iOS 本插件高德 Harmony
基础
longitude ✓ 1.0.0+ 1.1.0+ x
latitude ✓ 1.0.0+ 1.1.0+ x
scale ✓ 1.0.0+ 1.1.0+ x
theme ✓ 1.0.0+ 1.1.0+ x
min-scale ✓ 1.0.0+ 1.1.0+ x
max-scale ✓ 1.0.0+ 1.1.0+ x
layer-style ✓ 1.0.0+ 1.1.0+ x
markers ✓ 1.0.0+ 1.1.0+ x
show-location ✓ 1.0.0+ 1.1.0+ x
enable-satellite ✓ 1.0.0+ 1.1.0+ x
enable-traffic ✓ 1.0.0+ 1.1.0+ x
覆盖物
polyline ✓ x 1.3.0+ x
polygons ✓ x 1.3.0+ x
circles ✓ x 1.3.0+ x
controls ✓ x 1.3.0+ x
include-points ✓ x 1.3.0+ x
手势视角
enable-zoom ✓ x 1.3.0+ x
enable-scroll ✓ x 1.3.0+ x
enable-rotate ✓ x 1.3.0+ x
rotate ✓ x 1.3.0+ x
skew ✓ x 1.3.0+ x
enable-overlooking ✓ x 1.3.0+ x
show-compass ✓ x 1.3.0+ x
enable-3D ✓ x 1.3.0+ x
显示控制
enable-poi ✓ x 1.3.0+ x
enable-building ✓ x 1.3.0+ x
enable-indoorMap ✓ x 1.3.0+ x

事件差异

事件 腾讯地图 本插件高德 Android 本插件高德 iOS 本插件高德 Harmony
@markertap ✓ x 1.3.0+ x
@controltap ✓ x 1.3.0+ x
@regionchange ✓ x 1.3.0+ x
@updated ✓ x 1.3.0+ x
@tap ✓ x 1.3.0+ x
@anchorpointtap ✓ x 1.3.0+ x
@poitap ✓ x 1.3.0+ x

上下文 createMapContext API 差异

腾讯地图内置 map 组件可通过 uni.createMapContext(mapId) 获取上下文对象（MapContext），调用 getCenterLocation、moveToLocation、translateMarker、includePoints、getRegion、getScale、addMarkers、removeMarkers、moveAlong、addGroundOverlay 系列等方法。

本插件通过 uni.createAmapContext(mapId, component) 获取高德地图上下文对象。iOS 自 1.3.0 起兼容 VDOM 与 Vapor 模式，支持以下方法：

方法 本插件高德 iOS 说明
getCenterLocation 1.3.0+ 获取当前地图中心点
moveToLocation 1.3.0+ 移动到指定位置或当前位置
translateMarker 1.3.0+ 移动指定标记点
includePoints 1.3.0+ 将指定坐标包含在可视区域内
getRegion 1.3.0+ 获取当前地图可视区域
getScale 1.3.0+ 获取当前缩放级别
addMarkers 1.3.0+ 添加标记点
removeMarkers 1.3.0+ 删除标记点
moveAlong 1.3.0+ 沿路径移动标记点
addGroundOverlay 1.3.0+ 添加地面覆盖物
updateGroundOverlay 1.3.0+ 更新地面覆盖物
removeGroundOverlay 1.3.0+ 删除地面覆盖物

上下文方法在地图实例尚未初始化、API Key 无效或地图实例已销毁时会通过 fail 和 complete 回调返回错误。

注意事项

  • API Key 配置错误或与应用包名、Bundle Identifier 不匹配时，地图可能无法通过鉴权。
  • 上架应用前，请根据实际业务完善隐私政策和权限用途说明。
  • Android 与 iOS 的 API Key 不能混用。
  • 由于该插件有三方依赖，因此开发调试时需要自定义基座；
  • iOS、Android 均支持 Vapor、VDOM 模式；不同模式下组件根节点结构由框架自动适配，业务侧无需修改地图组件调用方式。

隐私、权限声明

1. 本插件需要申请的系统权限列表：

<!--允许访问网络，必选权限--> <uses-permission android:name="android.permission.INTERNET" /> <!--允许获取粗略位置，若用GPS实现定位小蓝点功能则必选--> <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> <!--允许获取网络状态，用于网络定位，若无gps但仍需实现定位小蓝点功能则此权限必选--> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <!--允许获取wifi网络信息，用于网络定位，若无gps但仍需实现定位小蓝点功能则此权限必选--> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> <!--允许获取wifi状态改变，用于网络定位，若无gps但仍需实现定位小蓝点功能则此权限必选--> <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" /> <!--允许写设备缓存，用于问题排查--> <uses-permission android:name="android.permission.WRITE_SETTINGS" /> iOS： 需要配置NSLocationWhenInUseUsageDescription

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明：

插件不采集任何数据

3. 本插件是否包含广告，如包含需详细说明广告表达方式、展示频率：

无

许可协议

MIT协议
评论列表 撰写评论 向官方投诉

暂无用户评论。