更新记录

1.0.0(2026-06-04)

0.0.1

首次发布。

  • 支持 Android 通过 Intent.ACTION_VIEW 拉起外部地图应用
  • 支持 iOS 通过 UIApplication.open 拉起外部地图应用
  • 支持 HarmonyOS 通过 startAbility 拉起外部地图应用
  • 内置高德地图、百度地图、腾讯地图常用 Scheme 示例
  • 支持返回打开结果,便于提示用户未安装地图应用或 Scheme 不可用
  • 补充 iOS LSApplicationQueriesSchemes 和 HarmonyOS querySchemes 配置说明

平台兼容性

uni-app x(4.0)

Chrome Safari Android iOS 鸿蒙 微信小程序
× - 5.0 12 12 ×

其他

多语言 暗黑模式 宽屏模式

map-link

uni-app x App 端地图跳转 UTS 插件。

能力

  • Android:通过 Intent.ACTION_VIEW 打开外部地图 Scheme
  • iOS:通过 UIApplication.open 打开外部地图 Scheme
  • HarmonyOS:通过 startAbility 打开外部地图 Scheme

支持的常见地图

  • 高德地图:amapuri://
  • 百度地图:baidumap://
  • 腾讯地图:qqmap://

页面调用

import { MapLink } from '@/uni_modules/map-link'

const opened = MapLink.openURL('amapuri://route/plan/?dlat=39.865246&dlon=116.378517&dname=北京南站&dev=0&t=0')

if (!opened) {
  uni.showToast({
    title: '未安装地图或 Scheme 不可用',
    icon: 'none'
  })
}

iOS 配置

插件已内置以下 LSApplicationQueriesSchemes

amapuri
baidumap
qqmap

如需跳转其他地图 App,请在插件 utssdk/app-ios/info.plist 中补充对应 Scheme。

注意事项

  • 插件只负责打开外部 Scheme,不处理坐标转换。
  • 不同地图 App 的 Scheme 参数格式不同,请按目标地图官方文档拼接 URL。
  • Android、iOS 和 HarmonyOS 均建议在真机上验证。

隐私、权限声明

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

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

插件不采集任何用户数据,不读取、存储或上传个人信息,不向任何服务器发送数据。插件仅根据调用方传入的地图 URL Scheme 调起系统已安装的外部地图应用,具体导航、定位或数据处理行为由被调起的地图应用自行完成。

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