更新记录

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

  1. Android 平台支持Vapor模式；

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

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

1.0.0（2025-11-21） 下载此版本

  1. 地图基础功能 ✓

    • 地图显示与初始化
    • 设置/获取中心点和缩放级别(5-20)
    • 设置最小/最大缩放级别
    • 缩放和平移动画支持
    1. 地图主题与图层 ✓
    • 普通地图 (theme: "normal")
    • 卫星地图 (theme: "satellite")
    • 交通路况图层 (enableTraffic)
    1. 定位功能 ✓
    • 显示当前定位点 (showLocation)
    • 定位权限自动请求
    • 定位点样式配置
    • 隐私合规处理
    1. 标记点(Marker)功能 ✓
    • 完整CRUD操作：setMarkers、addMarkers、removeMarkers
    • 支持属性：id、经纬度、图标、宽高、旋转、透明度、锚点、标题
    • 本地和网络图片加载(使用Glide库)
    • 气泡(callout)和标签(label)类型定义已完成
查看更多

平台兼容性

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.2.0

uni-map-amap 是基于高德地图原生 SDK 实现的 uni-app x 地图组件。 自 1.1.0 起支持iOS，iOS 功能与 Android之前保持一致。 自 1.2.0 起Android支持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 x x
polygons ✓ x x x
circles ✓ x x x
controls ✓ x x x
include-points ✓ x x x
手势视角
enable-zoom ✓ x x x
enable-scroll ✓ x x x
enable-rotate ✓ x x x
rotate ✓ x x x
skew ✓ x x x
enable-overlooking ✓ x x x
show-compass ✓ x x x
enable-3D ✓ x x x
显示控制
enable-poi ✓ x x x
enable-building ✓ x x x
enable-indoorMap ✓ x x x

事件差异

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

上下文 createMapContext API 差异

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

本插件暂不支持。

注意事项

  • 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协议
评论列表 撰写评论 向官方投诉

暂无用户评论。