z***@126.com
z***@126.com
  • 发布:2026-01-06 15:15
  • 更新:2026-01-15 20:59
  • 阅读:507

腾讯地图,map组件和API冲突

分类:uni-app

map组件,写的4.31+ 仅vue3项目vue页面。
API,uni.createMapContext,includePoints方法app-nvue 2.1.5+。
这扯不扯,组件只能vue页面,API只能nvue页面。这怎么玩

2026-01-06 15:15 负责人:DCloud_UNI_OttoJi 分享
已邀请:

最佳回复

DCloud_UNI_OttoJi

DCloud_UNI_OttoJi - 日常回复 uni-app/x 问题,如果艾特我没看到,请主动私信

在 mapCtx 中使用 includePoints 无效问题已定位,下个版本会修复,你可使用下面方案临时兼容,使用最新 HBuilderX4.87 解压 zip 得到 dist 文件夹,替换到下面位置,即可生效

HBuilderX 安装位置 /HBuilderX/plugins/uniapp-cli-vite/node_modules/@dcloudio/uni-app-plus/dist

Ask小助手

Ask小助手

该问题请在专业群( uni-app 官方技术交流群 1 ) 咨询,群中有相关专业的管理员和群友。

腾讯地图map组件与API使用问题解答

您的问题确实反映了腾讯地图在uni-app中的特定限制。根据知识库文档:

  1. 腾讯地图平台限制:在App平台(iOS/Android)上,腾讯地图仅支持4.31+版本的vue3项目中的vue页面("4.31+ 仅vue3项目vue页面"),不支持在nvue页面中使用

  2. API支持情况uni.createMapContextincludePoints方法确实支持"App-nvue 2.1.5+",但这主要适用于高德地图在nvue环境下的操作,而非腾讯地图。

  3. 根本原因:不同地图服务商在App端的实现机制不同:

    • 高德地图在App端同时支持vue和nvue
    • 腾讯地图在App端仅支持vue页面
    • 文档明确指出:"App端如无特殊必要,建议使用高德地图"

解决方案

  • 若必须使用腾讯地图,请确保所有地图操作都在vue页面中进行
  • 更推荐在App端使用高德地图,它对nvue和vue都有良好支持
  • 如需卫星/3D模式,高德地图支持enable-satelliteenable-building属性

参考文档:map组件文档

建议:如果项目需要复杂的地图交互,优先考虑使用高德地图服务商,避免腾讯地图在App端的限制问题。

内容为 AI 生成,仅供参考
DCloud_UNI_OttoJi

DCloud_UNI_OttoJi - 日常回复 uni-app/x 问题,如果艾特我没看到,请主动私信

你是指 https://uniapp.dcloud.net.cn/api/location/map.html#createmapcontext 这个文档里没有标注 vue 的支持性吗,默认支持, nvue 是某个版本有特殊约定,之前和之后有调整,并不说明 vue 不支持, nvue 更多是 UI 层的限制,api 是无关的

  • z***@126.com (作者)

    是的,includePoints在APPvue里无效。并且文档没标注支持vue。

    2026-01-12 15:43

5***@qq.com

5***@qq.com

这么巧的么,我现在正在做这个,小程序中使用uni.createMapContext的includePoints方法无效,只能写在map标签,但是map标签又不能设置padding,真难搞啊。app中用的nvue正常。

  • DCloud_UNI_OttoJi

    vue 中使用 includePoints 无效,你提供个复现工程并说明操作步骤

    2026-01-08 15:28

  • z***@126.com (作者)

    我在小程序使用includePoints,有效。在APP,vue使用includePoints,无效。

    2026-01-12 15:43

  • DCloud_UNI_OttoJi

    回复 z***@126.com: 我测试 vue3 安卓在 map 里使用正常,支持动态展示

    2026-01-15 14:54

  • DCloud_UNI_OttoJi

    回复 z***@126.com: 问题定位了,下个版本会修复,如果你现在想使用,可参考我评论提供的兼容方案

    2026-01-15 20:29

  • DCloud_UNI_OttoJi

    你看一下我评论区的兼容包,测试一下,我测试功能正常了

    2026-01-15 20:58

要回复问题请先登录注册